Claude Platform Docs

ワークを停止

$ ant beta:environments:work stop
POST/v1/environments/{environment_id}/work/{work_id}/stop

注: これらのエンドポイントは、セルフホスト型サンドボックス環境でセッションをオーケストレーションするために、SDKおよびCLIで提供される事前構築済みの環境ワーカーによって自動的に呼び出されます。参考としてここに記載していますが、直接呼び出す必要はありません。

ワークアイテムを停止し、グレースフルシャットダウンまたは強制シャットダウンを開始します。

Parameters
--environment-id: string

Path param

--work-id: string

Path param

--force: optional boolean

Body param: If true, immediately stop work without graceful shutdown

--beta: optional array of AnthropicBeta

Header param: Optional header to specify the beta version(s) you want to use.

Returns
beta_self_hosted_work: object{ id, acknowledged_at, created_at, 10 more }

Work resource representing a unit of work in a self-hosted environment.

Work items are queued when sessions are created or when long-dormant sessions receive new messages. The environment worker polls for work to execute in a self-hosted sandbox.

id: string

Work identifier (e.g., 'work_...')

acknowledged_at: string

RFC 3339 timestamp when the work item was acknowledged and assigned to a self-hosted sandbox

created_at: string

RFC 3339 timestamp when work was created

data: object{ id, type }

The actual work to be performed

id: string

Session identifier (e.g., 'session_...')

type: "session"

Type of work data

environment_id: string

Environment identifier this work belongs to (e.g., env_...)

latest_heartbeat_at: string

RFC 3339 timestamp of the most recent heartbeat

metadata: map[string]

User-provided metadata key-value pairs associated with this work item

secret: string

Credential payload used by the environment worker to execute this work item. May be populated when polling for work; null on all other retrieval paths.

started_at: string

RFC 3339 timestamp when work execution started

state: "queued" or "starting" or "active" or 2 more

Current state of the work item

One of the following:
"queued"
"starting"
"active"
"stopping"
"stopped"
stop_requested_at: string

RFC 3339 timestamp when stop was requested

stopped_at: string

RFC 3339 timestamp when work execution stopped

type: "work"

The type of object (always 'work')

ワークを停止
ant beta:environments:work stop \
  --api-key my-anthropic-api-key \
  --environment-id env_011CZkZ9X2dpNyB7HsEFoRfW \
  --work-id work_id
Returns Examples
Response 200
{
  "id": "id",
  "acknowledged_at": "acknowledged_at",
  "created_at": "created_at",
  "data": {
    "id": "id",
    "type": "session"
  },
  "environment_id": "environment_id",
  "latest_heartbeat_at": "latest_heartbeat_at",
  "metadata": {
    "foo": "string"
  },
  "secret": "secret",
  "started_at": "started_at",
  "state": "queued",
  "stop_requested_at": "stop_requested_at",
  "stopped_at": "stopped_at",
  "type": "work"
}