Rename a vault or replace its metadata
Renames a vault or replaces its metadata and returns the stored vault; omitted fields keep their current values. This never changes which credentials the vault contains. Do not automatically retry an ambiguous transport failure: re-read the vault first, because this operation does not replay a prior response.
Authorizations
A Recursion API key, created in the console under API keys.
Headers
Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.
1Organization in which to act. Required for a tenant-scoped API key. Optional for an organization-scoped key, where it must name that same organization. The value may be an organization id or default.
1Path Parameters
Vault id (UUID) as returned by managedAgentsCreateVault or managedAgentsListVaults.
Body
Request body for updating a vault's label or metadata. Every field is optional; omitted fields keep their current value.
Response
A named group of credentials an agent session may be granted. A session references vaults by id; the credential values inside are resolved at execution time and are never returned over the API.
A named group of credentials an agent session may be granted. A session references vaults by id; the credential values inside are resolved at execution time and are never returned over the API.
RFC 3339 timestamp of when this record was created. Server-assigned.
How many credentials this vault currently holds, so a list view need not fetch each vault's credentials.
-9007199254740991 <= x <= 9007199254740991Operator-facing label for the vault, shown wherever vaults are listed.
Organization that owns this record. Resolved from the API key; never accepted from the caller.
RFC 3339 timestamp of the last change to this record. Server-assigned.
Identifier for this vault (UUID). Server-assigned.
Free-form caller-supplied key/value labels. Stored verbatim and never interpreted by the service.