Retrieve a vault - Qoder CN Series - Alibaba Cloud Documentation Center

Request headers

Header	Required	Description
`Authorization`	Yes	Bearer token used to authenticate the request. Format: `Bearer $QODER_PAT`.

Path parameters

Parameter	Type	Required	Description
`vault_id`	string	Yes	The unique identifier of the vault to retrieve.

Example request

curl -X GET "https://api.qoder.com.cn/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": {},
  "credentials": [
    {
      "id": "vcred_019e3bb940297658a632dbf920057eff",
      "vault_id": "vault_019e3bb940277f0db05ab74291acf6ef",
      "mcp_server_url": "https://example.com/mcp",
      "protocol": "sse",
      "type": "static_bearer",
      "status": "active",
      "created_at": "2026-05-18T15:34:16.876188Z",
      "updated_at": "2026-05-18T15:34:16.876188Z"
    }
  ],
  "created_at": "2026-05-18T15:34:16.874877Z",
  "updated_at": "2026-05-18T15:34:16.874877Z"
}

Response fields

Field	Type	Description
`id`	string	Unique identifier of the vault, prefixed with `vault_`.
`type`	string	Object type. Always `vault`.
`display_name`	string	Human-readable display name for the vault.
`status`	string	Current vault state. One of `active` or `archived`.
`metadata`	object	Custom key-value pairs associated with the vault.
`credentials`	array	The credentials currently attached to the vault. The `access_token` value is never returned.
`created_at`	string	Creation timestamp in ISO 8601 format.
`updated_at`	string	Last-updated timestamp in ISO 8601 format.

Errors

HTTP	Type	Trigger
401	`authentication_error`	The authentication token is missing or invalid.
404	`not_found_error`	The specified vault does not exist or has been deleted.

For the full error envelope, see Errors.