api-20260911T173712Z / documentation capture

agents-and-tools/tool-use/browser-use-tool Changed · +13 / -7 lines

from line 1119

11191119

11201120 1. Run the browser and your executor in a dedicated container or virtual machine with minimal privileges, a fresh profile that holds no credentials, and no access to sensitive filesystems or internal networks; isolate any tool you run alongside it the same way.

11211121 2. Restrict the hosts the browser can reach to a domain allowlist enforced at the network layer and re-checked in your `navigate` handler after redirects, and block loopback, link-local, and private ranges unless the task needs them.

1122 3. Treat everything a page supplies as untrusted input, including the tab titles and URLs you report in a [`browser_state`](https://platform.claude.com/docs/en/agents-and-tools/tool-use/browser-use-tool#track-tabs-and-page-state) block, and build page reads from what the page renders (the accessibility tree or visible text), not raw DOM source, so hidden text doesn't reach Claude.

1122 3. Treat everything a page supplies as untrusted input, including the tab titles and URLs, and each download's `url`, `path`, and `error`, that you report in a [`browser_state`](https://platform.claude.com/docs/en/agents-and-tools/tool-use/browser-use-tool#track-tabs-and-page-state) block, and build page reads from what the page renders (the accessibility tree or visible text), not raw DOM source, so hidden text doesn't reach Claude.

11231123 4. In your `navigate` handler, accept the history keywords `"back"`, `"forward"`, and `"reload"`, treat a URL without a scheme as `https://`, then parse the URL and refuse any scheme other than `http` or `https` (`javascript:`, `file:`, `data:`, `chrome:`, and so on) with an [error result](https://platform.claude.com/docs/en/agents-and-tools/tool-use/browser-use-tool#return-errors-from-your-executor). Check the scheme with a URL parser rather than a string prefix; the API never sees the navigation and can't reject it for you.

11241124 5. Leave `javascript_exec` and `file_upload` disabled unless you need them, and read [Enable optional members](https://platform.claude.com/docs/en/agents-and-tools/tool-use/browser-use-tool#enable-optional-member-tools) before turning either on.

11251125 6. Have a human confirm consequential actions and anything that requires affirmative consent (purchasing, modifying accounts, messaging, and accepting terms), and make that check in your executor before each call, because one turn can carry several.

from line 1295

12951295* `tabs` is the full inventory of open tabs after the call, not a delta. It may be empty; whenever it isn't, exactly one entry carries `"active": true`.

12961296* `state_changes` (not shown here) reports side effects of the call: a `tab_opened` entry for each tab the call opened that's still open when it finishes, whose `tab_id` must also appear in `tabs`, and [download events](https://platform.claude.com/docs/en/agents-and-tools/tool-use/browser-use-tool#report-downloads). Omit the field when there's nothing to report; an empty array is rejected.

12971297* Send the block only on results that answer a browser member call, at most once per `tool_result`, and never on a result with `is_error: true`. You express "no tab state to report" by omitting the block.

1298* The API renders `tabs` into text for Claude as the next two sections describe; download entries in `state_changes` are validated but not rendered.

1298* The API renders `tabs`, and any download entries in `state_changes`, into text for Claude. The next two sections and [Report downloads](https://platform.claude.com/docs/en/agents-and-tools/tool-use/browser-use-tool#report-downloads) show that text.

12991299

13001300**You assign `tab_id` values.** Any stable string works, such as your automation library's page identifier or your own counter, as long as you don't reuse a `tab_id` while a tab with that identifier is still listed as open in an earlier result. The API enforces these limits on the block:

13011301

from line 1304

13041304* The same limits apply to the `tab_id` Claude passes to `switch_tab` and `close_tab`, because the API renders it into the result text, so answer a call whose `tab_id` violates them with an error result instead of a `browser_state` block.

13051305

13061306<Warning>

1307 Tab titles and URLs come from the page and render into text Claude reads, so they're a prompt-injection surface. The API renders URLs verbatim, so sanitize page-supplied URLs before populating `tabs`. It escapes double quotes and backslashes in titles when it renders them, so don't pre-escape titles (a pre-escaped title reaches Claude double-escaped); truncating or dropping suspicious titles is still worthwhile. The length and character limits the API enforces are a floor, not a defense.

1307 Tab titles and URLs come from the page and render into text Claude reads, so they're a prompt-injection surface. The API renders tab URLs verbatim, so sanitize page-supplied URLs before populating `tabs`. It escapes double quotes and backslashes in titles when it renders them, so don't pre-escape titles (a pre-escaped title reaches Claude double-escaped); truncating or dropping suspicious titles is still worthwhile. A download entry's `url`, `path`, and `error` also render into text Claude reads, so treat them as untrusted too; the API quotes and escapes them as it does titles. The length and character limits the API enforces are a floor, not a defense.

13081308</Warning>

13091309

13101310### Tab management results

from line 1373

13731373Three cases render no footer even when the block is present:

13741374

13751375* Any `zoom` result.

1376* A result with no `text` block (an image-only `screenshot` result, for example). Nothing is rendered or remembered for that result; the tab context appears on the next result that carries both text and a `browser_state` block, so include a short text block alongside the image when you want Claude to see a tab change on that same result.

1376* A result with no `text` block (an image-only `screenshot` result, for example). Nothing is rendered or remembered for that result; the tab context appears on the next result that carries both text and a `browser_state` block, so include a short text block alongside the image when you want Claude to see a tab change on that same result. The exception is a result whose block reports a [download event](https://platform.claude.com/docs/en/agents-and-tools/tool-use/browser-use-tool#report-downloads). The API adds the download lines as a text block, and the footer follows them as it would on any result with text.

13771377* A result whose `tabs` list is empty on a call that carried no `tab_id`, because there's no tab to name.

13781378

13791379For example, when Claude clicked the "Pricing" link (`ref_5`) earlier in this session, the page opened it in a new tab Claude didn't ask for, and without a report Claude would have to call `list_tabs` to discover it. Return the click's acknowledgment plus a block whose `state_changes` names the opened tab, marking whichever tab your executor left active:

from line 1419

14191419| `download_completed` | `download_id`, `url`, `path?`, `size_bytes?` | On the result of whichever later call is running when the download finishes. Include `path` only when another tool in the same environment (for example, the [bash tool](https://platform.claude.com/docs/en/agents-and-tools/tool-use/bash-tool) or `file_upload`) can read the file there; otherwise `download_id` is the download's only identifier. |

14201420| `download_failed` | `download_id`, `url`, `error?` | When the download fails or is canceled, with the reason in `error` if the browser provides one. |

14211421

1422The API validates these entries but doesn't render them into text Claude sees, so when Claude needs to act on the file, also mention the file name or `path` in the same result's `text` block.

1422The API renders each entry as one line of text for Claude, in the order the entries appear. It adds the lines after the result's text, separated by a blank line, and before any Tab Context footer. Every kind of member result carries the lines, including `zoom` and tab-management results. A result with no `text` block gets them as a text block of its own. Each line gives the `download_id` and `url`, plus `path` and `size_bytes` (for `download_completed`) or `error` (for `download_failed`) when you send them. You don't need to describe the download in your own text. The API wraps `url`, `path`, and `error` in double quotes and escapes double quotes and backslashes inside them, so don't pre-escape these values.

14231423

1424For example, a click on "Download price list (CSV)" (`ref_8`) in the Pricing tab starts a download, so the click's result carries a `download_started` entry with `download_id` `"dl-1"` and the file's URL. The download finishes while a later `screenshot` call is running, so that result's `content` holds the image, a text block such as `Screenshot captured. Download complete: /home/user/downloads/price-list.csv (48,213 bytes).`, and this `browser_state` block reporting the completion under the same `download_id`:

1424For example, a click on "Download price list (CSV)" (`ref_8`) in the Pricing tab starts a download, so the click's result carries a `download_started` entry with `download_id` `"dl-1"` and the file's URL. The download finishes while a later `screenshot` call is running, so that result's `content` holds the image, a text block such as `Screenshot captured.`, and this `browser_state` block reporting the completion under the same `download_id`:

14251425

14261426```json

14271427{

from line 1445

14451445 }

14461446 ]

14471447}

1448```

1449

1450Claude sees `Screenshot captured.` followed by a blank line and a line like this:

1451

1452```text wrap

1453Download completed with download_id: dl-1, URL: "https://example.com/pricing/price-list.csv". Saved to "/home/user/downloads/price-list.csv". Size: 48213 bytes.

14481454```

14491455

14501456Download reports follow these rules:

api/beta Changed · +0 / -160 lines

This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.

from line 1666

16661666

16671667 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

16681668

1669 Tool invocation directly from the model.

1670

16711669 - `BetaDirectCaller object`

16721670

16731671 Tool invocation directly from the model.

from line 1921

19231921

19241922 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

19251923

1926 Tool invocation directly from the model.

1927

19281924 - `BetaDirectCaller object`

19291925

19301926 Tool invocation directly from the model.

from line 1977

19811977

19821978 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

19831979

1984 Tool invocation directly from the model.

1985

19861980 - `BetaDirectCaller object`

19871981

19881982 Tool invocation directly from the model.

from line 2043

20492043

20502044 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

20512045

2052 Tool invocation directly from the model.

2053

20542046 - `BetaDirectCaller object`

20552047

20562048 Tool invocation directly from the model.

from line 2111

21192111

21202112 - `content: BetaCodeExecutionToolResultBlockParamContent`

21212113

2122 Code execution result with encrypted stdout for PFC + web_search results.

2123

21242114 - `BetaCodeExecutionToolResultErrorParam object`

21252115

21262116 - `type: "code_execution_tool_result_error"`

from line 2432

24422432

24432433 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`

24442434

2445 Reference to a single tool the caller declared directly in

2446 `tools[]`. Does not accept the composed `{server}_{name}` form the

2447 server assigns to MCP-resolved tools — use `mcp_tool_reference` or

2448 `mcp_toolset_reference` for those.

2449

24502435 - `BetaToolChangeToolReference object`

24512436

24522437 Reference to a single tool the caller declared directly in

from line 2480

24952480

24962481 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`

24972482

2498 Reference to a single tool the caller declared directly in

2499 `tools[]`. Does not accept the composed `{server}_{name}` form the

2500 server assigns to MCP-resolved tools — use `mcp_tool_reference` or

2501 `mcp_toolset_reference` for those.

2502

25032483 - `BetaToolChangeToolReference object`

25042484

25052485 Reference to a single tool the caller declared directly in

from line 5356

53765356

53775357 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

53785358

5379 Tool invocation directly from the model.

5380

53815359 - `BetaDirectCaller object`

53825360

53835361 Tool invocation directly from the model.

from line 5418

54405418

54415419 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

54425420

5443 Tool invocation directly from the model.

5444

54455421 - `BetaDirectCaller object`

54465422

54475423 Tool invocation directly from the model.

from line 5476

55005476

55015477 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

55025478

5503 Tool invocation directly from the model.

5504

55055479 - `BetaDirectCaller object`

55065480

55075481 Tool invocation directly from the model.

from line 5580

56065580

56075581 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

56085582

5609 Tool invocation directly from the model.

5610

56115583 - `BetaDirectCaller object`

56125584

56135585 Tool invocation directly from the model.

from line 5658

56865658

56875659 - `content: BetaCodeExecutionToolResultBlockContent`

56885660

5689 Code execution result with encrypted stdout for PFC + web_search results.

5690

56915661 - `BetaCodeExecutionToolResultError object`

56925662

56935663 - `type: "code_execution_tool_result_error"`

from line 6950

69806950

69816951 - `content_block: BetaTextBlock or BetaThinkingBlock or BetaRedactedThinkingBlock or 14 more`

69826952

6983 Response model for a file uploaded to the container.

6984

69856953 - `BetaTextBlock object`

69866954

69876955 - `BetaThinkingBlock object`

from line 7766

77987766

77997767 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

78007768

7801 Tool invocation directly from the model.

7802

78037769 - `BetaDirectCaller object`

78047770

78057771 Tool invocation directly from the model.

from line 8021

80558021

80568022 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

80578023

8058 Tool invocation directly from the model.

8059

80608024 - `BetaDirectCaller object`

80618025

80628026 Tool invocation directly from the model.

from line 8077

81138077

81148078 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

81158079

8116 Tool invocation directly from the model.

8117

81188080 - `BetaDirectCaller object`

81198081

81208082 Tool invocation directly from the model.

from line 8143

81818143

81828144 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

81838145

8184 Tool invocation directly from the model.

8185

81868146 - `BetaDirectCaller object`

81878147

81888148 Tool invocation directly from the model.

from line 8211

82518211

82528212 - `content: BetaCodeExecutionToolResultBlockParamContent`

82538213

8254 Code execution result with encrypted stdout for PFC + web_search results.

8255

82568214 - `BetaCodeExecutionToolResultErrorParam object`

82578215

82588216 - `type: "code_execution_tool_result_error"`

from line 8532

85748532

85758533 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`

85768534

8577 Reference to a single tool the caller declared directly in

8578 `tools[]`. Does not accept the composed `{server}_{name}` form the

8579 server assigns to MCP-resolved tools — use `mcp_tool_reference` or

8580 `mcp_toolset_reference` for those.

8581

85828535 - `BetaToolChangeToolReference object`

85838536

85848537 Reference to a single tool the caller declared directly in

from line 8580

86278580

86288581 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`

86298582

8630 Reference to a single tool the caller declared directly in

8631 `tools[]`. Does not accept the composed `{server}_{name}` form the

8632 server assigns to MCP-resolved tools — use `mcp_tool_reference` or

8633 `mcp_toolset_reference` for those.

8634

86358583 - `BetaToolChangeToolReference object`

86368584

86378585 Reference to a single tool the caller declared directly in

from line 8714

87668714

87678715 - `role: "user" or "assistant" or "system"`

87688716

8769 - `"use

8717 - `"user"`

8718

8719 - `"assistant"`

8720

8721 - `"system"`

8722

8723 - `clear_at: optional "next_user_message" or "never" or null`

8724

8725 How long this system message's text stays in front of the model. `"never"` (the default) renders it on every request that includes it. `"next_user_message"` renders it only for the user turn it follows: once a later `role: "user"` message exists in `messages` the message stays in the array (send it unchanged) but is no longer shown to the model. Only permitted on `role: "system"` messages.

8726

8727 - `"next_user_message"`

8728

8729 - `"never"`

8730

8731 - `output_config: optional BetaSystemMessageOutputConfig or null`

8732

8733 Per-message output configuration on a role:"system" input message.

8734

8735 Fields here apply per-turn; `format` remains top-level only. An

8736 empty `{}` is accepted on a message that carries content; a message

8737 with neither content nor output_config fields is rejected.

8738

8739 - `effort: optional "low" or "medium" or "high" or 2 more or null`

8740

8741 All possible effort levels.

8742

8743 - `"low"`

8744

8745 - `"medium"`

8746

8747 - `"high"`

8748

8749 - `"xhigh"`

8750

8751 - `"max"`

8752

8753- `model: Model`

8754

8755 The model that will complete your prompt.

8756

8757 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.

8758

8759- `cache_control: optional BetaCacheControlEphemeral or null`

8760

8761 Top-level cache control automatically applies a cache_control marker to the last cacheable block in the request.

8762

8763- `context_management: optional BetaContextManagementConfig or null`

8764

8765 Context management configuration.

8766

8767 This allows you to control how Claude manages context across multiple requests, such as whether to clear function results or not.

8768

8769 - `edits: optional array of BetaClearToolUses20250919Edit or BetaClearThinking20251015Edit or BetaCompact20260112Edit`

8770

8771 List of context management edits to apply

8772

8773 minItems: 0

8774

8775 - `BetaClearToolUses20250919Edit object`

8776

8777 - `type: "clear_tool_uses_20250919"`

8778

8779 - `clear_at_least: optional BetaInputTokensClearA

api/beta/dreams Changed · +361 / -383 lines

from line 137

137137

138138- `model: string or BetaDreamModelConfigParam`

139139

140 Model identifier and configuration applied to every pipeline stage.

141

142140 - `string`

143141

144142 - `BetaDreamModelConfigParam object`

from line 163

165163

166164- `output_behavior: optional BetaOutputBehavior`

167165

168 The default destination: the job creates a new output memory store as a clone of the memory_store input and writes the consolidated memories into it. The input store is never mutated.

169

170166 - `BetaOutputBehaviorCreateNew object`

171167

172168 The default destination: the job creates a new output memory store as a clone of the memory_store input and writes the consolidated memories into it. The input store is never mutated.

from line 257

261257

262258 - `output_behavior: BetaOutputBehavior`

263259

264 The default destination: the job creates a new output memory store as a clone of the memory_store input and writes the consolidated memories into it. The input store is never mutated.

265

266260 - `BetaOutputBehaviorCreateNew object`

267261

268262 The default destination: the job creates a new output memory store as a clone of the memory_store input and writes the consolidated memories into it. The input store is never mutated.

from line 612

618612

619613 - `output_behavior: BetaOutputBehavior`

620614

621 The default destination: the job creates a new output memory store as a clone of the memory_store input and writes the consolidated memories into it. The input store is never mutated.

622

623615 - `BetaOutputBehaviorCreateNew object`

624616

625617 The default destination: the job creates a new output memory store as a clone of the memory_store input and writes the consolidated memories into it. The input store is never mutated.

from line 928

936928

937929 - `output_behavior: BetaOutputBehavior`

938930

939 The default destination: the job creates a new output memory store as a clone of the memory_store input and writes the consolidated memories into it. The input store is never mutated.

940

941931 - `BetaOutputBehaviorCreateNew object`

942932

943933 The default destination: the job creates a new output memory store as a clone of the memory_store input and writes the consolidated memories into it. The input store is never mutated.

from line 1237

12471237

12481238 - `output_behavior: BetaOutputBehavior`

12491239

1250 The default destination: the job creates a new output memory store as a clone of the memory_store input and writes the consolidated memories into it. The input store is never mutated.

1251

12521240 - `BetaOutputBehaviorCreateNew object`

12531241

12541242 The default destination: the job creates a new output memory store as a clone of the memory_store input and writes the consolidated memories into it. The input store is never mutated.

from line 1547

15591547

15601548 - `output_behavior: BetaOutputBehavior`

15611549

1562 The default destination: the job creates a new output memory store as a clone of the memory_store input and writes the consolidated memories into it. The input store is never mutated.

1563

15641550 - `BetaOutputBehaviorCreateNew object`

15651551

15661552 The default destination: the job creates a new output memory store as a clone of the memory_store input and writes the consolidated memories into it. The input store is never mutated.

from line 1747

17611747

17621748 - `output_behavior: BetaOutputBehavior`

17631749

1764 The default destination: the job creates a new output memory store as a clone of the memory_store input and writes the consolidated memories into it. The input store is never mutated.

1765

17661750 - `BetaOutputBehaviorCreateNew object`

17671751

17681752 The default destination: the job creates a new output memory store as a clone of the memory_store input and writes the consolidated memories into it. The input store is never mutated.

from line 1827

18431827

18441828- `BetaDreamInput = BetaDreamMemoryStoreInput or BetaDreamSessionsInput`

18451829

1846 An input memory store the dream reads from. The dream never mutates this store unless it is also the destination: with output_behavior {type: "update_existing"} the job consolidates this store in place.

1847

18481830 - `BetaDreamMemoryStoreInput object`

18491831

18501832 An input memory store the dream reads from. The dream never mutates this store unless it is also the destination: with output_behavior {type: "update_existing"} the job consolidates this store in place.

from line 1977

19951977

19961978- `BetaDreamingError = BetaInvalidRequestError or BetaAuthenticationError or BetaBillingError or 7 more`

19971979

1998 The `output_behavior.memory_store_id` target is still held by a prior `{type: "update_existing"}` dream — one that is `pending` or `running`, or was canceled with its final writes still landing. Rarely the named dream has just finished (`completed`/`failed`) and its execution is still closing; an immediate retry then almost always succeeds. The message names the holding dream when the server can identify it (rarely omitted); poll it to a terminal state or cancel it, then retry. Carried with `x-should-retry: false`.

1999

20001980 - `BetaInvalidRequestError object`

20011981

20021982 - `type: "invalid_request_error"`

from line 2080

21002080### Beta Output Behavior

21012081

21022082- `BetaOutputBehavior = BetaOutputBehaviorCreateNew or BetaOutputBehaviorUpdateExisting`

2103

2104 The default destination: the job creates a new output memory store as a clone of the memory_store input and writes the consolidated memories into it. The input store is never mutated.

21052083

21062084 - `BetaOutputBehaviorCreateNew object`

21072085

api/beta/dreams/create Changed · +0 / -6 lines

from line 135

135135

136136- `model: string or BetaDreamModelConfigParam`

137137

138 Model identifier and configuration applied to every pipeline stage.

139

140138 - `string`

141139

142140 - `BetaDreamModelConfigParam object`

from line 161

163161

164162- `output_behavior: optional BetaOutputBehavior`

165163

166 The default destination: the job creates a new output memory store as a clone of the memory_store input and writes the consolidated memories into it. The input store is never mutated.

167

168164 - `BetaOutputBehaviorCreateNew object`

169165

170166 The default destination: the job creates a new output memory store as a clone of the memory_store input and writes the consolidated memories into it. The input store is never mutated.

from line 254

258254 - `"fast"`

259255

260256 - `output_behavior: BetaOutputBehavior`

261

262 The default destination: the job creates a new output memory store as a clone of the memory_store input and writes the consolidated memories into it. The input store is never mutated.

263257

264258 - `BetaOutputBehaviorCreateNew object`

265259

api/beta/messages Changed · +109 / -333 lines

This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.

from line 531

531531

532532 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

533533

534 Tool invocation directly from the model.

535

536534 - `BetaDirectCaller object`

537535

538536 Tool invocation directly from the model.

from line 786

788786

789787 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

790788

791 Tool invocation directly from the model.

792

793789 - `BetaDirectCaller object`

794790

795791 Tool invocation directly from the model.

from line 842

846842

847843 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

848844

849 Tool invocation directly from the model.

850

851845 - `BetaDirectCaller object`

852846

853847 Tool invocation directly from the model.

from line 908

914908

915909 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

916910

917 Tool invocation directly from the model.

918

919911 - `BetaDirectCaller object`

920912

921913 Tool invocation directly from the model.

from line 976

984976

985977 - `content: BetaCodeExecutionToolResultBlockParamContent`

986978

987 Code execution result with encrypted stdout for PFC + web_search results.

988

989979 - `BetaCodeExecutionToolResultErrorParam object`

990980

991981 - `type: "code_execution_tool_result_error"`

from line 1297

13071297

13081298 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`

13091299

1310 Reference to a single tool the caller declared directly in

1311 `tools[]`. Does not accept the composed `{server}_{name}` form the

1312 server assigns to MCP-resolved tools — use `mcp_tool_reference` or

1313 `mcp_toolset_reference` for those.

1314

13151300 - `BetaToolChangeToolReference object`

13161301

13171302 Reference to a single tool the caller declared directly in

from line 1345

13601345

13611346 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`

13621347

1363 Reference to a single tool the caller declared directly in

1364 `tools[]`. Does not accept the composed `{server}_{name}` form the

1365 server assigns to MCP-resolved tools — use `mcp_tool_reference` or

1366 `mcp_toolset_reference` for those.

1367

13681348 - `BetaToolChangeToolReference object`

13691349

13701350 Reference to a single tool the caller declared directly in

from line 4221

42414221

42424222 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

42434223

4244 Tool invocation directly from the model.

4245

42464224 - `BetaDirectCaller object`

42474225

42484226 Tool invocation directly from the model.

from line 4283

43054283

43064284 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

43074285

4308 Tool invocation directly from the model.

4309

43104286 - `BetaDirectCaller object`

43114287

43124288 Tool invocation directly from the model.

from line 4341

43654341

43664342 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

43674343

4368 Tool invocation directly from the model.

4369

43704344 - `BetaDirectCaller object`

43714345

43724346 Tool invocation directly from the model.

from line 4445

44714445

44724446 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

44734447

4474 Tool invocation directly from the model.

4475

44764448 - `BetaDirectCaller object`

44774449

44784450 Tool invocation directly from the model.

from line 4523

45514523

45524524 - `content: BetaCodeExecutionToolResultBlockContent`

45534525

4554 Code execution result with encrypted stdout for PFC + web_search results.

4555

45564526 - `BetaCodeExecutionToolResultError object`

45574527

45584528 - `type: "code_execution_tool_result_error"`

from line 5815

58455815

58465816 - `content_block: BetaTextBlock or BetaThinkingBlock or BetaRedactedThinkingBlock or 14 more`

58475817

5848 Response model for a file uploaded to the container.

5849

58505818 - `BetaTextBlock object`

58515819

58525820 - `BetaThinkingBlock object`

from line 6631

66636631

66646632 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

66656633

6666 Tool invocation directly from the model.

6667

66686634 - `BetaDirectCaller object`

66696635

66706636 Tool invocation directly from the model.

from line 6886

69206886

69216887 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

69226888

6923 Tool invocation directly from the model.

6924

69256889 - `BetaDirectCaller object`

69266890

69276891 Tool invocation directly from the model.

from line 6942

69786942

69796943 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

69806944

6981 Tool invocation directly from the model.

6982

69836945 - `BetaDirectCaller object`

69846946

69856947 Tool invocation directly from the model.

from line 7008

70467008

70477009 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

70487010

7049 Tool invocation directly from the model.

7050

70517011 - `BetaDirectCaller object`

70527012

70537013 Tool invocation directly from the model.

from line 7076

71167076

71177077 - `content: BetaCodeExecutionToolResultBlockParamContent`

71187078

7119 Code execution result with encrypted stdout for PFC + web_search results.

7120

71217079 - `BetaCodeExecutionToolResultErrorParam object`

71227080

71237081 - `type: "code_execution_tool_result_error"`

from line 7397

74397397

74407398 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`

74417399

7442 Reference to a single tool the caller declared directly in

7443 `tools[]`. Does not accept the composed `{server}_{name}` form the

7444 server assigns to MCP-resolved tools — use `mcp_tool_reference` or

7445 `mcp_toolset_reference` for those.

7446

74477400 - `BetaToolChangeToolReference object`

74487401

74497402 Reference to a single tool the caller declared directly in

from line 7445

74927445

74937446 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`

74947447

7495 Reference to a single tool the caller declared directly in

7496 `tools[]`. Does not accept the composed `{server}_{name}` form the

7497 server assigns to MCP-resolved tools — use `mcp_tool_reference` or

7498 `mcp_toolset_reference` for those.

7499

75007448 - `BetaToolChangeToolReference object`

75017449

75027450 Reference to a single tool the caller declared directly in

from line 8321

83738321

83748322 - `enabled: optional boolean or null`

83758323

8376 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member

8324 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.

8325

8326 - `double_click: optional BetaBrowserDoubleClickConfig or null`

8327

8328 `double_click`'s config overrides.

8329

8330 - `defer_loading: optional boolean or null`

8331

8332 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.

8333

8334 - `enabled: optional boolean or null`

8335

8336 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.

8337

8338 - `file_upload: optional BetaBrowserFileUploadConfig or null`

8339

8340 `file_upload`'s config overrides.

8341

8342 - `defer_loading: optional boolean or null`

8343

8344 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.

8345

8346 - `enabled: optional boolean or null`

8347

8348 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.

8349

8350 - `find: optional BetaBrowserFindConfig or null`

8351

8352 `find`'s config overrides.

8353

8354 - `defer_loading: optional boolean or null`

8355

8356 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.

8357

8358 - `enabled: optional boolean or null`

8359

8360 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.

8361

8362 - `form_input: optional BetaBrowserFormInputConfig or null`

8363

8364 `form_input`'s config overrides.

8365

8366 - `defer_loading: optional boolean or null`

8367

8368 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.

8369

8370 - `enabled: optional boolean or null`

8371

8372 Whether this member is offered to the model. Default is per member, per the toolset's documentation

api/beta/messages/batches Changed · +0 / -60 lines

This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.

from line 551

551551

552552 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

553553

554 Tool invocation directly from the model.

555

556554 - `BetaDirectCaller object`

557555

558556 Tool invocation directly from the model.

from line 806

808806

809807 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

810808

811 Tool invocation directly from the model.

812

813809 - `BetaDirectCaller object`

814810

815811 Tool invocation directly from the model.

from line 862

866862

867863 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

868864

869 Tool invocation directly from the model.

870

871865 - `BetaDirectCaller object`

872866

873867 Tool invocation directly from the model.

from line 928

934928

935929 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

936930

937 Tool invocation directly from the model.

938

939931 - `BetaDirectCaller object`

940932

941933 Tool invocation directly from the model.

from line 996

1004996

1005997 - `content: BetaCodeExecutionToolResultBlockParamContent`

1006998

1007 Code execution result with encrypted stdout for PFC + web_search results.

1008

1009999 - `BetaCodeExecutionToolResultErrorParam object`

10101000

10111001 - `type: "code_execution_tool_result_error"`

from line 1317

13271317

13281318 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`

13291319

1330 Reference to a single tool the caller declared directly in

1331 `tools[]`. Does not accept the composed `{server}_{name}` form the

1332 server assigns to MCP-resolved tools — use `mcp_tool_reference` or

1333 `mcp_toolset_reference` for those.

1334

13351320 - `BetaToolChangeToolReference object`

13361321

13371322 Reference to a single tool the caller declared directly in

from line 1365

13801365

13811366 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`

13821367

1383 Reference to a single tool the caller declared directly in

1384 `tools[]`. Does not accept the composed `{server}_{name}` form the

1385 server assigns to MCP-resolved tools — use `mcp_tool_reference` or

1386 `mcp_toolset_reference` for those.

1387

13881368 - `BetaToolChangeToolReference object`

13891369

13901370 Reference to a single tool the caller declared directly in

from line 5502

55225502

55235503 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

55245504

5525 Tool invocation directly from the model.

5526

55275505 - `BetaDirectCaller object`

55285506

55295507 Tool invocation directly from the model.

from line 5564

55865564

55875565 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

55885566

5589 Tool invocation directly from the model.

5590

55915567 - `BetaDirectCaller object`

55925568

55935569 Tool invocation directly from the model.

from line 5622

56465622

56475623 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

56485624

5649 Tool invocation directly from the model.

5650

56515625 - `BetaDirectCaller object`

56525626

56535627 Tool invocation directly from the model.

from line 5726

57525726

57535727 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

57545728

5755 Tool invocation directly from the model.

5756

57575729 - `BetaDirectCaller object`

57585730

57595731 Tool invocation directly from the model.

from line 5804

58325804

58335805 - `content: BetaCodeExecutionToolResultBlockContent`

58345806

5835 Code execution result with encrypted stdout for PFC + web_search results.

5836

58375807 - `BetaCodeExecutionToolResultError object`

58385808

58395809 - `type: "code_execution_tool_result_error"`

from line 7619

76497619

76507620 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

76517621

7652 Tool invocation directly from the model.

7653

76547622 - `BetaDirectCaller object`

76557623

76567624 Tool invocation directly from the model.

from line 7681

77137681

77147682 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

77157683

7716 Tool invocation directly from the model.

7717

77187684 - `BetaDirectCaller object`

77197685

77207686 Tool invocation directly from the model.

from line 7739

77737739

77747740 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

77757741

7776 Tool invocation directly from the model.

7777

77787742 - `BetaDirectCaller object`

77797743

77807744 Tool invocation directly from the model.

from line 7843

78797843

78807844 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

78817845

7882 Tool invocation directly from the model.

7883

78847846 - `BetaDirectCaller object`

78857847

78867848 Tool invocation directly from the model.

from line 7921

79597921

79607922 - `content: BetaCodeExecutionToolResultBlockContent`

79617923

7962 Code execution result with encrypted stdout for PFC + web_search results.

7963

79647924 - `BetaCodeExecutionToolResultError object`

79657925

79667926 - `type: "code_execution_tool_result_error"`

from line 8315

83558315

83568316 Powerful intelligence for long-running agents and coding

83578317

8358

8318 - `"claude-sonnet-4-6"`

8319

8320 Best combination of speed and intelligence

8321

8322 - `"claude-haiku-4-5"`

8323

8324 Fastest model with near-frontier intelligence

8325

8326 - `"claude-haiku-4-5-20251001"`

8327

8328 Fastest model with near-frontier intelligence

8329

8330 - `"claude-opus-4-5"`

8331

8332 Powerful intelligence for long-running agents and coding

8333

8334 - `"claude-opus-4-5-20251101"`

8335

8336 Powerful intelligence for long-running agents and coding

8337

8338 - `"claude-sonnet-4-5"`

8339

8340 High-performance model for agents and coding

8341

8342 - `"claude-sonnet-4-5-20250929"`

8343

8344 High-performance model for agents and coding

8345

8346 - `string`

8347

8348 - `to: BetaFallbackInfo`

8349

8350 The fallback model producing the content that follows this block. Its `model` is always the canonical id.

8351

8352 - `trigger: BetaFallbackRefusalTrigger`

8353

8354 What caused the `from` model to hand over at this hop.

8355

8356 - `type: "refusal"`

8357

8358 default: refusal

8359

8360 - `category: "cyber" or "bio" or "frontier_llm" or 2 more or null`

8361

8362 The policy category that triggered a refusal.

8363

8364 - `"cyber"`

8365

8366 The request could enable cyber harm, such as malware or exploit development. Benign cybersecurity work can also trigger this category.

8367

8368

api/beta/messages/batches/create Changed · +0 / -20 lines

from line 549

549549

550550 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

551551

552 Tool invocation directly from the model.

553

554552 - `BetaDirectCaller object`

555553

556554 Tool invocation directly from the model.

from line 804

806804

807805 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

808806

809 Tool invocation directly from the model.

810

811807 - `BetaDirectCaller object`

812808

813809 Tool invocation directly from the model.

from line 860

864860

865861 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

866862

867 Tool invocation directly from the model.

868

869863 - `BetaDirectCaller object`

870864

871865 Tool invocation directly from the model.

from line 926

932926

933927 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

934928

935 Tool invocation directly from the model.

936

937929 - `BetaDirectCaller object`

938930

939931 Tool invocation directly from the model.

from line 994

1002994

1003995 - `content: BetaCodeExecutionToolResultBlockParamContent`

1004996

1005 Code execution result with encrypted stdout for PFC + web_search results.

1006

1007997 - `BetaCodeExecutionToolResultErrorParam object`

1008998

1009999 - `type: "code_execution_tool_result_error"`

from line 1315

13251315

13261316 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`

13271317

1328 Reference to a single tool the caller declared directly in

1329 `tools[]`. Does not accept the composed `{server}_{name}` form the

1330 server assigns to MCP-resolved tools — use `mcp_tool_reference` or

1331 `mcp_toolset_reference` for those.

1332

13331318 - `BetaToolChangeToolReference object`

13341319

13351320 Reference to a single tool the caller declared directly in

from line 1362

13771362 - `type: "tool_removal"`

13781363

13791364 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`

1380

1381 Reference to a single tool the caller declared directly in

1382 `tools[]`. Does not accept the composed `{server}_{name}` form the

1383 server assigns to MCP-resolved tools — use `mcp_tool_reference` or

1384 `mcp_toolset_reference` for those.

13851365

13861366 - `BetaToolChangeToolReference object`

13871367

api/beta/messages/batches/results Changed · +0 / -10 lines

from line 422

422422

423423 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

424424

425 Tool invocation directly from the model.

426

427425 - `BetaDirectCaller object`

428426

429427 Tool invocation directly from the model.

from line 484

486484

487485 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

488486

489 Tool invocation directly from the model.

490

491487 - `BetaDirectCaller object`

492488

493489 Tool invocation directly from the model.

from line 542

546542

547543 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

548544

549 Tool invocation directly from the model.

550

551545 - `BetaDirectCaller object`

552546

553547 Tool invocation directly from the model.

from line 646

652646

653647 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

654648

655 Tool invocation directly from the model.

656

657649 - `BetaDirectCaller object`

658650

659651 Tool invocation directly from the model.

from line 723

731723 default: code_execution_tool_result

732724

733725 - `content: BetaCodeExecutionToolResultBlockContent`

734

735 Code execution result with encrypted stdout for PFC + web_search results.

736726

737727 - `BetaCodeExecutionToolResultError object`

738728

api/beta/messages/count_tokens Changed · +0 / -20 lines

from line 517

517517

518518 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

519519

520 Tool invocation directly from the model.

521

522520 - `BetaDirectCaller object`

523521

524522 Tool invocation directly from the model.

from line 772

774772

775773 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

776774

777 Tool invocation directly from the model.

778

779775 - `BetaDirectCaller object`

780776

781777 Tool invocation directly from the model.

from line 828

832828

833829 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

834830

835 Tool invocation directly from the model.

836

837831 - `BetaDirectCaller object`

838832

839833 Tool invocation directly from the model.

from line 894

900894

901895 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

902896

903 Tool invocation directly from the model.

904

905897 - `BetaDirectCaller object`

906898

907899 Tool invocation directly from the model.

from line 962

970962

971963 - `content: BetaCodeExecutionToolResultBlockParamContent`

972964

973 Code execution result with encrypted stdout for PFC + web_search results.

974

975965 - `BetaCodeExecutionToolResultErrorParam object`

976966

977967 - `type: "code_execution_tool_result_error"`

from line 1283

12931283

12941284 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`

12951285

1296 Reference to a single tool the caller declared directly in

1297 `tools[]`. Does not accept the composed `{server}_{name}` form the

1298 server assigns to MCP-resolved tools — use `mcp_tool_reference` or

1299 `mcp_toolset_reference` for those.

1300

13011286 - `BetaToolChangeToolReference object`

13021287

13031288 Reference to a single tool the caller declared directly in

from line 1330

13451330 - `type: "tool_removal"`

13461331

13471332 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`

1348

1349 Reference to a single tool the caller declared directly in

1350 `tools[]`. Does not accept the composed `{server}_{name}` form the

1351 server assigns to MCP-resolved tools — use `mcp_tool_reference` or

1352 `mcp_toolset_reference` for those.

13531333

13541334 - `BetaToolChangeToolReference object`

13551335

api/beta/messages/create Changed · +0 / -32 lines

from line 529

529529

530530 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

531531

532 Tool invocation directly from the model.

533

534532 - `BetaDirectCaller object`

535533

536534 Tool invocation directly from the model.

from line 784

786784

787785 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

788786

789 Tool invocation directly from the model.

790

791787 - `BetaDirectCaller object`

792788

793789 Tool invocation directly from the model.

from line 840

844840

845841 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

846842

847 Tool invocation directly from the model.

848

849843 - `BetaDirectCaller object`

850844

851845 Tool invocation directly from the model.

from line 906

912906

913907 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

914908

915 Tool invocation directly from the model.

916

917909 - `BetaDirectCaller object`

918910

919911 Tool invocation directly from the model.

from line 974

982974

983975 - `content: BetaCodeExecutionToolResultBlockParamContent`

984976

985 Code execution result with encrypted stdout for PFC + web_search results.

986

987977 - `BetaCodeExecutionToolResultErrorParam object`

988978

989979 - `type: "code_execution_tool_result_error"`

from line 1295

13051295

13061296 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`

13071297

1308 Reference to a single tool the caller declared directly in

1309 `tools[]`. Does not accept the composed `{server}_{name}` form the

1310 server assigns to MCP-resolved tools — use `mcp_tool_reference` or

1311 `mcp_toolset_reference` for those.

1312

13131298 - `BetaToolChangeToolReference object`

13141299

13151300 Reference to a single tool the caller declared directly in

from line 1343

13581343

13591344 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`

13601345

1361 Reference to a single tool the caller declared directly in

1362 `tools[]`. Does not accept the composed `{server}_{name}` form the

1363 server assigns to MCP-resolved tools — use `mcp_tool_reference` or

1364 `mcp_toolset_reference` for those.

1365

13661346 - `BetaToolChangeToolReference object`

13671347

13681348 Reference to a single tool the caller declared directly in

from line 4219

42394219

42404220 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

42414221

4242 Tool invocation directly from the model.

4243

42444222 - `BetaDirectCaller object`

42454223

42464224 Tool invocation directly from the model.

from line 4281

43034281

43044282 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

43054283

4306 Tool invocation directly from the model.

4307

43084284 - `BetaDirectCaller object`

43094285

43104286 Tool invocation directly from the model.

from line 4339

43634339

43644340 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

43654341

4366 Tool invocation directly from the model.

4367

43684342 - `BetaDirectCaller object`

43694343

43704344 Tool invocation directly from the model.

from line 4443

44694443

44704444 - `caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120`

44714445

4472 Tool invocation directly from the model.

4473

44744446 - `BetaDirectCaller object`

44754447

44764448 Tool invocation directly from the model.

from line 4521

45494521

45504522 - `content: BetaCodeExecutionToolResultBlockContent`

45514523

4552 Code execution result with encrypted stdout for PFC + web_search results.

4553

45544524 - `BetaCodeExecutionToolResultError object`

45554525

45564526 - `type: "code_execution_tool_result_error"`

from line 5812

58425812 default: content_block_start

58435813

58445814 - `content_block: BetaTextBlock or BetaThinkingBlock or BetaRedactedThinkingBlock or 14 more`

5845

5846 Response model for a file uploaded to the container.

58475815

58485816 - `BetaTextBlock object`

58495817

api/beta/organization Changed · +0 / -26 lines

This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.

Nothing in the body moved in this read. What changed is above.

api/beta/organization/spend_limits Changed · +0 / -28 lines

from line 458

458458

459459 - `source: object or object or object or 2 more`

460460

461 Scope selecting a single member of the organization.

462

463461 - `User object`

464462

465463 Scope selecting a single member of the organization.

from line 716

718716

719717 - `source: object or object or object or 2 more`

720718

721 Scope selecting a single member of the organization.

722

723719 - `User object`

724720

725721 Scope selecting a single member of the organization.

from line 865

869865

870866 - `resolved_by: object or object or null`

871867

872 A user within the organization. `name` and `email_address` are

873 null when the underlying account is unavailable or has been deleted;

874 `deleted` is true only for deleted accounts.

875

876868 - `UserActor object`

877869

878870 A user within the organization. `name` and `email_address` are

from line 977

985977

986978 - `source: object or object or object or 2 more`

987979

988 Scope selecting a single member of the organization.

989

990980 - `User object`

991981

992982 Scope selecting a single member of the organization.

from line 1168

11781168

11791169 - `resolved_by: object or object or null`

11801170

1181 A user within the organization. `name` and `email_address` are

1182 null when the underlying account is unavailable or has been deleted;

1183 `deleted` is true only for deleted accounts.

1184

11851171 - `UserActor object`

11861172

11871173 A user within the organization. `name` and `email_address` are

from line 1280

12941280

12951281 - `source: object or object or object or 2 more`

12961282

1297 Scope selecting a single member of the organization.

1298

12991283 - `User object`

13001284

13011285 Scope selecting a single member of the organization.

from line 1480

14961480

14971481- `resolved_by: object or object or null`

14981482

1499 A user within the organization. `name` and `email_address` are

1500 null when the underlying account is unavailable or has been deleted;

1501 `deleted` is true only for deleted accounts.

1502

15031483 - `UserActor object`

15041484

15051485 A user within the organization. `name` and `email_address` are

from line 1684

17041684

17051685 - `source: object or object or object or 2 more`

17061686

1707 Scope selecting a single member of the organization.

1708

17091687 - `User object`

17101688

17111689 Scope selecting a single member of the organization.

from line 1890

19121890

19131891 - `resolved_by: object or object or null`

19141892

1915 A user within the organization. `name` and `email_address` are

1916 null when the underlying account is unavailable or has been deleted;

1917 `deleted` is true only for deleted accounts.

1918

19191893 - `UserActor object`

19201894

19211895 A user within the organization. `name` and `email_address` are

from line 2001

20272001 Tagged ID of the member the spend limit applies to.

20282002

20292003 - `source: object or object or object or 2 more`

2030

2031 Scope selecting a single member of the organization.

20322004

20332005 - `User object`

20342006

api/beta/organization/spend_limits/increase_requests Changed · +312 / -348 lines

from line 96

9696

9797 - `resolved_by: object or object or null`

9898

99 A user within the organization. `name` and `email_address` are

100 null when the underlying account is unavailable or has been deleted;

101 `deleted` is true only for deleted accounts.

102

10399 - `UserActor object`

104100

105101 A user within the organization. `name` and `email_address` are

from line 208

212208

213209 - `source: object or object or object or 2 more`

214210

215 Scope selecting a single member of the organization.

216

217211 - `User object`

218212

219213 Scope selecting a single member of the organization.

from line 399

405399

406400 - `resolved_by: object or object or null`

407401

408 A user within the organization. `name` and `email_address` are

409 null when the underlying account is unavailable or has been deleted;

410 `deleted` is true only for deleted accounts.

411

412402 - `UserActor object`

413403

414404 A user within the organization. `name` and `email_address` are

from line 511

521511

522512 - `source: object or object or object or 2 more`

523513

524 Scope selecting a single member of the organization.

525

526514 - `User object`

527515

528516 Scope selecting a single member of the organization.

from line 711

723711

724712- `resolved_by: object or object or null`

725713

726 A user within the organization. `name` and `email_address` are

727 null when the underlying account is unavailable or has been deleted;

728 `deleted` is true only for deleted accounts.

729

730714 - `UserActor object`

731715

732716 A user within the organization. `name` and `email_address` are

from line 915

931915

932916 - `source: object or object or object or 2 more`

933917

934 Scope selecting a single member of the organization.

935

936918 - `User object`

937919

938920 Scope selecting a single member of the organization.

from line 1121

11391121

11401122 - `resolved_by: object or object or null`

11411123

1142 A user within the organization. `name` and `email_address` are

1143 null when the underlying account is unavailable or has been deleted;

1144 `deleted` is true only for deleted accounts.

1145

11461124 - `UserActor object`

11471125

11481126 A user within the organization. `name` and `email_address` are

from line 1233

12551233

12561234 - `source: object or object or object or 2 more`

12571235

1258 Scope selecting a single member of the organization.

1259

12601236 - `User object`

12611237

12621238 Scope selecting a single member of the organization.

from line 1406

14301406

14311407 - `resolved_by: object or object or null`

14321408

1433 A user within the organization. `name` and `email_address` are

1434 null when the underlying account is unavailable or has been deleted;

1435 `deleted` is true only for deleted accounts.

1436

14371409 - `UserActor object`

14381410

14391411 A user within the organization. `name` and `email_address` are

from line 1518

15461518

15471519 - `source: object or object or object or 2 more`

15481520

1549 Scope selecting a single member of the organization.

1550

15511521 - `User object`

15521522

15531523 Scope selecting a single member of the organization.

from line 1630

16601630

16611631 - `resolved_by: object or object or null`

16621632

1663 A user within the organization. `name` and `email_address` are

1664 null when the underlying account is unavailable or has been deleted;

1665 `deleted` is true only for deleted accounts.

1666

16671633 - `UserActor object`

16681634

16691635 A user within the organization. `name` and `email_address` are

from line 1833

18671833 Tagged ID of the member the spend limit applies to.

18681834

18691835 - `source: object or object or object or 2 more`

1870

1871 Scope selecting a single member of the organization.

18721836

18731837 - `User object`

18741838

api/beta/organization/spend_limits/increase_requests/approve Changed · +0 / -6 lines

from line 92

9292

9393- `resolved_by: object or object or null`

9494

95 A user within the organization. `name` and `email_address` are

96 null when the underlying account is unavailable or has been deleted;

97 `deleted` is true only for deleted accounts.

98

9995 - `UserActor object`

10096

10197 A user within the organization. `name` and `email_address` are

from line 295

299295 Tagged ID of the member the spend limit applies to.

300296

301297 - `source: object or object or object or 2 more`

302

303 Scope selecting a single member of the organization.

304298

305299 - `User object`

306300

api/beta/organization/spend_limits/increase_requests/deny Changed · +0 / -6 lines

from line 80

8080

8181 - `resolved_by: object or object or null`

8282

83 A user within the organization. `name` and `email_address` are

84 null when the underlying account is unavailable or has been deleted;

85 `deleted` is true only for deleted accounts.

86

8783 - `UserActor object`

8884

8985 A user within the organization. `name` and `email_address` are

from line 191

195191 Tagged ID of the member the spend limit applies to.

196192

197193 - `source: object or object or object or 2 more`

198

199 Scope selecting a single member of the organization.

200194

201195 - `User object`

202196

api/beta/organization/spend_limits/increase_requests/list Changed · +0 / -6 lines

from line 94

9494

9595 - `resolved_by: object or object or null`

9696

97 A user within the organization. `name` and `email_address` are

98 null when the underlying account is unavailable or has been deleted;

99 `deleted` is true only for deleted accounts.

100

10197 - `UserActor object`

10298

10399 A user within the organization. `name` and `email_address` are

from line 205

209205 Tagged ID of the member the spend limit applies to.

210206

211207 - `source: object or object or object or 2 more`

212

213 Scope selecting a single member of the organization.

214208

215209 - `User object`

216210

api/beta/organization/spend_limits/increase_requests/retrieve Changed · +0 / -6 lines

from line 76

7676

7777 - `resolved_by: object or object or null`

7878

79 A user within the organization. `name` and `email_address` are

80 null when the underlying account is unavailable or has been deleted;

81 `deleted` is true only for deleted accounts.

82

8379 - `UserActor object`

8480

8581 A user within the organization. `name` and `email_address` are

from line 187

191187 Tagged ID of the member the spend limit applies to.

192188

193189 - `source: object or object or object or 2 more`

194

195 Scope selecting a single member of the organization.

196190

197191 - `User object`

198192

api/beta/sessions Changed · +0 / -24 lines

This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.

Nothing in the body moved in this read. What changed is above.

api/beta/sessions/events Changed · +4090 / -4120 lines

This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.

from line 893

893893

894894 - `error: BetaManagedAgentsUnknownError or BetaManagedAgentsModelOverloadedError or BetaManagedAgentsModelRateLimitedError or 5 more`

895895

896 An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone.

897

898896 - `BetaManagedAgentsUnknownError object`

899897

900898 An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone.

from line 1179

11811179

11821180 - `stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted or BetaManagedAgentsSessionBudgetReached`

11831181

1184 The agent completed its turn naturally and is ready for the next user message.

1185

11861182 - `BetaManagedAgentsSessionEndTurn object`

11871183

11881184 The agent completed its turn naturally and is ready for the next user message.

from line 1537

15411537

15421538 - `stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted or BetaManagedAgentsSessionBudgetReached`

15431539

1544 The agent completed its turn naturally and is ready for the next user message.

1545

15461540 - `BetaManagedAgentsSessionEndTurn object`

15471541

15481542 The agent completed its turn naturally and is ready for the next user message.

from line 4257

42634257

42644258 - `error: BetaManagedAgentsUnknownError or BetaManagedAgentsModelOverloadedError or BetaManagedAgentsModelRateLimitedError or 5 more`

42654259

4266 An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone.

4267

42684260 - `BetaManagedAgentsUnknownError object`

42694261

42704262 An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone.

from line 4543

45514543

45524544 - `stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted or BetaManagedAgentsSessionBudgetReached`

45534545

4554 The agent completed its turn naturally and is ready for the next user message.

4555

45564546 - `BetaManagedAgentsSessionEndTurn object`

45574547

45584548 The agent completed its turn naturally and is ready for the next user message.

from line 4901

49114901

49124902 - `stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted or BetaManagedAgentsSessionBudgetReached`

49134903

4914 The agent completed its turn naturally and is ready for the next user message.

4915

49164904 - `BetaManagedAgentsSessionEndTurn object`

49174905

49184906 The agent completed its turn naturally and is ready for the next user message.

from line 8548

85608548

85618549 - `error: BetaManagedAgentsUnknownError or BetaManagedAgentsModelOverloadedError or BetaManagedAgentsModelRateLimitedError or 5 more`

85628550

8563 An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone.

8564

85658551 - `BetaManagedAgentsUnknownError object`

85668552

85678553 An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone.

from line 8996

90108996

90118997 - `tool_use_id: string`

90128998

9013 The id of the `agent.tool_use` or `agent.mcp_tool_use` event this result corresponds to, which can be found in the last `session.status_idle` [event's](https://platform.claude.com/docs/e

8999 The id of the `agent.tool_use` or `agent.mcp_tool_use` event this 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.event_ids) `stop_reason.event_ids` field.

9000

9001 - `deny_message: optional string or null`

9002

9003 Optional message providing context for a 'deny' decision. Only allowed when result is 'deny'.

9004

9005 maxLength: 10000

9006

9007 - `processed_at: optional string or null`

9008

9009 A timestamp in RFC 3339 format

9010

9011 format: date-time

9012

9013 - `session_thread_id: optional string or null`

9014

9015 When set, the confirmation routes to this subagent's thread rather than the primary. Echo this from the `session_thread_id` on the `agent.tool_use` or `agent.mcp_tool_use` event that prompted the approval.

9016

9017 - `BetaManagedAgentsUserCustomToolResultEvent object`

9018

9019 Event sent by the client providing the result of a custom tool execution.

9020

9021 - `type: "user.custom_tool_result"`

9022

9023 - `id: string`

9024

9025 Unique identifier for this event.

9026

9027

api/beta/sessions/events/list Changed · +0 / -6 lines

from line 891

891891

892892 - `error: BetaManagedAgentsUnknownError or BetaManagedAgentsModelOverloadedError or BetaManagedAgentsModelRateLimitedError or 5 more`

893893

894 An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone.

895

896894 - `BetaManagedAgentsUnknownError object`

897895

898896 An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone.

from line 1177

11791177

11801178 - `stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted or BetaManagedAgentsSessionBudgetReached`

11811179

1182 The agent completed its turn naturally and is ready for the next user message.

1183

11841180 - `BetaManagedAgentsSessionEndTurn object`

11851181

11861182 The agent completed its turn naturally and is ready for the next user message.

from line 1534

15381534 Public sthr_ ID of the thread that went idle.

15391535

15401536 - `stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted or BetaManagedAgentsSessionBudgetReached`

1541

1542 The agent completed its turn naturally and is ready for the next user message.

15431537

15441538 - `BetaManagedAgentsSessionEndTurn object`

15451539

api/beta/sessions/events/stream Changed · +0 / -6 lines

from line 853

853853

854854 - `error: BetaManagedAgentsUnknownError or BetaManagedAgentsModelOverloadedError or BetaManagedAgentsModelRateLimitedError or 5 more`

855855

856 An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone.

857

858856 - `BetaManagedAgentsUnknownError object`

859857

860858 An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone.

from line 1139

11411139

11421140 - `stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted or BetaManagedAgentsSessionBudgetReached`

11431141

1144 The agent completed its turn naturally and is ready for the next user message.

1145

11461142 - `BetaManagedAgentsSessionEndTurn object`

11471143

11481144 The agent completed its turn naturally and is ready for the next user message.

from line 1496

15001496 Public sthr_ ID of the thread that went idle.

15011497

15021498 - `stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted or BetaManagedAgentsSessionBudgetReached`

1503

1504 The agent completed its turn naturally and is ready for the next user message.

15051499

15061500 - `BetaManagedAgentsSessionEndTurn object`

15071501

api/beta/sessions/threads Changed · +0 / -18 lines

This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.

from line 4231

42314231

42324232 - `error: BetaManagedAgentsUnknownError or BetaManagedAgentsModelOverloadedError or BetaManagedAgentsModelRateLimitedError or 5 more`

42334233

4234 An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone.

4235

42364234 - `BetaManagedAgentsUnknownError object`

42374235

42384236 An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone.

from line 4517

45194517

45204518 - `stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted or BetaManagedAgentsSessionBudgetReached`

45214519

4522 The agent completed its turn naturally and is ready for the next user message.

4523

45244520 - `BetaManagedAgentsSessionEndTurn object`

45254521

45264522 The agent completed its turn naturally and is ready for the next user message.

from line 4875

48794875

48804876 - `stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted or BetaManagedAgentsSessionBudgetReached`

48814877

4882 The agent completed its turn naturally and is ready for the next user message.

4883

48844878 - `BetaManagedAgentsSessionEndTurn object`

48854879

48864880 The agent completed its turn naturally and is ready for the next user message.

from line 6643

66496643

66506644 - `error: BetaManagedAgentsUnknownError or BetaManagedAgentsModelOverloadedError or BetaManagedAgentsModelRateLimitedError or 5 more`

66516645

6652 An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone.

6653

66546646 - `BetaManagedAgentsUnknownError object`

66556647

66566648 An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone.

from line 6929

69376929

69386930 - `stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted or BetaManagedAgentsSessionBudgetReached`

69396931

6940 The agent completed its turn naturally and is ready for the next user message.

6941

69426932 - `BetaManagedAgentsSessionEndTurn object`

69436933

69446934 The agent completed its turn naturally and is ready for the next user message.

from line 7287

72977287

72987288 - `stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted or BetaManagedAgentsSessionBudgetReached`

72997289

7300 The agent completed its turn naturally and is ready for the next user message.

7301

73027290 - `BetaManagedAgentsSessionEndTurn object`

73037291

73047292 The agent completed its turn naturally and is ready for the next user message.

from line 8559

85718559

85728560 - `BetaManagedAgentsImageBlock object`

85738561

8574 Image content specified direct

8562 Image content specified directly as base64 data or as a reference via a URL.

8563

8564 - `BetaManagedAgentsDocumentBlock object`

8565

8566 Document content, either specified directly as base64 data, as text, or as a reference via a URL.

8567

8568 - `BetaManagedAgentsSearchResultBlock object`

8569

8570 A block containing a web search result.

8571

8572 - `type: "search_result"`

8573

8574 - `citations: BetaManagedAgentsSearchResultCitations`

8575

8576 Citation settings for a search result.

8577

8578 - `enabled: boolean`

8579

8580 Whether citations are enabled for this search result.

8581

8582 - `content: array of BetaManagedAgentsSearchResultContent`

8583

8584 Array of text content blocks from the search result.

8585

8586 - `type: "text"`

8587

8588

api/beta/sessions/threads/events Changed · +0 / -12 lines

from line 859

859859

860860 - `error: BetaManagedAgentsUnknownError or BetaManagedAgentsModelOverloadedError or BetaManagedAgentsModelRateLimitedError or 5 more`

861861

862 An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone.

863

864862 - `BetaManagedAgentsUnknownError object`

865863

866864 An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone.

from line 1145

11471145

11481146 - `stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted or BetaManagedAgentsSessionBudgetReached`

11491147

1150 The agent completed its turn naturally and is ready for the next user message.

1151

11521148 - `BetaManagedAgentsSessionEndTurn object`

11531149

11541150 The agent completed its turn naturally and is ready for the next user message.

from line 1503

15071503

15081504 - `stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted or BetaManagedAgentsSessionBudgetReached`

15091505

1510 The agent completed its turn naturally and is ready for the next user message.

1511

15121506 - `BetaManagedAgentsSessionEndTurn object`

15131507

15141508 The agent completed its turn naturally and is ready for the next user message.

from line 3249

32553249

32563250 - `error: BetaManagedAgentsUnknownError or BetaManagedAgentsModelOverloadedError or BetaManagedAgentsModelRateLimitedError or 5 more`

32573251

3258 An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone.

3259

32603252 - `BetaManagedAgentsUnknownError object`

32613253

32623254 An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone.

from line 3535

35433535

35443536 - `stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted or BetaManagedAgentsSessionBudgetReached`

35453537

3546 The agent completed its turn naturally and is ready for the next user message.

3547

35483538 - `BetaManagedAgentsSessionEndTurn object`

35493539

35503540 The agent completed its turn naturally and is ready for the next user message.

from line 3892

39023892 Public sthr_ ID of the thread that went idle.

39033893

39043894 - `stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted or BetaManagedAgentsSessionBudgetReached`

3905

3906 The agent completed its turn naturally and is ready for the next user message.

39073895

39083896 - `BetaManagedAgentsSessionEndTurn object`

39093897

api/beta/sessions/threads/events/list Changed · +0 / -6 lines

from line 857

857857

858858 - `error: BetaManagedAgentsUnknownError or BetaManagedAgentsModelOverloadedError or BetaManagedAgentsModelRateLimitedError or 5 more`

859859

860 An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone.

861

862860 - `BetaManagedAgentsUnknownError object`

863861

864862 An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone.

from line 1143

11451143

11461144 - `stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted or BetaManagedAgentsSessionBudgetReached`

11471145

1148 The agent completed its turn naturally and is ready for the next user message.

1149

11501146 - `BetaManagedAgentsSessionEndTurn object`

11511147

11521148 The agent completed its turn naturally and is ready for the next user message.

from line 1500

15041500 Public sthr_ ID of the thread that went idle.

15051501

15061502 - `stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted or BetaManagedAgentsSessionBudgetReached`

1507

1508 The agent completed its turn naturally and is ready for the next user message.

15091503

15101504 - `BetaManagedAgentsSessionEndTurn object`

15111505

api/beta/sessions/threads/events/stream Changed · +0 / -6 lines

from line 855

855855

856856 - `error: BetaManagedAgentsUnknownError or BetaManagedAgentsModelOverloadedError or BetaManagedAgentsModelRateLimitedError or 5 more`

857857

858 An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone.

859

860858 - `BetaManagedAgentsUnknownError object`

861859

862860 An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone.

from line 1141

11431141

11441142 - `stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted or BetaManagedAgentsSessionBudgetReached`

11451143

1146 The agent completed its turn naturally and is ready for the next user message.

1147

11481144 - `BetaManagedAgentsSessionEndTurn object`

11491145

11501146 The agent completed its turn naturally and is ready for the next user message.

from line 1498

15021498 Public sthr_ ID of the thread that went idle.

15031499

15041500 - `stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted or BetaManagedAgentsSessionBudgetReached`

1505

1506 The agent completed its turn naturally and is ready for the next user message.

15071501

15081502 - `BetaManagedAgentsSessionEndTurn object`

15091503

One read of Claude Developer Platform

What this read moved

agents-and-tools/tool-use/browser-use-tool Changed · +13 / -7 lines

api/beta Changed · +0 / -160 lines

api/beta/dreams Changed · +361 / -383 lines

api/beta/dreams/create Changed · +0 / -6 lines

api/beta/messages Changed · +109 / -333 lines

api/beta/messages/batches Changed · +0 / -60 lines

api/beta/messages/batches/create Changed · +0 / -20 lines

api/beta/messages/batches/results Changed · +0 / -10 lines

api/beta/messages/count_tokens Changed · +0 / -20 lines

api/beta/messages/create Changed · +0 / -32 lines

api/beta/organization Changed · +0 / -26 lines

api/beta/organization/spend_limits Changed · +0 / -28 lines

api/beta/organization/spend_limits/increase_requests Changed · +312 / -348 lines

api/beta/organization/spend_limits/increase_requests/approve Changed · +0 / -6 lines

api/beta/organization/spend_limits/increase_requests/deny Changed · +0 / -6 lines

api/beta/organization/spend_limits/increase_requests/list Changed · +0 / -6 lines

api/beta/organization/spend_limits/increase_requests/retrieve Changed · +0 / -6 lines

api/beta/sessions Changed · +0 / -24 lines

api/beta/sessions/events Changed · +4090 / -4120 lines

api/beta/sessions/events/list Changed · +0 / -6 lines

api/beta/sessions/events/stream Changed · +0 / -6 lines

api/beta/sessions/threads Changed · +0 / -18 lines

api/beta/sessions/threads/events Changed · +0 / -12 lines

api/beta/sessions/threads/events/list Changed · +0 / -6 lines

api/beta/sessions/threads/events/stream Changed · +0 / -6 lines