クレデンシャルのアーカイブ

POST /v1/vaults/{vault_id}/credentials/{credential_id}/archive 指定された Vault 内のアクティブなクレデンシャルをアーカイブします。アーカイブされたクレデンシャルはデフォルトではクレデンシャルリストから除外されますが、include_archived=true で含めることができます。

パスパラメータ

パラメータ	型	必須	説明
`vault_id`	string	はい	`vault_` プレフィックス付きの Vault ID
`credential_id`	string	はい	`vcred_` プレフィックス付きのクレデンシャル ID

ヘッダー

ヘッダー	必須	説明
`Authorization`	はい	`Bearer $QODER_PAT`

リクエスト例

curl -X POST "https://api.qoder.com/api/v1/cloud/vaults/vault_019e3bb940277f0db05ab74291acf6ef/credentials/vcred_019e3bb98877759e862750b495c1fce8/archive" \
  -H "Authorization: Bearer $QODER_PAT"

レスポンス例

HTTP 200 OK アーカイブされたクレデンシャルを返却します。レスポンスに access_token は含まれません。

{
  "id": "vcred_019e3bb98877759e862750b495c1fce8",
  "vault_id": "vault_019e3bb940277f0db05ab74291acf6ef",
  "mcp_server_url": "https://example.com/mcp-stream",
  "protocol": "streamable_http",
  "type": "static_bearer",
  "status": "archived",
  "archived_at": "2026-05-18T15:45:35.387093Z",
  "created_at": "2026-05-18T15:34:35.387093Z",
  "updated_at": "2026-05-18T15:45:35.387093Z"
}

レスポンスフィールド

フィールド	型	説明
`id`	string	`vcred_` プレフィックス付きのクレデンシャル一意識別子
`vault_id`	string	所有する Vault の ID
`mcp_server_url`	string	MCP サーバー URL
`protocol`	string	プロトコルタイプ: `streamable_http`
`type`	string	クレデンシャルタイプ: `static_bearer`
`status`	string	アーカイブ後は `"archived"`
`archived_at`	string	アーカイブ時刻（ISO 8601）
`created_at`	string	作成時刻（ISO 8601）
`updated_at`	string	最終更新時刻（ISO 8601）

エラー

HTTP	タイプ	トリガー条件
401	`TOKEN_INVALID`	認証トークンが欠落または無効
404	`not_found_error`	Vault またはクレデンシャルが存在しない
409	`conflict_error`	クレデンシャルは既にアーカイブ済み

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

Vaults

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

​パスパラメータ

​ヘッダー

​リクエスト例

​レスポンス例

​レスポンスフィールド

​エラー

​関連項目