Poll Work Items

Let a self-hosted executor poll the environment's work queue for the next item to claim.

GET /anthropic/v1/environments/{environment_id}/work/poll○ Unsupported

Request parameters

environment_idstring必填
path: Environment ID (path or query parameter).
block_msnumber可选
query: How long to wait for work to arrive, in milliseconds (1–999).
reclaim_older_than_msnumber可选
query: Reclaim work whose lease is older than this many milliseconds.
Anthropic-Worker-IDstring可选
query: ID of the self-hosted worker instance polling, used to aggregate environment-level work metrics in Console.

Returns

501 This endpoint is not implemented yet; calling it returns the response below:

This is the task-claiming protocol for self-hosted executors; platform agents always execute on the platform, and self-hosted executors are not supported. Calling it returns 501 (not_implemented_error), produces no side effects, and the official SDK does not retry.

Errors follow the Claude Managed Agents format — see error codes

Response

HTTP 200

Successful response

application/json

Name	Type	Description
id	string	Work identifier (e.g., 'work_...')
acknowledged_at	null \| string	RFC 3339 timestamp when work was acknowledged by Environment Manager
created_at	string	RFC 3339 timestamp when work was created
data	object	The actual work to be performed (session or health check)
data.id	string	Session identifier (e.g., 'session_...') / Health check identifier
data.type	string	Type of work data
environment_id	string	Environment identifier this work belongs to (e.g., `env_...`)
latest_heartbeat_at	null \| string	RFC 3339 timestamp of the most recent heartbeat
metadata	object	User-provided metadata key-value pairs associated with this work item
secret	null \| 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	null \| string	RFC 3339 timestamp when work execution started
state	string	Current state of the work item
stop_requested_at	null \| string	RFC 3339 timestamp when stop was requested
stopped_at	null \| string	RFC 3339 timestamp when work execution stopped
type	string	The type of object (always 'work')