Credential の作成

Description

Creates a Credential in the specified Vault. Sensitive authentication fields are never echoed in the response.

パス

POST /api/v1/forward/vaults/{id}/credentials

リクエストヘッダー

ヘッダー	必須	説明
`Authorization`	はい	`Bearer <PAT または SAT>`
`Idempotency-Key`	いいえ	作成リクエスト用の任意の冪等性キーです。同じキーは同一リクエストにのみ使用できます。
`Content-Type`	はい	`application/json`

パス参数

パラメーター	型	必須	説明
`id`	string	はい	Vault ID。

クエリパラメーター

Parameter	Type	Required	Description
`identity_id`	string	No	Identity に属するリソースを操作する場合のみ使用する任意のパラメーターです。PAT では明示的に指定でき、省略時は管理者スコープになります。SAT では Identity スコープのトークンを発行し、このパラメーターを明示的に指定しないでください。指定すると HTTP 400 が返されます。Identity の帰属.

リクエストボディ

フィールド	型	必須	説明
`auth`	object	Yes	Credential authentication information. Supports `static_bearer`, `mcp_oauth`, and `environment_variable`; responses include only redacted, non-secret fields.
`metadata`	object	No	Metadata object. `created_by` is reserved and must not be supplied (supplying it returns 400).

`auth` フィールド

static_bearer:

フィールド	型	必須	説明
`type`	string	はい	Must be `static_bearer`.
`mcp_server_url`	string	はい	MCP Server URL.
`token`	string	はい	Bearer token. Write-only and never returned in responses.

mcp_oauth:

フィールド	型	必須	説明
`type`	string	はい	Must be `mcp_oauth`.
`mcp_server_url`	string	はい	MCP Server URL.
`access_token`	string	はい	OAuth access token. Write-only and never returned in responses.
`expires_at`	string	いいえ	Access token expiration time in RFC 3339 format.
`refresh`	object	いいえ	OAuth refresh configuration. Secret fields are never returned in responses.

environment_variable:

フィールド	型	必須	説明
`type`	string	はい	Must be `environment_variable`.
`secret_name`	string	はい	Environment variable name. Must match `[A-Za-z_][A-Za-z0-9_]*`.
`secret_value`	string	はい	Environment variable value. Write-only and never returned in responses.

auth.protocol は Forward Credential のリクエストフィールドではなく、指定しても効果はありません。

リクエスト例

{
  "auth": {
    "type": "static_bearer",
    "mcp_server_url": "https://mcp.example.com",
    "token": "secret_token"
  },
  "metadata": {
    "source": "console"
  }
}

レスポンス例

HTTP 201 Created

{
  "id": "vcred_xxx",
  "type": "vault_credential",
  "vault_id": "vault_xxx",
  "auth": {
    "type": "static_bearer",
    "mcp_server_url": "https://mcp.example.com"
  },
  "display_name": "",
  "metadata": {
    "source": "console"
  },
  "created_at": "2026-07-23T10:00:00Z",
  "updated_at": "2026-07-23T10:00:00Z"
}

レスポンスフィールド

フィールド	型	説明
`id`	string	Credential ID。
`type`	string	固定値 `vault_credential`。
`vault_id`	string	Parent Vault ID。
`auth`	object	マスクされた認証情報。
`display_name`	string	現在は常に空文字列。
`metadata`	object	Credential メタデータ。
`created_at`	string	RFC 3339 形式の作成日時。
`updated_at`	string	RFC 3339 形式の最終更新日時。

エラー

HTTP	Type	発生条件
400	`invalid_request_error`	The request body, path parameters, or query parameters are invalid. SAT が `identity_id` を明示的に指定した場合も返されます。
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`	Vault `identity_id` を指定しない PAT または Admin SAT で Owner mismatch が発生したか、その他の権限が不足しています。
404	`not_found_error`	The Vault does not exist or is not visible. `identity_id` is invalid, disabled, or does not belong to the caller, or the target resource does not belong to the current Identity scope.
409	`conflict_error`	リソース状態、参照関係、または冪等性キーが競合しています。
500/502/503	`api_error`	Forward または依存サービスでエラーが発生しました。

​Description

​パス

​リクエストヘッダー

​パス参数

​クエリパラメーター

​リクエストボディ

​auth フィールド

​リクエスト例

​レスポンス例

​レスポンスフィールド

​エラー