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

# Work キュー統計の取得

> セルフホスト Environment のキュー深さと worker のポーリング統計を読み取ります。

`GET /api/v1/cloud/environments/{environment_id}/work/stats`

`self_hosted` Environment のキュー統計を返します。

## パスパラメータ

| パラメータ            | 型      | 説明                               |
| ---------------- | ------ | -------------------------------- |
| `environment_id` | string | `env_` プレフィックス付きの Environment ID |

## リクエストヘッダー

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

## リクエスト例

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

## レスポンス例

**HTTP 200 OK**

```json theme={null}
{
  "type": "work_queue_stats",
  "depth": 3,
  "pending": 1,
  "oldest_queued_at": "2026-07-01T08:15:01Z",
  "workers_polling": 2
}
```

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

[Work キュー統計オブジェクト](/ja/cloud-agents/api/environments/work/schemas#work-queue-stats-object) を返します。

## エラー

| HTTP | type                    | トリガー                            |
| ---- | ----------------------- | ------------------------------- |
| 400  | `invalid_request_error` | Environment が `self_hosted` でない |
| 401  | `authentication_error`  | PAT が無効または期限切れ                  |
| 403  | `permission_error`      | この操作の権限がない                      |
| 404  | `not_found_error`       | Environment が存在しない              |

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

## 備考

* `depth` は現在取得可能なキュー内アイテム数をカウントします。
* `pending` は直近の再配信ウィンドウ内に配信されたがまだ確認応答されていないキュー内アイテム数をカウントします。
* `workers_polling` は `Worker-ID` を含めた poll リクエストのみをカウントします。

## 関連

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