Work item の確認応答

POST /api/v1/cloud/environments/{environment_id}/work/{work_id}/ack 配信された work item を確認応答し、queued から starting へ移行させます。worker は poll の後、Session work を実行する前に ack する必要があります。すでに starting または active のアイテムに対する ack は安全に再試行できます。stopping または stopped のアイテムに対しては競合します。

パスパラメータ

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

リクエストヘッダー

ヘッダー	必須	説明
`Authorization`	はい	`Bearer $QODER_PAT`
`Worker-ID`	いいえ	安定した worker 識別子。poll が別の `Worker-ID` を保存していた場合、ack は 409 を返す

リクエスト例

curl -X POST "https://api.qoder.com/api/v1/cloud/environments/env_019e64e01a137caf953ac2ac7b42ec5c/work/work_019f3be4fd2475d9a784bf2c739e1194/ack" \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Worker-ID: byoc-worker-01"

レスポンス例

HTTP 200 OK

{
  "id": "work_019f3be4fd2475d9a784bf2c739e1194",
  "type": "work",
  "environment_id": "env_019e64e01a137caf953ac2ac7b42ec5c",
  "data": {
    "type": "session",
    "id": "sess_019f3be3fa66750bb9a1fbcde85b5fe1"
  },
  "state": "starting",
  "created_at": "2026-07-01T08:15:01Z",
  "acknowledged_at": "2026-07-01T08:15:04Z",
  "started_at": null,
  "latest_heartbeat_at": null,
  "stop_requested_at": null,
  "stopped_at": null,
  "metadata": {}
}

レスポンスフィールド

確認応答された Work item オブジェクトを返します。

エラー

HTTP	type	トリガー
400	`invalid_request_error`	Environment が `self_hosted` でない
401	`authentication_error`	PAT が無効または期限切れ
403	`permission_error`	この操作の権限がない
404	`not_found_error`	Environment または work item が存在しない
409	`invalid_request_error`	Work item が別の worker に取得された、同時に state が変化した、または `stopping`/`stopped` である

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

備考

ack 後の最初の heartbeat は通常 expected_last_heartbeat=NO_HEARTBEAT を使用します。
ack は即座にディスパッチパスをトリガーするため、次のディスパッチャーティックを待たずに work を進められます。

クラウド環境

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

​パスパラメータ

​リクエストヘッダー

​リクエスト例

​レスポンス例

​レスポンスフィールド

​エラー

​備考

​関連