> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 認証情報一覧

> 指定の Vault 配下のすべての認証情報一覧を取得します。

`GET /api/v1/cloud/vaults/{vault_id}/credentials`

指定された Vault 配下の認証情報一覧を取得します。アーカイブ済み認証情報はデフォルトで除外されます。

## パスパラメータ

| パラメータ      | 型      | 必須 | 説明           |
| ---------- | ------ | -- | ------------ |
| `vault_id` | string | はい | Vault の一意識別子 |

## ヘッダー

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

## クエリパラメータ

| パラメータ              | 型       | 必須  | 説明                                                                               |
| ------------------ | ------- | --- | -------------------------------------------------------------------------------- |
| `limit`            | integer | いいえ | 1 ページあたりの返却件数上限。デフォルト 20、範囲は 1〜100。100 を超える値は `400 invalid_request_error` を返します。 |
| `page`             | string  | いいえ | Claude スタイルの前方カーソル。`after_id` と等価。`before_id` および `after_id` と相互排他               |
| `after_id`         | string  | いいえ | カーソルページネーション：この ID 以降のレコードを返す。`page` および `before_id` と相互排他                       |
| `before_id`        | string  | いいえ | カーソルページネーション：この ID 以前のレコードを返す。`page` および `after_id` と相互排他                        |
| `include_archived` | boolean | いいえ | `true` に設定するとアーカイブ済み認証情報も含む                                                      |
| `name`             | string  | いいえ | MCP サーバー URL で認証情報を検索                                                            |

## リクエスト例

```bash theme={null}
curl -X GET https://api.qoder.com/api/v1/cloud/vaults/vault_019e3bb940277f0db05ab74291acf6ef/credentials \
  -H "Authorization: Bearer $QODER_PAT"
```

## レスポンス例

**HTTP 200 OK**

```json theme={null}
{
  "data": [
    {
      "id": "vcred_019e3bb940297658a632dbf920057eff",
      "type": "vault_credential",
      "vault_id": "vault_019e3bb940277f0db05ab74291acf6ef",
      "auth": {
        "type": "static_bearer",
        "mcp_server_url": "https://example.com/mcp"
      },
      "display_name": null,
      "metadata": {
        "team": "docs"
      },
      "archived_at": null,
      "created_at": "2026-05-18T15:34:16.876188Z",
      "updated_at": "2026-05-18T15:34:16.876188Z"
    }
  ],
  "next_page": null,
  "first_id": "vcred_019e3bb940297658a632dbf920057eff",
  "last_id": "vcred_019e3bb940297658a632dbf920057eff",
  "has_more": false
}
```

## レスポンスフィールド

| フィールド       | 型              | 説明                                                                          |
| ----------- | -------------- | --------------------------------------------------------------------------- |
| `data`      | array          | [Vault 認証情報オブジェクト](/ja/cloud-agents/api/vaults/schemas#vault-credential)の配列 |
| `next_page` | string \| null | 次ページの前方カーソル。`has_more` が `true` のとき `page` として使用                            |
| `first_id`  | string \| null | 現在ページ先頭レコードの ID                                                             |
| `last_id`   | string \| null | 現在ページ末尾レコードの ID                                                             |
| `has_more`  | boolean        | さらにページがあるかどうか                                                               |

### VaultCredential オブジェクト

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

## エラー

| HTTP | type                    | トリガー条件                                                     |
| ---- | ----------------------- | ---------------------------------------------------------- |
| 400  | `invalid_request_error` | `limit` 無効、または `page`、`before_id`、`after_id` のうち複数が指定されている |
| 401  | `TOKEN_INVALID`         | 認証トークンが欠落または無効                                             |
| 404  | `not_found_error`       | Vault が存在しないまたはアクセス不可                                      |

## 注意事項

* 認証情報一覧では認証情報のシークレットは返されません。
* アーカイブ済み認証情報はデフォルトで除外されます。`include_archived=true` を指定すると含まれます。

エラーエンベロープの詳細については[エラーリファレンス](/ja/cloud-agents/api/conventions/errors)を参照してください。

## 関連項目

<CardGroup cols={2}>
  <Card title="Vaults" icon="key" href="/ja/cloud-agents/vaults">
    シークレットを安全に保存し、Agent Session に注入する。
  </Card>
</CardGroup>