Vault の作成

Description

Creates a Vault and sets its metadata.

パス

POST /api/v1/forward/vaults

リクエストヘッダー

ヘッダー	必須	説明
`Authorization`	はい	`Bearer <PAT または SAT>`
`Idempotency-Key`	いいえ	作成リクエスト用の任意の冪等性キーです。同じキーは同一リクエストにのみ再利用できます。省略した場合、ローカルの冪等リプレイ保護は提供されません。
`Content-Type`	はい	`application/json`

リクエストボディ

フィールド	型	必須	説明
`display_name`	string	はい	Vault 表示名。
`metadata`	object	No	Metadata object. `created_by` is reserved and must not be supplied (supplying it returns 400).

リクエスト例

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

レスポンス例

HTTP 201 Created

{
  "id": "vault_xxx",
  "type": "vault",
  "display_name": "mcp-vault",
  "metadata": {
    "source": "console"
  },
  "created_at": "2026-07-23T10:00:00Z",
  "updated_at": "2026-07-23T10:00:00Z",
  "identity_id": null
}

レスポンスフィールド

フィールド	型	説明
`id`	string	Vault ID。
`type`	string	固定値 `vault`。
`display_name`	string	Vault 表示名。
`metadata`	object	Vault メタデータ。
`created_at`	string	RFC 3339 形式の作成日時。
`updated_at`	string	RFC 3339 形式の最終更新日時。
`identity_id`	string/null	Forward の所有 Identity。

エラー

HTTP	Type	発生条件
400	`invalid_request_error`	リクエストボディ、パスパラメーター、またはクエリパラメーターが不正です。
400	`invalid_request_error`	If the reserved key `created_by` is supplied, `message` is `metadata key "created_by" is reserved`, identifying the invalid field.
401	`authentication_error`	認証トークンがないか、無効です。
403	`permission_error`	呼び出し元にはこのリソースへのアクセス権限がありません。
409	`conflict_error`	リソース状態、参照関係、または冪等性キーが競合しています。
500/502/503	`api_error`	Forward または依存サービスでエラーが発生しました。

​Description

​パス

​リクエストヘッダー

​リクエストボディ

​リクエスト例

​レスポンス例

​レスポンスフィールド

​エラー

Description

パス

リクエストヘッダー

リクエストボディ

リクエスト例

レスポンス例

レスポンスフィールド

エラー