Credential 数据结构

Vault credential 对象

创建、查询、列表、归档接口都会返回该结构。凭证密文（如 token、access_token、refresh_token、client_secret、secret_value）只在创建请求中接收，永远不会在响应中返回。

字段	类型	说明
`id`	string	Credential ID，前缀为 `vcred_`
`type`	string	固定值 `"vault_credential"`
`vault_id`	string	所属 Vault ID
`auth`	Credential auth object	脱敏后的鉴权信息；不会返回密文
`display_name`	string \| null	兼容字段；当前固定为 `null`，不持久化
`metadata`	object	与 credential 一起存储的自定义元数据对象；省略时为 `{}`
`archived_at`	string \| null	归档时间，RFC 3339 格式；active 时为 `null`
`created_at`	string	创建时间，RFC 3339 格式
`updated_at`	string	最后更新时间，RFC 3339 格式

字段	类型	必填	说明
`auth`	Credential auth object	是	凭证鉴权信息
`display_name`	string	否	兼容字段；当前响应固定为 `null`，不持久化
`metadata`	object	否	与 credential 一起存储的自定义元数据对象；省略时为 `{}`

auth 通过 type 区分鉴权类型。响应中不会回填任何密文字段。

字段	类型	必填	说明
`type`	string	是	固定值 `"static_bearer"`
`mcp_server_url`	string	是	MCP server URL，最长 2048 字符
`token`	string	是（请求）	静态 Bearer token；仅创建请求接收，响应中不返回

字段	类型	必填	说明
`type`	string	是	固定值 `"mcp_oauth"`
`mcp_server_url`	string	是	MCP server URL，最长 2048 字符
`client_id`	string	是	OAuth 客户端 ID
`client_secret`	string	是（请求）	OAuth 客户端 secret；仅创建请求接收，响应中不返回
`access_token`	string	否（请求）	已完成 OAuth 换取的 access token；仅创建请求接收，响应中不返回
`refresh_token`	string	否（请求）	OAuth refresh token；仅创建请求接收，响应中不返回

字段	类型	必填	说明
`type`	string	是	固定值 `"secret_value"`
`secret_value`	string	是（请求）	通用密文；仅创建请求接收，响应中不返回

具体鉴权类型的可用集合以 Forward Credential API 的创建接口为准；未列出的类型将在创建时返回 400 invalid_request_error。

字段	类型	说明
`data`	Vault credential 对象数组	当前页记录
`has_more`	boolean	是否还有下一页
`next_page`	string \| null	下一页向后游标（推荐使用）；`has_more=true` 时等于当前页 `last_id`，否则为 `null`
`first_id`	string \| null	当前页第一条记录 ID
`last_id`	string \| null	当前页最后一条记录 ID

请求侧的三种游标参数 page / after_id / before_id 互斥，同时提供多个返回 400；推荐使用 page，语义等价于 after_id。