Skip to main content

Delete Vault

Permanently deletes the specified Vault. This operation cannot be undone.

Prerequisites

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

Endpoint

DELETE /vaults/{vault_id}

Path parameters

FieldRequiredTypeDescription
vault_idYesstringVault ID, format vlt_xxx

Request example

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

Response example

{
  "id": "vlt_xxx",
  "type": "vault_deleted"
}

Response fields

FieldTypeDescription
idstringID of the deleted Vault
typestringAlways vault_deleted

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