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

パスパラメータ

パラメータ必須説明
vault_idstringはいvault_ プレフィックス付きの Vault ID
credential_idstringはい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",
  "type": "vault_credential",
  "vault_id": "vault_019e3bb940277f0db05ab74291acf6ef",
  "auth": {
    "type": "static_bearer",
    "mcp_server_url": "https://example.com/mcp-stream"
  },
  "display_name": null,
  "metadata": {
    "team": "docs"
  },
  "archived_at": "2026-05-18T15:45:35.387093Z",
  "created_at": "2026-05-18T15:34:35.387093Z",
  "updated_at": "2026-05-18T15:45:35.387093Z"
}

レスポンスフィールド

フィールド説明
idstringvcred_ プレフィックス付きのクレデンシャル一意識別子
typestring固定値 "vault_credential"
vault_idstring所有する Vault の ID
authobjectサニタイズされた認証詳細。シークレットは決して返されない
display_namenull現在は常に null
metadataobject認証情報に保存されるカスタムメタデータオブジェクト。デフォルトは {}
archived_atstringアーカイブ時刻(ISO 8601)
created_atstring作成時刻(ISO 8601)
updated_atstring最終更新時刻(ISO 8601)

エラー

HTTPタイプトリガー条件
401TOKEN_INVALID認証トークンが欠落または無効
404not_found_errorVault またはクレデンシャルが存在しない
409conflict_errorクレデンシャルは既にアーカイブ済み
エラーエンベロープの詳細についてはエラーリファレンスを参照してください。

関連項目

Vaults

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