Work item の一覧取得

GET /api/v1/cloud/environments/{environment_id}/work self_hosted Environment の work item を一覧取得します。結果はカーソルページネーションを使用し、キューの作成順に一致する ID の昇順で返されます。

パスパラメータ

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

リクエストヘッダー

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

クエリパラメータ

パラメータ	型	必須	デフォルト	説明
`limit`	integer	いいえ	20	1 ページあたりのアイテム数。正の値でなければならない。100 を超える値は 100 に制限される
`page`	string	いいえ	-	前のレスポンスの `next_page` が返したカーソル
`before_id`	string	いいえ	-	この work item ID より前のレコードを返す
`after_id`	string	いいえ	-	この work item ID より後のレコードを返す

page、before_id、after_id は相互排他的です。カーソルのセマンティクスについてはページネーションを参照してください。

リクエスト例

curl -X GET "https://api.qoder.com/api/v1/cloud/environments/env_019e64e01a137caf953ac2ac7b42ec5c/work?limit=2" \
  -H "Authorization: Bearer $QODER_PAT"

レスポンス例

HTTP 200 OK

{
  "data": [
    {
      "id": "work_019f3be4fd2475d9a784bf2c739e1194",
      "type": "work",
      "environment_id": "env_019e64e01a137caf953ac2ac7b42ec5c",
      "data": {
        "type": "session",
        "id": "sess_019f3be3fa66750bb9a1fbcde85b5fe1"
      },
      "state": "queued",
      "created_at": "2026-07-01T08:15:01Z",
      "acknowledged_at": null,
      "started_at": null,
      "latest_heartbeat_at": null,
      "stop_requested_at": null,
      "stopped_at": null,
      "metadata": {
        "job": "daily-report"
      }
    }
  ],
  "first_id": "work_019f3be4fd2475d9a784bf2c739e1194",
  "last_id": "work_019f3be4fd2475d9a784bf2c739e1194",
  "has_more": false,
  "next_page": null
}

レスポンスフィールド

フィールド	型	説明
`data`	Work item オブジェクトの配列	現在のページの work item
`first_id`	string\|null	このページの最初のレコードの ID
`last_id`	string\|null	このページの最後のレコードの 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`	`page`、`before_id`、`after_id` のうち複数が指定された
400	`invalid_request_error`	Environment が `self_hosted` でない
401	`authentication_error`	PAT が無効または期限切れ
403	`permission_error`	この操作の権限がない
404	`not_found_error`	Environment が存在しない

完全なエラーエンベロープについてはエラーリファレンスを参照してください。

クラウド環境

Agent が実行されるコンテナ、ネットワーク、依存関係を選択する。

​パスパラメータ

​リクエストヘッダー

​クエリパラメータ

​リクエスト例

​レスポンス例

​レスポンスフィールド

​エラー

​関連