Skip to main content
GET /v1/vaults/{vault_id} Retrieves the details of a single vault by ID.

​
Path parameters

ParameterTypeRequiredDescription
vault_idstringYesVault unique identifier

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer $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",
  "status": "active",
  "metadata": {},
  "created_at": "2026-05-18T15:34:16.874877Z",
  "updated_at": "2026-05-18T15:34:16.874877Z"
}

​
Response fields

FieldTypeDescription
idstringVault unique identifier with the vault_ prefix
typestringAlways "vault"
display_namestringDisplay name
statusstringStatus: active or archived
metadataobjectCustom metadata
archived_atstringArchive time; present only when archived
created_atstringCreation time (ISO 8601)
updated_atstringLast update time (ISO 8601)

​
Errors

HTTPTypeTrigger
401TOKEN_INVALIDMissing or invalid authentication token
404not_found_errorVault does not exist or is not accessible: “Vault ‘{vault_id}’ was not found.”
See Errors for the full error envelope.

Authenticate with vaults

Store and inject secrets safely into agent sessions.