Vault の作成

POST /api/v1/cloud/vaults 新しい Vault を作成します。Vault は MCP サーバーの認証情報を安全に保管するために使用します。Vault の作成後、認証情報の作成で認証情報を追加してください。

ヘッダー

ヘッダー	必須	説明
`Authorization`	はい	`Bearer $QODER_ACCESS_TOKEN`
`Content-Type`	はい	`application/json`

リクエストボディ

フィールド	型	必須	説明
`display_name`	string	はい	Vault 表示名、最大 255 文字
`metadata`	object	いいえ	カスタムメタデータ

リクエスト例

curl -X POST https://api.qoder.com/api/v1/cloud/vaults \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name": "my-mcp-vault",
    "metadata": {"team": "docs"}
  }'

レスポンス例

HTTP 200 OK

{
  "id": "vault_019e3bb940277f0db05ab74291acf6ef",
  "type": "vault",
  "display_name": "my-mcp-vault",
  "metadata": {
    "team": "docs"
  },
  "credentials": [],
  "archived_at": null,
  "created_at": "2026-05-18T15:34:16.874877Z",
  "updated_at": "2026-05-18T15:34:16.874877Z"
}

レスポンスフィールド

フィールド	型	説明
`id`	string	`vault_` プレフィックス付きの Vault 一意識別子
`type`	string	固定値 `"vault"`
`display_name`	string	Vault 表示名
`metadata`	object	カスタムメタデータ
`credentials`	array	Vault 作成時は常に空配列。認証情報は create credential エンドポイントで後から追加します
`archived_at`	string \| null	アーカイブ時刻。アクティブな場合は `null`
`created_at`	string	作成時刻（ISO 8601）
`updated_at`	string	最終更新時刻（ISO 8601）

エラー

HTTP	type	トリガー条件
400	`invalid_request_error`	`display_name` 欠落または無効、または `metadata` が無効
400	`invalid_request_error`	リクエストボディにサポートされていない `credentials` フィールドが含まれる。エラーメッセージは `Field 'credentials' is not supported on vault create.`
401	`TOKEN_INVALID`	認証トークンが欠落または無効

エラーエンベロープの詳細についてはエラーリファレンスを参照してください。

Vaults

シークレットを安全に保存し、Agent Session に注入する。

​ヘッダー

​リクエストボディ

​リクエスト例

​レスポンス例

​レスポンスフィールド

​エラー

​関連項目

Vaults

ヘッダー

リクエストボディ

リクエスト例

レスポンス例

レスポンスフィールド

エラー

関連項目