Vault データ構造

Vault オブジェクト

create、get、list、archive エンドポイントで返却されます。

フィールド	型	説明
`id`	string	`vault_` プレフィックス付きの Vault ID
`type`	string	固定値 `"vault"`
`display_name`	string	Vault の表示名、最大 255 文字
`metadata`	object	メタデータオブジェクト
`credentials`	Vault クレデンシャルの配列	Vault 作成のレスポンスでのみ返却され、常に空配列。認証情報は独立した credential エンドポイントで管理します
`archived_at`	string \| null	アーカイブ時刻。アクティブな場合は `null`
`created_at`	string	作成時刻
`updated_at`	string	最終更新時刻

create credential、list credentials、archive credential の各エンドポイントで返却されます。

フィールド	型	説明
`id`	string	`vcred_` プレフィックス付きのクレデンシャル ID
`type`	string	固定値 `"vault_credential"`
`vault_id`	string	所有する Vault の ID
`auth`	Credential auth オブジェクト	サニタイズされた認証詳細。シークレットは決して返されない
`display_name`	null	現在は常に `null`
`metadata`	object	認証情報に保存されるカスタムメタデータオブジェクト。デフォルトは `{}`
`archived_at`	string \| null	アーカイブ時刻。アクティブな場合は `null`
`created_at`	string	作成時刻
`updated_at`	string	最終更新時刻

token、access_token、refresh_token、client_secret、secret_value を含むクレデンシャルのシークレットは、作成リクエストで受け付けられますが、レスポンスには決して含まれません。

フィールド	型	必須	説明
`auth`	object	はい	クレデンシャルの認証詳細
`display_name`	string	いいえ	互換性のために受け付けられる。現在は `null` として返され、保持されない
`metadata`	object	いいえ	認証情報に保存されるカスタムメタデータ。デフォルトは `{}`

フィールド	型	必須	説明
`type`	string	はい	`static_bearer`
`mcp_server_url`	string	はい	MCP サーバー URL、最大 2048 文字
`token`	string	はい	Vault に安全に保存される Bearer トークン。決して返されない

レスポンスの auth では token は省略されます。

フィールド	型	必須	説明
`type`	string	はい	`mcp_oauth`
`mcp_server_url`	string	はい	MCP サーバー URL、最大 2048 文字
`access_token`	string	はい	OAuth アクセストークン。決して返されない
`expires_at`	string	いいえ	RFC 3339 形式のアクセストークン有効期限
`refresh`	object	いいえ	リフレッシュ設定。`refresh_token` および `client_secret` を含まずに返される

フィールド	型	必須	説明
`type`	string	はい	`environment_variable`
`secret_name`	string	はい	環境変数名。`[A-Za-z_][A-Za-z0-9_]*` に一致する必要がある
`secret_value`	string	はい	シークレットの値。決して返されない
`networking`	object	いいえ	互換性のために受け付けられる。現在は何も行わず、空オブジェクトとして返される

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