Get a vault

Retrieve a single vault by ID.

GET /api/v1/cloud/vaults/{vault_id}

Retrieves the details of a single vault by ID.

Path parameters

Parameter	Type	Required	Description
vault_id	string	Yes	Vault unique identifier

Headers

Header	Required	Description
Authorization	Yes	Bearer $QODER_PAT

Example request

curl -X GET https://api.qoder.com/api/v1/cloud/vaults/vault_019e3bb940277f0db05ab74291acf6ef \
  -H "Authorization: Bearer $QODER_PAT"

Example response

HTTP 200 OK

{
  "id": "vault_019e3bb940277f0db05ab74291acf6ef",
  "type": "vault",
  "display_name": "my-mcp-vault",
  "metadata": {},
  "archived_at": null,
  "created_at": "2026-05-18T15:34:16.874877Z",
  "updated_at": "2026-05-18T15:34:16.874877Z"
}

Response fields

Field	Type	Description
id	string	Vault unique identifier with the vault_ prefix
type	string	Always "vault"
display_name	string	Display name
metadata	object	Custom metadata
archived_at	string | null	Archive time, or null when active
created_at	string	Creation time (ISO 8601)
updated_at	string	Last update time (ISO 8601)

Errors

HTTP	Type	Trigger
401	TOKEN_INVALID	Missing or invalid authentication token
404	not_found_error	Vault does not exist or is not accessible: “Vault ‘{vault_id}’ was not found.”

See Errors for the full error envelope.

Related

Authenticate with vaults

Store and inject secrets safely into agent sessions.