Skip to main content
PATCH
Update a saved view

Authorizations

Authorization
string
header
required

API key for authentication. Format: gcai_xxxxxxxxx

Create API keys in the GC AI app under Settings → API.

Path Parameters

id
string<uuid>
required

The vault ID

viewId
string<uuid>
required

View ID from GET /vaults/{id}/views.

Body

application/json
name
string

New view name.

Required string length: 1 - 120
view_state
object

Replacement layout, sort, and filters. This is a full replacement of all four fields, so send the whole object.

Response

The updated view

id
string<uuid>
required

Unique view identifier

vault_id
string<uuid>
required

Vault this view belongs to

name
string
required

View name, as shown on its tab in the app

Example:

"Renewals this quarter"

position
integer
required

Zero-based slot this view occupies in the vault view order. Read-only over the API: reordering views is not available here yet.

created_by_user_id
integer | null
required

GC AI user ID of whoever created the view, or null when that person has since been removed. Provenance only: a view is shared with the whole vault and is not owned by its creator.

view_state
object
required
created_at
string
required

ISO 8601 creation timestamp

updated_at
string
required

ISO 8601 last-update timestamp

Last modified on September 25, 2026