> ## 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.

# Environment 一覧

> 現在のアカウント配下の Environment をカーソルページネーション付きで一覧表示します。

`GET /api/v1/cloud/environments`

現在のアカウント配下の Environment をカーソルページネーション付きで一覧表示します。デフォルトではアーカイブ済みの Environment は含まれません。

## リクエストヘッダー

| ヘッダー            | 必須 | 説明             |
| --------------- | -- | -------------- |
| `Authorization` | はい | `Bearer <PAT>` |

## クエリパラメータ

| パラメータ              | 型       | 必須  | デフォルト   | 説明                                                                 |
| ------------------ | ------- | --- | ------- | ------------------------------------------------------------------ |
| `limit`            | integer | いいえ | 20      | 1 ページあたりの取得件数。範囲は 1〜100。100 を超える値は `400 invalid_request_error` を返す |
| `page`             | string  | いいえ | -       | 前回レスポンスの `next_page` で返されたカーソル                                     |
| `include_archived` | boolean | いいえ | `false` | `true` に設定するとアーカイブ済み Environment も含める                              |
| `created_at[gte]`  | string  | いいえ | -       | この RFC 3339 タイムスタンプ以降に作成された Environment のみ返す                       |
| `created_at[lte]`  | string  | いいえ | -       | この RFC 3339 タイムスタンプ以前に作成された Environment のみ返す                       |

ページネーションの詳細は[ページネーション](/ja/cloud-agents/api/conventions/pagination)を参照してください。

## リクエスト例

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

## レスポンス例

**HTTP 200 OK**

```json theme={null}
{
  "data": [
    {
      "id": "env_019e3bb39b6774d8878cd0b9d237574b",
      "type": "environment",
      "name": "doc-test-env",
      "description": "",
      "config": {
        "type": "cloud",
        "networking": {
          "type": "limited",
          "allowed_hosts": [],
          "allow_package_managers": false,
          "allow_mcp_servers": false
        },
        "packages": {
          "type": "packages",
          "apt": ["curl"],
          "npm": [],
          "pip": []
        }
      },
      "metadata": {},
      "archived_at": null,
      "created_at": "2026-05-18T15:28:07.017808Z",
      "updated_at": "2026-05-18T15:28:07.017808Z"
    },
    {
      "id": "env_019e2590d33f711fabf42f2857cecd8a",
      "type": "environment",
      "name": "default",
      "description": "",
      "config": {
        "type": "cloud",
        "networking": {
          "type": "limited",
          "allowed_hosts": [],
          "allow_package_managers": false,
          "allow_mcp_servers": false
        },
        "packages": {
          "type": "packages",
          "apt": [],
          "npm": [],
          "pip": []
        }
      },
      "metadata": {},
      "archived_at": null,
      "created_at": "2026-05-14T08:18:28.800813Z",
      "updated_at": "2026-05-14T08:18:28.800813Z"
    }
  ],
  "first_id": "env_019e3bb39b6774d8878cd0b9d237574b",
  "has_more": false,
  "last_id": "env_019e2590d33f711fabf42f2857cecd8a",
  "next_page": null
}
```

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

| フィールド       | 型                                                                                     | 説明                                                            |
| ----------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
| `data`      | [Environment オブジェクト](/ja/cloud-agents/api/environments/schemas#environment-オブジェクト)の配列 | 現在のページの Environment                                           |
| `first_id`  | string                                                                                | 現在のページの最初のレコードの ID                                            |
| `last_id`   | string                                                                                | 現在のページの最後のレコードの ID                                            |
| `has_more`  | boolean                                                                               | さらにページがあるかどうか                                                 |
| `next_page` | string\|null                                                                          | 次のページのカーソル。`has_more` が true の場合は `last_id` に等しく、それ以外は `null` |

## エラーコード

| HTTP | type                    | 説明                                                       |
| ---- | ----------------------- | -------------------------------------------------------- |
| 400  | `invalid_request_error` | `limit` が正の整数でない                                         |
| 400  | `invalid_request_error` | ページネーションカーソルが不正                                          |
| 400  | `invalid_request_error` | `created_at[gte]` または `created_at[lte]` が RFC 3339 形式でない |
| 401  | `authentication_error`  | 認証失敗、PAT が無効または期限切れ                                      |
| 403  | `permission_error`      | このリソースへのアクセス権限がない                                        |

## 注意事項

* デフォルトでは ID の降順で返されます。
* アーカイブ済みの Environment はデフォルトの一覧には含まれません。`include_archived=true` を指定すると含めることができます。
* カーソルベースのページネーションを使用しており、オフセット方式はサポートされていません。

## 関連

<CardGroup cols={2}>
  <Card title="クラウド環境" icon="server" href="/ja/cloud-agents/environments">
    Agent が実行されるコンテナ、ネットワーク、依存関係を選択する。
  </Card>
</CardGroup>