Skip to main content
POST /api/v1/cloud/vaults/{vault_id}/archive Archives the specified vault. Archived vaults are no longer used for active work but remain queryable.

Path parameters

ParameterTypeRequiredDescription
vault_idstringYesVault unique identifier

Headers

HeaderRequiredDescription
AuthorizationYesBearer $QODER_PAT
No request body is required.

Example request

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

Example response

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

Response field changes

The response is a Vault object with the same fields as Get a vault. After a successful archive:
  • archived_at records the archive time
  • updated_at is refreshed to the archive operation time

Errors

HTTPTypeTrigger
401TOKEN_INVALIDMissing or invalid authentication token
404not_found_errorVault does not exist or is not accessible
See Errors for the full error envelope.

Authenticate with vaults

Store and inject secrets safely into agent sessions.