Get Vault API: GET /vaults/{vault_id}-Alibaba Cloud Model Studio(Model Studio)-阿里云帮助中心

Retrieves the details of a single Vault by ID.

Prerequisites

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

Endpoint

GET /vaults/{vault_id}

Path parameters

Field	Required	Type	Description
`vault_id`	Yes	string	Vault ID, format `vlt_xxx`

Request example

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

Response example

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

Response fields

Field	Type	Description
`id`	string	Vault ID, format `vlt_xxx`
`type`	string	Always `vault`
`display_name`	string	Human-readable name of the Vault
`metadata`	object	Custom key-value pairs
`archived_at`	string \| null	Archive timestamp; `null` if not archived
`created_at`	string	Creation time, ISO 8601
`updated_at`	string	Last update time, ISO 8601

Error codes

HTTP status	Error code	Description
400	`InvalidParameter`	Required parameter missing or invalid
401	`InvalidApiKey`	Invalid API key provided