Vault data structures

Vault object

Returned by create, get, list, and archive endpoints.

Field	Type	Description
`id`	string	Vault ID with the `vault_` prefix
`type`	string	Always `"vault"`
`display_name`	string	Vault display name, at most 255 characters
`status`	string	Valid values: `active`, `archived`
`metadata`	object	Metadata object
`credentials`	array of Vault credential	Present on create responses when credentials were created in the same request
`archived_at`	string	Present only when archived
`created_at`	string	Creation time
`updated_at`	string	Last update time

Returned by create credential, list credentials, archive credential, and nested create-vault responses.

Field	Type	Description
`id`	string	Credential ID with the `vcred_` prefix
`vault_id`	string	Owning Vault ID
`mcp_server_url`	string	MCP server URL, at most 2048 characters
`protocol`	string	Supported value: `streamable_http`
`type`	string	Supported value: `static_bearer`
`status`	string	Valid values: `active`, `archived`
`archived_at`	string	Present only when archived
`created_at`	string	Creation time
`updated_at`	string	Last update time

Credential secrets, including access_token, are accepted on create requests but are never returned.

Field	Type	Required	Description
`mcp_server_url`	string	Yes	MCP server URL, at most 2048 characters
`protocol`	string	Yes	Use `streamable_http`
`type`	string	Yes	Use `static_bearer`
`access_token`	string	Yes	Bearer token stored securely in the Vault

Store and inject secrets safely into agent sessions.