50 pages for idle.

optimizing-for-cost-and-intelligence Claude Developer Platform · in the page about-claude/models/optimizing-for-cost-and-intelligence …a `max_tokens: 0` request on the unchanged prefix every 4 minutes of idle time (the August 23 runs pinged with `max_tokens: 1`; every August 26 ping refreshed the cache and billed no output). Schedul… 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… Process results programmatically Claude Developer Platform · in the page agents-and-tools/tool-use/programmatic-tool-calling …Expiration:** `expires_at` tells you how long the container has left. Idle containers are currently reclaimed after about 5 minutes, and no container can be reused more than 30 days after it was creat… 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 …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#beta_managed_agents_session_requires_action.even… List Events Claude Developer Platform · in the page api/beta/sessions/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#beta_managed_agents_session_requires_action.even… 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#beta_managed_agents_session_requires_action.even… 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#beta_managed_agents_session_requires_action.even… 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 …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.… 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#beta_managed_agents_session_requires_action.even… 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#beta_managed_agents_session_requires_action.even… 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#beta_managed_agents_session_requires_action.even… List Session Threads Claude Developer Platform · in the page api/beta/sessions/threads/list …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.… 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 …e.com/docs/en/api/messages/batches/create): * Some networks may drop idle connections after a variable period of time, which can cause the request to fail or time out without receiving a response fro… 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 …e `MaxTokens` value without using streaming as some networks may drop idle connections after a certain period of time, which can cause the request to fail or [timeout](https://platform.claude.com/docs… java Claude Developer Platform · in the page cli-sdks-libraries/sdks/java …rge `maxTokens` value without using streaming. Some networks may drop idle connections after a certain period of time, which can cause the request to fail or [timeout](https://platform.claude.com/docs… For Amazon Bedrock support Claude Developer Platform · in the page cli-sdks-libraries/sdks/python …ge `max_tokens` value without using streaming. Some networks may drop idle connections after a certain period of time, which can cause the request to fail or [timeout](https://platform.claude.com/docs… typescript Claude Developer Platform · in the page cli-sdks-libraries/sdks/typescript …ge `max_tokens` value without using streaming. Some networks may drop idle connections after a certain period of time, which can cause the request to fail or [timeout](https://platform.claude.com/docs… 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`.… events-and-streaming Claude Developer Platform · in the page managed-agents/events-and-streaming …of their names differ from the stream's (for example, `session.status_idled` rather than `session.status_idle`). Every persisted event includes a `processed_at` timestamp set when the event finishes… 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 has finishe… 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 …agent.thread_message_received` (the advice) 4. `session.thread_status_idle` (`stop_reason: end_turn`) 5. `session.thread_status_terminated` No `agent.tool_use` events are emitted for a consultation,… 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… 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… session-operations Claude Developer Platform · in the page managed-agents/session-operations …---------------------------------------------------------------- | | `idle` | Agent is waiting for input, including user messages or tool confirmations. Sessions created without `initial_event… sessions Claude Developer Platform · in the page managed-agents/sessions …ently supported. When the session reaches the cap, it pauses and goes idle with the stop reason `budget_reached`. The cap is enforced between model requests, so the request that crosses it finishes fi… tools Claude Developer Platform · in the page managed-agents/tools …om/docs/en/managed-agents/events-and-streaming) event and returns to `idle` without retrying. Fix the setting by [updating the session's tools](https://platform.claude.com/docs/en/managed-agents/sessi… webhooks Claude Developer Platform · in the page managed-agents/webhooks …ents/events-and-streaming). For example, the stream's `session.status_idle` and `session.status_running` correspond to the `session.status_idled` and `session.status_run_started` webhook events.… Use Claude Code features in the SDK Claude Code CLI · in the page agent-sdk/claude-code-features …vents beyond Python, including `SessionStart`, `SessionEnd`, `TeammateIdle`, and `TaskCompleted`. See the [hooks guide](/docs/en/agent-sdk/hooks) for the full event compatibility table. </Note> For f… Intercept and control agent behavior with hooks Claude Code CLI · in the page agent-sdk/hooks …a result (`PostToolUse`), a subagent started or stopped, the agent is idle, or execution finished. See the [full list of events](#available-hooks). </Step> <Step title="The SDK collects registere… Hosting the Agent SDK Claude Code CLI · in the page agent-sdk/hosting …t updates back. Best for sessions that span many interactions but sit idle between them. The container spins down during idle periods and spins back up when the user returns. Example workloads includ… Agent SDK reference - Python Claude Code CLI · in the page agent-sdk/python …gents. While the stream watchdog is on, the default is `CLAUDE_STREAM_IDLE_TIMEOUT_MS` plus 5 minutes, which comes to `600000` unless you raise that variable. With the stream watchdog off, the default…