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

​
ヘッダー

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

​
リクエストボディ

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

​
リクエスト例

curl -X POST https://api.qoder.com/api/v1/cloud/vaults \
  -H "Authorization: Bearer $QODER_PAT" \
  -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"
}

​
レスポンスフィールド

フィールド型説明
idstringvault_ プレフィックス付きの Vault 一意識別子
typestring固定値 "vault"
display_namestringVault 表示名
metadataobjectカスタムメタデータ
credentialsarray通常の作成リクエストでは空配列
archived_atstring | nullアーカイブ時刻。アクティブな場合は null
created_atstring作成時刻（ISO 8601）
updated_atstring最終更新時刻（ISO 8601）

​
エラー

HTTPtypeトリガー条件
400invalid_request_errordisplay_name 欠落、display_name 無効、metadata 無効、またはインライン認証情報が多すぎる
401TOKEN_INVALID認証トークンが欠落または無効
エラーエンベロープの詳細についてはエラーリファレンスを参照してください。

​
関連項目

Vaults

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