GCgc-ai
Contract Intelligence

Get a vault

Retrieve a single Contract Intelligence vault by ID, with the caller's role and its scanned-document count.

Requires a user-scoped API key (u:gcai_...). A vault is shared with named people, so an organization-scoped key has no identity to resolve vault access with.

get/vaults/{id}

Request

Path parameters

idstring uuid required

The vault ID

Response

Vault details

idstring uuid required

Unique vault identifier

namestring required

Vault name

descriptionstring nullable required

Vault description, or null if unset

my_role'owner' | 'editor' | 'viewer' required

Caller's role in this vault: owner (manage members and settings), editor (add documents and edit extracted data), or viewer (read and annotate). A vault the caller reaches only through organization-wide visibility reports viewer. The role is not the whole story for writes: adding documents also needs the organization-level permission to manage vaults, so a caller can hold editor here and still receive 403 from POST /vaults/{id}/documents.

is_access_controlledboolean required

When true, only vault members can see the vault. When false, any member of the organization with organization-wide vault read can see it.

document_countnumber required

Documents that have finished scanning in this vault. Documents still being read are not counted yet.

setup_completed_atstring nullable required

ISO 8601 timestamp when guided setup finished, or null while the vault is still in setup. Documents added to a vault in setup are stored but not scanned until setup finishes. Vaults created through POST /vaults finish setup immediately, so this is always set for them.

archived_atstring nullable required

ISO 8601 timestamp when the vault was archived, or null while it is live. Archived vaults are hidden from the default list and reject changes until POST /vaults/{id}/restore runs.

created_atstring required

ISO 8601 creation timestamp

updated_atstring required

ISO 8601 last-update timestamp

Example response

{
  "name": "Vendor SaaS agreements"
}

Changes

No recorded changes to this operation across all 1 revision of this API.