OpenAI 更新凭证库

2026-11-18 18:02 更新

post /vaults/{vault_id}

更新活动凭证库的名称或元数据。省略的字段保留原值。参见凭证库指南。

路径参数

  • vault_id: string

凭证库 ID。

minLength: 0, maxLength: 1048576

请求体参数

内容类型为 application/json。

  • metadata: optional map[string]

替换全部元数据。省略时保留原值,传入 {} 时清除。最多 16 个字符串键值对,键最长 64 个字符,值最长 512 个字符。

  • name: optional string or null

新的名称。省略时保留原名称,传入 null 时清除。保存前去除首尾空白,处理后长度必须为 1 至 256 个 UTF-8 字节。

minLength: 1, maxLength: 1048576

返回值

  • Vault object { id, created_at, metadata, 2 more }

供 MCP 服务器和 OpenAI 托管环境使用的凭证集合。

  • id: string

凭证库 ID。

minLength: 0

  • created_at: integer

凭证库创建时的 Unix 时间戳,单位为秒。

format: int64

  • metadata: map[string]

与凭证库关联的键值对,例如应用或团队标识。

  • name: string or null

凭证库的可读名称(如已设置)。

minLength: 0

  • object: "vault" (default: "vault")

对象类型,固定为 vault。

  • "vault"

示例

## 从环境变量读取 API 密钥。
## 将 VAULT_ID 设置为目标凭证库的 ID。
curl https://api.openai.com/v1/vaults/$VAULT_ID \
    -H 'Content-Type: application/json' \
    -H 'OpenAI-Beta: agents=v1' \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -d '{}'

200 响应示例

字段名、类型值和示例标识均按接口定义保留。

{
  "id": "id",
  "created_at": 0,
  "metadata": {
    "foo": "string"
  },
  "name": "name",
  "object": "vault"
}
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号