Skip to main content

Archive Vault

Soft-archives the specified Vault. Once archived, the Vault no longer appears in list results by default. Sessions already bound to its Credentials are unaffected.

Prerequisites

Endpoint and authentication configured. For details, see Overview and authentication.

Endpoint

POST /vaults/{vault_id}/archive

Path parameters

FieldRequiredTypeDescription
vault_idYesstringVault ID, format vlt_xxx

Request example

curl -X POST "$AGENTSTUDIO_URL/vaults/vlt_xxx/archive" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

Response example

{
  "id": "vlt_xxx",
  "type": "vault",
  "display_name": "production-keys",
  "metadata": {
    "environment": "production"
  },
  "archived_at": "2026-07-10T08:00:00Z",
  "created_at": "2026-06-20T10:00:00Z",
  "updated_at": "2026-07-10T08:00:00Z"
}

Response fields

FieldTypeDescription
idstringVault ID, format vlt_xxx
typestringAlways vault
display_namestringHuman-readable name of the Vault
metadataobjectCustom key-value pairs
archived_atstringArchive timestamp, ISO 8601
created_atstringCreation time, ISO 8601
updated_atstringLast update time, ISO 8601

Error codes

HTTP statusError codeDescription
400InvalidParameterRequired parameter missing or invalid
401InvalidApiKeyInvalid API key provided
Managed Agent API
Flow Agent API
Sandbox API
RAG API
Long-term Memory
ParseX API
Security API
Framework Integration