Follow Discord
Sweep 10 Nov 2026 · 02:18Z Build v2.1.322 539 read Stable v2.1.311 Latest v2.1.322 Next v2.1.322 Feeds RSS JSON llms.txt llms-full.txt Unofficial
HomeDocsSearch
Search the documentation

148 pages for idle.

Titles and paths first, then pages whose text carries it. Each row opens that page as this site last read it.

pricing Claude Developer Platform · in the page about-claude/pricing …and accrues only while the session’s status is `running`. Time spent `idle` (waiting for your next message or a tool confirmation), `rescheduling`, or `terminated` does not count toward runtime. <Not… Agents Claude Developer Platform · in the page api/beta/agents …ool, an `agent.custom_tool_use` event is emitted and the session goes idle, waiting for the client to provide the result via a `user.custom_tool_result` event. - `type: "custom"` - `descript… Create Agent Claude Developer Platform · in the page api/beta/agents/create …ool, an `agent.custom_tool_use` event is emitted and the session goes idle, waiting for the client to provide the result via a `user.custom_tool_result` event. - `type: "custom"` - `descript… Update Agent Claude Developer Platform · in the page api/beta/agents/update …ool, an `agent.custom_tool_use` event is emitted and the session goes idle, waiting for the client to provide the result via a `user.custom_tool_result` event. - `type: "custom"` - `descript… Sessions Claude Developer Platform · in the page api/beta/sessions …ool, an `agent.custom_tool_use` event is emitted and the session goes idle, waiting for the client to provide the result via a `user.custom_tool_result` event. - `type: "custom"` - `… Archive Session Claude Developer Platform · in the page api/beta/sessions/archive …ative time in seconds the session spent in `running` status. Excludes idle time. format: double - `duration_seconds: optional number` Elapsed time since session creation in seconds.… Create Session Claude Developer Platform · in the page api/beta/sessions/create …ool, an `agent.custom_tool_use` event is emitted and the session goes idle, waiting for the client to provide the result via a `user.custom_tool_result` event. - `type: "custom"` - `… Events Claude Developer Platform · in the page api/beta/sessions/events …s_rescheduled"` - `"session.status_running"` - `"session.status_idle"` - `"session.status_terminated"` - `"session.thread_created"` - `"span.outcome_evaluation_start"` - `"span.outco… List Events Claude Developer Platform · in the page api/beta/sessions/events/list …s_rescheduled"` - `"session.status_running"` - `"session.status_idle"` - `"session.status_terminated"` - `"session.thread_created"` - `"span.outcome_evaluation_start"` - `"span.outco… Send Events Claude Developer Platform · in the page api/beta/sessions/events/send …result corresponds to, which can be found in the last `session.status_idle` [event's](https://platform.claude.com/docs/en/api/beta/sessions/events/list?sdk_languages=http#beta_managed_agents_session_r… Stream Events Claude Developer Platform · in the page api/beta/sessions/events/stream …result corresponds to, which can be found in the last `session.status_idle` [event's](https://platform.claude.com/docs/en/api/beta/sessions/events/list?sdk_languages=http#beta_managed_agents_session_r… List Sessions Claude Developer Platform · in the page api/beta/sessions/list …onse. - `statuses: optional array of "rescheduling" or "running" or "idle" or "terminated"` Filter by session status. Repeat the parameter to match any of multiple statuses. - `"rescheduling"`… Get Session Claude Developer Platform · in the page api/beta/sessions/retrieve …ative time in seconds the session spent in `running` status. Excludes idle time. format: double - `duration_seconds: optional number` Elapsed time since session creation in seconds.… Threads Claude Developer Platform · in the page api/beta/sessions/threads …ave it out to return threads of every status. - `"running"` - `"idle"` - `"rescheduling"` - `"terminated"` ### Headers - `"anthropic-version": optional string` The version of the Clau… Archive Session Thread Claude Developer Platform · in the page api/beta/sessions/threads/archive …umulative time in seconds the thread spent actively running. Excludes idle time. format: double - `duration_seconds: optional number` Elapsed time since thread creation in seconds.… Events Claude Developer Platform · in the page api/beta/sessions/threads/events …result corresponds to, which can be found in the last `session.status_idle` [event's](https://platform.claude.com/docs/en/api/beta/sessions/events/list?sdk_languages=http#beta_managed_agents_session_r… List Session Thread Events Claude Developer Platform · in the page api/beta/sessions/threads/events/list …result corresponds to, which can be found in the last `session.status_idle` [event's](https://platform.claude.com/docs/en/api/beta/sessions/events/list?sdk_languages=http#beta_managed_agents_session_r… Stream Session Thread Events Claude Developer Platform · in the page api/beta/sessions/threads/events/stream …result corresponds to, which can be found in the last `session.status_idle` [event's](https://platform.claude.com/docs/en/api/beta/sessions/events/list?sdk_languages=http#beta_managed_agents_session_r… List Session Threads Claude Developer Platform · in the page api/beta/sessions/threads/list …ave it out to return threads of every status. - `"running"` - `"idle"` - `"rescheduling"` - `"terminated"` ## Headers - `"anthropic-version": optional string` The version of the Claud… Get Session Thread Claude Developer Platform · in the page api/beta/sessions/threads/retrieve …umulative time in seconds the thread spent actively running. Excludes idle time. format: double - `duration_seconds: optional number` Elapsed time since thread creation in seconds.… Update Session Claude Developer Platform · in the page api/beta/sessions/update …ool, an `agent.custom_tool_use` event is emitted and the session goes idle, waiting for the client to provide the result via a `user.custom_tool_result` event. - `type: "custom"` - `desc… Webhooks Claude Developer Platform · in the page api/beta/webhooks …id: string` - `workspace_id: string` - `BetaWebhookSessionIdledEventData object` - `type: "session.idled"` - `id: string` ID of the session that triggered the event.… errors Claude Developer Platform · in the page api/errors …com/docs/en/api/messages/batches/create): * Some networks might drop idle connections after a variable period of time, which can cause the request to fail or time out without receiving a response fro… spans Claude Developer Platform · in the page api/opentelemetry/spans …_reason` | `string` | Why the turn ended: the [`session.thread_status_idle`](https://platform.claude.com/docs/en/api/beta/sessions/events#beta_managed_agents_session_thread_status_idle_event) event’s… anthropic-managed Claude Developer Platform · in the page build-with-claude/claude-models-on-google-cloud/anthropic-managed …ts-and-streaming#integrating-events) by itself. After the session is `idle`, you can archive or delete it. * **Scheduled deployments keep running.** A deployment doesn’t re-check its creator’s access… Delivering work Claude Developer Platform · in the page build-with-claude/prompt-engineering/prompting-claude-fable-5-1 …5-1#leave-room-for-long-outputs-at-xhigh-and-max-effort) * Lead agent idles while subagents run: [Let the lead agent keep working while subagents run](https://platform.claude.com/docs/en/build-with-cl… sessions-connect Claude Developer Platform · in the page cli-sdks-libraries/cli/sessions-connect …ation and outcome. A status bar shows whether the session is running, idle, or waiting for your approval. In [multiagent](https://platform.claude.com/docs/en/managed-agents/multiagent-orchestration) s… go Claude Developer Platform · in the page cli-sdks-libraries/sdks/go …`MaxTokens` value without using streaming as some networks might drop idle connections after a certain period of time, which can cause the request to fail or [time out](https://platform.claude.com/doc… java Claude Developer Platform · in the page cli-sdks-libraries/sdks/java …e `maxTokens` value without using streaming. Some networks might drop idle connections after a certain period of time, which can cause the request to fail or [time out](https://platform.claude.com/doc… For Amazon Bedrock support Claude Developer Platform · in the page cli-sdks-libraries/sdks/python …`max_tokens` value without using streaming. Some networks might drop idle connections after a certain period of time, which can cause the request to fail or [time out](https://platform.claude.com/doc… typescript Claude Developer Platform · in the page cli-sdks-libraries/sdks/typescript …`max_tokens` value without using streaming. Some networks might drop idle connections after a certain period of time, which can cause the request to fail or [time out](https://platform.claude.com/doc… budgets Claude Developer Platform · in the page managed-agents/budgets …session-reaches-its-budget). A session at its budget pauses and goes [idle](https://platform.claude.com/docs/en/managed-agents/session-operations#session-statuses) rather than terminating; changing or… DCF Model Rubric Claude Developer Platform · in the page managed-agents/define-outcomes …-------------- | | `satisfied` | Session transitions to `idle`.… event-deltas Claude Developer Platform · in the page managed-agents/event-deltas …previews.clear() case "session.status_idle": break ``` ```typescript TypeScript // Preview snapshots, keyed by event ID. `accumulateManagedAgen… events-and-streaming Claude Developer Platform · in the page managed-agents/events-and-streaming …s differ from the stream’s. For example, webhooks use `session.status_idled` rather than `session.status_idle`. ## Stream events Stream events from the session to receive real-time updates as the ag… files Claude Developer Platform · in the page managed-agents/files …finishes writing them, sometimes a few seconds after the session goes idle. If an output file you expect is missing, list again after a short delay; once it appears in the list, its upload is complete… mcp-connector Claude Developer Platform · in the page managed-agents/mcp-connector …server’s tools. The connection is retried on the next `session.status_idle` to `session.status_running` transition. ## Next steps <CardGroup cols={2}> <Card title="Permission policies" icon="check… migration Claude Developer Platform · in the page managed-agents/migration …| The session emits `session.status_idle` when the agent has nothing more to do. | ### Code comparison **Before** (Messa… multiagent-orchestration Claude Developer Platform · in the page managed-agents/multiagent-orchestration …evel deep, and a session can have at most 25 child threads at a time, idle ones included. Advisor threads and a workflow run’s threads don’t count.… permission-policies Claude Developer Platform · in the page managed-agents/permission-policies …ent.mcp_tool_use` event. 2. The session pauses with a `session.status_idle` event whose `stop_reason.type` is `requires_action`. The blocking event IDs are in the `stop_reason.event_ids` array. The se… quickstart Claude Developer Platform · in the page managed-agents/quickstart …\n[Using tool: {event.name}]") case "session.status_idle": print("\n\nAgent finished.") break ``` ```typescript TypeScript… reference Claude Developer Platform · in the page managed-agents/reference …of their names differ from the stream’s (for example, `session.status_idled` rather than `session.status_idle`). <Tabs> <Tab title="User events"> | Type | Description… secure-deployment Claude Developer Platform · in the page managed-agents/secure-deployment …events | Optional. A review of each session that went idle or terminated, on a schedule… secure-deployment-monitoring Claude Developer Platform · in the page managed-agents/secure-deployment-monitoring …------------------------------------------------ | | Sessions that go idle, for example to wait for approval | The `session.status_idled` webhook. It fires each time a session goes idle, for any reaso… spawn.sh: called once per claimed work item Claude Developer Platform · in the page managed-agents/self-hosted-sandboxes …only outbound HTTPS. Choose **webhook-triggered** to avoid running an idle poller; it requires a webhook endpoint that Anthropic can reach (see [Webhooks](https://platform.claude.com/docs/en/managed-a… self-hosted-sandboxes-custom-tools Claude Developer Platform · in the page managed-agents/self-hosted-sandboxes-custom-tools …server’s tools change: 1. Declare them again, on the agent or on an idle session through [Updating the agent configuration](https://platform.claude.com/docs/en/managed-agents/session-operations#upda… self-hosted-sandboxes-memory Claude Developer Platform · in the page managed-agents/self-hosted-sandboxes-memory …store’s directory, so it fails the work item. The session then stays idle with no error event. See [Memory stores fail to mount](https://platform.claude.com/docs/en/managed-agents/self-hosted-sandbox… self-hosted-sandboxes-operations Claude Developer Platform · in the page managed-agents/self-hosted-sandboxes-operations …n, it fails the work item. The session emits no error event and stays idle. | Symptom… self-hosted-sandboxes-reference Claude Developer Platform · in the page managed-agents/self-hosted-sandboxes-reference …| | `--max-idle` | How long the worker waits while a session is idle before `ant beta:worker run` exits or `ant beta:worker poll` move… self-hosted-sandboxes-workers Claude Developer Platform · in the page managed-agents/self-hosted-sandboxes-workers …es on `session.status_run_started` and starts polling. This avoids an idle poller, but requires a [webhook](https://platform.claude.com/docs/en/managed-agents/webhooks) endpoint that Anthropic can rea…
Feedback