認証情報の更新

POST /api/v1/cloud/vaults/{vault_id}/credentials/{credential_id} アクティブな Vault Credential をその場で更新します。リクエストはマージ形式のパッチであり、省略したフィールドは現在の値を維持します。Credential を作成し直さずにシークレットをローテーションする場合に使用します。

パスパラメータ

パラメータ	型	説明
`vault_id`	string	`vault_` プレフィックス付きの Vault ID
`credential_id`	string	`vcred_` プレフィックス付きの Credential ID

ヘッダー

ヘッダー	必須	説明
`Authorization`	はい	`Bearer <PAT or SAT>`
`Content-Type`	はい	`application/json`

リクエストボディ

フィールド	型	必須	説明
`auth`	object	いいえ	Credential の認証情報パッチ。`auth.type` は必須で、Credential の既存タイプと一致する必要がある
`metadata`	object	いいえ	メタデータのマージパッチ。キーを `null` に設定するとそのキーを削除し、`"metadata": null` を送信するとメタデータを `{}` にリセットする

タイプ別に更新可能な `auth` フィールド

Credential タイプ	更新可能なフィールド
`static_bearer`	`token`
`mcp_oauth`	`access_token`、`expires_at`（`null` で削除）、`refresh.refresh_token`、`refresh.scope`（`null` で削除）、`refresh.token_endpoint_auth`
`environment_variable`	`secret_value`

識別情報となる auth.type、mcp_server_url、secret_name、refresh.client_id、refresh.token_endpoint は変更できません。auth.refresh は既存の refresh 設定だけを更新でき、refresh 設定なしで作成した Credential に新しく追加することはできません。

リクエスト例

mcp_oauth Credential の access token をローテーションします。

curl -X POST "https://api.qoder.com/api/v1/cloud/vaults/vault_019e3bb940277f0db05ab74291acf6ef/credentials/vcred_019e3bb98877759e862750b495c1fce8" \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "auth": {
      "type": "mcp_oauth",
      "access_token": "new-oauth-access-token",
      "expires_at": "2026-08-20T08:00:00Z"
    },
    "metadata": {"rotated_by": "ops", "stale_flag": null}
  }'

レスポンス例

HTTP 200 OK

{
  "id": "vcred_019e3bb98877759e862750b495c1fce8",
  "type": "vault_credential",
  "vault_id": "vault_019e3bb940277f0db05ab74291acf6ef",
  "auth": {
    "type": "mcp_oauth",
    "mcp_server_url": "https://mcp.example.com/mcp",
    "expires_at": "2026-08-20T08:00:00Z"
  },
  "display_name": null,
  "metadata": {"rotated_by": "ops"},
  "archived_at": null,
  "created_at": "2026-05-18T15:34:35.387093Z",
  "updated_at": "2026-08-19T02:58:10.114532Z"
}

レスポンスはサニタイズされた Credential ビューです。token、access_token、refresh_token、client_secret、secret_value などのシークレット値は返されません。

エラー

HTTP	タイプ	トリガー条件
400	`invalid_request_error`	`auth.type` がない、Credential のタイプと異なる、フィールド値が無効、または refresh 設定のない Credential の `refresh` を更新しようとした
404	`not_found_error`	Vault または Credential が存在しない、もしくはアクセスできない
409	`conflict_error`	Credential がアーカイブ済み

注意事項

パッチで渡したシークレットは保存済みの値を直ちに置き換えます。バージョン管理はありません。
mcp_oauth access token のローテーション後は、MCP OAuth 認証情報の検証を実行して、新しい token が利用できることを確認してください。

​パスパラメータ

​ヘッダー

​リクエストボディ

​タイプ別に更新可能な auth フィールド

​リクエスト例

​レスポンス例

​エラー

​注意事項