One read of Claude Developer Platformapi-20260820T170710Z
229 pages moved out of 583 read.
Pages moved
229
significant first
Pages read
583
in this capture
Captured
17:07 UTC
Corpus hash
9cf0330dc487
corpus-hash
What this read moved
76-100 of 229, page 4 of 10This capture is too large to show at once. Changes 76-100 of 229 are below, significant first; the rest are on the following screens.
api/beta/user_profiles/list Changed · +48 / -37 lines
from line 35
3535
3636 - `string`
3737
38 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
38 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
3939
4040 - `"message-batches-2024-09-24"`
4141
from line 81
8181
8282 - `"user-profiles-2026-03-24"`
8383
84 - `"user-profiles-2026-08-18"`
85
8486 - `"advisor-tool-2026-03-01"`
8587
8688 - `"managed-agents-2026-04-01"`
from line 123
121123
122124 Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.
123125
124 - `relationship: "external" or "resold" or "internal"`
125
126 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
127
128 - `"external"`
129
130 - `"resold"`
131
132 - `"internal"`
133
134126 - `trust_grants: map[BetaUserProfileTrustGrant]`
135127
136128 Trust grants for this profile, keyed by grant name. Key omitted when no grant is active or in flight.
from line 147
155147
156148 A timestamp in RFC 3339 format
157149
150 - `access_type: optional "application" or "passthrough"`
151
152 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
153
154 - `"application"`
155
156 - `"passthrough"`
157
158158 - `external_id: optional string or null`
159159
160160 Platform's own identifier for this user. Not enforced unique.
from line 161
161161
162162 - `name: optional string or null`
163163
164 Display name of the entity this profile represents. For `resold` this is the resold-to company's name.
164 Real-world name of the entity this profile represents (company or individual). For a resold-to company (`access_type` `passthrough`, or `relationship` `resold` under the `user-profiles-2026-03-24` header) this is that company's name.
165165
166 - `relationship: optional "external" or "resold" or "internal"`
167
168 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
169
170 - `"external"`
171
172 - `"resold"`
173
174 - `"internal"`
175
166176- `next_page: string or null`
167177
168178 Cursor for the next page, or `null` when there are no more results.
from line 182
172182```http
173183curl https://api.anthropic.com/v1/user_profiles \
174184 -H 'anthropic-version: 2023-06-01' \
175 -H 'anthropic-beta: user-profiles-2026-03-24' \
185 -H 'anthropic-beta: user-profiles-2026-08-18' \
176186 -H "X-Api-Key: $ANTHROPIC_API_KEY"
177187```
178188
from line 195
185195 "id": "uprof_011CZkZCu8hGbp5mYRQgUmz9",
186196 "created_at": "2026-03-15T10:00:00Z",
187197 "metadata": {},
188 "relationship": "external",
189198 "trust_grants": {
190199 "cyber": {
191200 "status": "active"
from line 202
193202 },
194203 "type": "user_profile",
195204 "updated_at": "2026-03-15T10:00:00Z",
205 "access_type": "application",
196206 "external_id": "user_12345",
197 "name": "Example User"
207 "name": "Example User",
208 "relationship": "external"
198209 }
199210 ],
200211 "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
api/beta/user_profiles/retrieve Changed · +27 / -16 lines
from line 21
2121
2222 - `string`
2323
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2525
2626 - `"message-batches-2024-09-24"`
2727
from line 67
6767
6868 - `"user-profiles-2026-03-24"`
6969
70 - `"user-profiles-2026-08-18"`
71
7072 - `"advisor-tool-2026-03-01"`
7173
7274 - `"managed-agents-2026-04-01"`
from line 93
9193
9294### Returns
9395
94- `BetaUserProfile object { id, created_at, metadata, 6 more }`
96- `BetaUserProfile object { id, created_at, metadata, 7 more }`
9597
9698 - `id: string`
9799
from line 107
105107
106108 Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.
107109
108 - `relationship: "external" or "resold" or "internal"`
109
110 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
111
112 - `"external"`
113
114 - `"resold"`
115
116 - `"internal"`
117
118110 - `trust_grants: map[BetaUserProfileTrustGrant]`
119111
120112 Trust grants for this profile, keyed by grant name. Key omitted when no grant is active or in flight.
from line 131
139131
140132 A timestamp in RFC 3339 format
141133
134 - `access_type: optional "application" or "passthrough"`
135
136 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
137
138 - `"application"`
139
140 - `"passthrough"`
141
142142 - `external_id: optional string or null`
143143
144144 Platform's own identifier for this user. Not enforced unique.
from line 145
145145
146146 - `name: optional string or null`
147147
148 Display name of the entity this profile represents. For `resold` this is the resold-to company's name.
148 Real-world name of the entity this profile represents (company or individual). For a resold-to company (`access_type` `passthrough`, or `relationship` `resold` under the `user-profiles-2026-03-24` header) this is that company's name.
149149
150 - `relationship: optional "external" or "resold" or "internal"`
151
152 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
153
154 - `"external"`
155
156 - `"resold"`
157
158 - `"internal"`
159
150160### Example
151161
152162```http
153163curl https://api.anthropic.com/v1/user_profiles/$USER_PROFILE_ID \
154164 -H 'anthropic-version: 2023-06-01' \
155 -H 'anthropic-beta: user-profiles-2026-03-24' \
165 -H 'anthropic-beta: user-profiles-2026-08-18' \
156166 -H "X-Api-Key: $ANTHROPIC_API_KEY"
157167```
158168
from line 173
163173 "id": "uprof_011CZkZCu8hGbp5mYRQgUmz9",
164174 "created_at": "2026-03-15T10:00:00Z",
165175 "metadata": {},
166 "relationship": "external",
167176 "trust_grants": {
168177 "cyber": {
169178 "status": "active"
from line 180
171180 },
172181 "type": "user_profile",
173182 "updated_at": "2026-03-15T10:00:00Z",
183 "access_type": "application",
174184 "external_id": "user_12345",
175 "name": "Example User"
185 "name": "Example User",
186 "relationship": "external"
176187}
177188```
178189
api/beta/user_profiles/update Changed · +57 / -38 lines
from line 21
2121
2222 - `string`
2323
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2525
2626 - `"message-batches-2024-09-24"`
2727
from line 67
6767
6868 - `"user-profiles-2026-03-24"`
6969
70 - `"user-profiles-2026-08-18"`
71
7072 - `"advisor-tool-2026-03-01"`
7173
7274 - `"managed-agents-2026-04-01"`
from line 93
9193
9294### Body Parameters
9395
96- `access_type: optional "application" or "passthrough" or null`
97
98 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
99
100 - `"application"`
101
102 - `"passthrough"`
103
94104- `external_id: optional string or null`
95105
96106 If present, replaces the stored external_id. Omit to leave unchanged. Maximum 255 characters.
from line 125
115125
116126### Returns
117127
118- `BetaUserProfile object { id, created_at, metadata, 6 more }`
128- `BetaUserProfile object { id, created_at, metadata, 7 more }`
119129
120130 - `id: string`
121131
from line 139
129139
130140 Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.
131141
132 - `relationship: "external" or "resold" or "internal"`
133
134 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
135
136 - `"external"`
137
138 - `"resold"`
139
140 - `"internal"`
141
142142 - `trust_grants: map[BetaUserProfileTrustGrant]`
143143
144144 Trust grants for this profile, keyed by grant name. Key omitted when no grant is active or in flight.
from line 163
163163
164164 A timestamp in RFC 3339 format
165165
166 - `access_type: optional "application" or "passthrough"`
167
168 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
169
170 - `"application"`
171
172 - `"passthrough"`
173
166174 - `external_id: optional string or null`
167175
168176 Platform's own identifier for this user. Not enforced unique.
from line 177
169177
170178 - `name: optional string or null`
171179
172 Display name of the entity this profile represents. For `resold` this is the resold-to company's name.
180 Real-world name of the entity this profile represents (company or individual). For a resold-to company (`access_type` `passthrough`, or `relationship` `resold` under the `user-profiles-2026-03-24` header) this is that company's name.
173181
182 - `relationship: optional "external" or "resold" or "internal"`
183
184 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
185
186 - `"external"`
187
188 - `"resold"`
189
190 - `"internal"`
191
174192### Example
175193
176194```http
from line 195
177195curl https://api.anthropic.com/v1/user_profiles/$USER_PROFILE_ID \
178196 -H 'Content-Type: application/json' \
179197 -H 'anthropic-version: 2023-06-01' \
180 -H 'anthropic-beta: user-profiles-2026-03-24' \
198 -H 'anthropic-beta: user-profiles-2026-08-18' \
181199 -H "X-Api-Key: $ANTHROPIC_API_KEY" \
182200 -d '{
183201 "external_id": "user_12345"
from line 209
191209 "id": "uprof_011CZkZCu8hGbp5mYRQgUmz9",
192210 "created_at": "2026-03-15T10:00:00Z",
193211 "metadata": {},
194 "relationship": "external",
195212 "trust_grants": {
196213 "cyber": {
197214 "status": "active"
from line 216
199216 },
200217 "type": "user_profile",
201218 "updated_at": "2026-03-15T10:00:00Z",
219 "access_type": "application",
202220 "external_id": "user_12345",
203 "name": "Example User"
221 "name": "Example User",
222 "relationship": "external"
204223}
205224```
206225
api/beta/vaults Changed · +39 / -13 lines
from line 19
1919
2020 - `string`
2121
22 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
22 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2323
2424 - `"message-batches-2024-09-24"`
2525
from line 65
6565
6666 - `"user-profiles-2026-03-24"`
6767
68 - `"user-profiles-2026-08-18"`
69
6870 - `"advisor-tool-2026-03-01"`
6971
7072 - `"managed-agents-2026-04-01"`
from line 193
191193
192194 - `string`
193195
194 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
196 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
195197
196198 - `"message-batches-2024-09-24"`
197199
from line 239
237239
238240 - `"user-profiles-2026-03-24"`
239241
242 - `"user-profiles-2026-08-18"`
243
240244 - `"advisor-tool-2026-03-01"`
241245
242246 - `"managed-agents-2026-04-01"`
from line 349
345349
346350 - `string`
347351
348 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
352 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
349353
350354 - `"message-batches-2024-09-24"`
351355
from line 395
391395
392396 - `"user-profiles-2026-03-24"`
393397
398 - `"user-profiles-2026-08-18"`
399
394400 - `"advisor-tool-2026-03-01"`
395401
396402 - `"managed-agents-2026-04-01"`
from line 496
490496
491497 - `string`
492498
493 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
499 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
494500
495501 - `"message-batches-2024-09-24"`
496502
from line 542
536542
537543 - `"user-profiles-2026-03-24"`
538544
545 - `"user-profiles-2026-08-18"`
546
539547 - `"advisor-tool-2026-03-01"`
540548
541549 - `"managed-agents-2026-04-01"`
from line 660
652660
653661 - `string`
654662
655 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
663 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
656664
657665 - `"message-batches-2024-09-24"`
658666
from line 706
698706
699707 - `"user-profiles-2026-03-24"`
700708
709 - `"user-profiles-2026-08-18"`
710
701711 - `"advisor-tool-2026-03-01"`
702712
703713 - `"managed-agents-2026-04-01"`
from line 781
771781
772782 - `string`
773783
774 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
784 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
775785
776786 - `"message-batches-2024-09-24"`
777787
from line 827
817827
818828 - `"user-profiles-2026-03-24"`
819829
830 - `"user-profiles-2026-08-18"`
831
820832 - `"advisor-tool-2026-03-01"`
821833
822834 - `"managed-agents-2026-04-01"`
from line 981
969981
970982 - `string`
971983
972 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
984 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
973985
974986 - `"message-batches-2024-09-24"`
975987
from line 1027
10151027
10161028 - `"user-profiles-2026-03-24"`
10171029
1030 - `"user-profiles-2026-08-18"`
1031
10181032 - `"advisor-tool-2026-03-01"`
10191033
10201034 - `"managed-agents-2026-04-01"`
from line 1453
14391453
14401454 - `string`
14411455
1442 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
1456 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
14431457
14441458 - `"message-batches-2024-09-24"`
14451459
from line 1499
14851499
14861500 - `"user-profiles-2026-03-24"`
14871501
1502 - `"user-profiles-2026-08-18"`
1503
14881504 - `"advisor-tool-2026-03-01"`
14891505
14901506 - `"managed-agents-2026-04-01"`
from line 1748
17321748
17331749 - `string`
17341750
1735 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
1751 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
17361752
17371753 - `"message-batches-2024-09-24"`
17381754
from line 1794
17781794
17791795 - `"user-profiles-2026-03-24"`
17801796
1797 - `"user-profiles-2026-08-18"`
1798
17811799 - `"advisor-tool-2026-03-01"`
17821800
17831801 - `"managed-agents-2026-04-01"`
from line 2034
20162034
20172035 - `string`
20182036
2019 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
2037 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
20202038
20212039 - `"message-batches-2024-09-24"`
20222040
from line 2080
20622080
20632081 - `"user-profiles-2026-03-24"`
20642082
2083 - `"user-profiles-2026-08-18"`
2084
20652085 - `"advisor-tool-2026-03-01"`
20662086
20672087 - `"managed-agents-2026-04-01"`
from line 2457
24372457
24382458 - `string`
24392459
2440 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
2460 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
24412461
24422462 - `"message-batches-2024-09-24"`
24432463
from line 2503
24832503
24842504 - `"user-profiles-2026-03-24"`
24852505
2506 - `"user-profiles-2026-08-18"`
2507
24862508 - `"advisor-tool-2026-03-01"`
24872509
24882510 - `"managed-agents-2026-04-01"`
from line 2580
25582580
25592581 - `string`
25602582
2561 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
2583 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
25622584
25632585 - `"message-batches-2024-09-24"`
25642586
from line 2626
26042626
26052627 - `"user-profiles-2026-03-24"`
26062628
2629 - `"user-profiles-2026-08-18"`
2630
26072631 - `"advisor-tool-2026-03-01"`
26082632
26092633 - `"managed-agents-2026-04-01"`
from line 2867
28432867
28442868 - `string`
28452869
2846 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
2870 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
28472871
28482872 - `"message-batches-2024-09-24"`
28492873
from line 2912
28882912 - `"output-300k-2026-03-24"`
28892913
28902914 - `"user-profiles-2026-03-24"`
2915
2916 - `"user-profiles-2026-08-18"`
28912917
28922918 - `"advisor-tool-2026-03-01"`
28932919
api/beta/vaults/credentials Changed · +21 / -7 lines
from line 23
2323
2424 - `string`
2525
26 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
26 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2727
2828 - `"message-batches-2024-09-24"`
2929
from line 69
6969
7070 - `"user-profiles-2026-03-24"`
7171
72 - `"user-profiles-2026-08-18"`
73
7274 - `"advisor-tool-2026-03-01"`
7375
7476 - `"managed-agents-2026-04-01"`
from line 495
493495
494496 - `string`
495497
496 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
498 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
497499
498500 - `"message-batches-2024-09-24"`
499501
from line 541
539541
540542 - `"user-profiles-2026-03-24"`
541543
544 - `"user-profiles-2026-08-18"`
545
542546 - `"advisor-tool-2026-03-01"`
543547
544548 - `"managed-agents-2026-04-01"`
from line 790
786790
787791 - `string`
788792
789 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
793 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
790794
791795 - `"message-batches-2024-09-24"`
792796
from line 836
832836
833837 - `"user-profiles-2026-03-24"`
834838
839 - `"user-profiles-2026-08-18"`
840
835841 - `"advisor-tool-2026-03-01"`
836842
837843 - `"managed-agents-2026-04-01"`
from line 1076
10701076
10711077 - `string`
10721078
1073 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
1079 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
10741080
10751081 - `"message-batches-2024-09-24"`
10761082
from line 1122
11161122
11171123 - `"user-profiles-2026-03-24"`
11181124
1125 - `"user-profiles-2026-08-18"`
1126
11191127 - `"advisor-tool-2026-03-01"`
11201128
11211129 - `"managed-agents-2026-04-01"`
from line 1499
14911499
14921500 - `string`
14931501
1494 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
1502 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
14951503
14961504 - `"message-batches-2024-09-24"`
14971505
from line 1545
15371545
15381546 - `"user-profiles-2026-03-24"`
15391547
1548 - `"user-profiles-2026-08-18"`
1549
15401550 - `"advisor-tool-2026-03-01"`
15411551
15421552 - `"managed-agents-2026-04-01"`
from line 1622
16121622
16131623 - `string`
16141624
1615 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
1625 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
16161626
16171627 - `"message-batches-2024-09-24"`
16181628
from line 1668
16581668
16591669 - `"user-profiles-2026-03-24"`
16601670
1671 - `"user-profiles-2026-08-18"`
1672
16611673 - `"advisor-tool-2026-03-01"`
16621674
16631675 - `"managed-agents-2026-04-01"`
from line 1909
18971909
18981910 - `string`
18991911
1900 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
1912 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
19011913
19021914 - `"message-batches-2024-09-24"`
19031915
from line 1954
19421954 - `"output-300k-2026-03-24"`
19431955
19441956 - `"user-profiles-2026-03-24"`
1957
1958 - `"user-profiles-2026-08-18"`
19451959
19461960 - `"advisor-tool-2026-03-01"`
19471961
api/files New page · 380 lines, new page
# Files ## Upload File ### Returns ### Example #### Response ## List Files ### Query Parameters ### Returns ### Example #### Response ## Download File ### Path Parameters ### Example ## Get File Metadata ### Path Parameters ### Returns ### Example #### Response ## Delete File ### Path Parameters ### Returns ### Example #### Response ## Domain Types ### Deleted File ### File Metadata
A whole new page. There's nothing to diff it against, so here is what it says.
---
title: Files
url: https://platform.claude.com/docs/en/api/files
---
# Files
## Upload File
**post** `/v1/files`
Upload File
### Returns
- `FileMetadata object { id, created_at, filename, 5 more }`
- `id: string`
Unique object identifier.
The format and length of IDs may change over time.
- `created_at: string`
RFC 3339 datetime string representing when the file was created.
- `filename: string`
Original filename of the uploaded file.
- `mime_type: string`
MIME type of the file.
- `size_bytes: number`
Size of the file in bytes.
- `type: "file"`
Object type.
For files, this is always `"file"`.
- `"file"`
- `downloadable: optional boolean`
Whether the file can be downloaded.
- `expires_at: optional string or null`
RFC 3339 datetime string representing when the file will expire and become unavailable for download. Null if the file does not expire. For files uploaded with `expires_in_seconds`, this is the upload time plus that value.
### Example
```http
curl https://api.anthropic.com/v1/files \
-H 'Content-Type: multipart/form-data' \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY" \
-F 'file=@/path/to/file'
```
#### Response
```json
{
"id": "file_011CNha8iCJcU1wXNR6q4V8w",
"created_at": "2025-04-15T18:37:24.100435Z",
"filename": "document.pdf",
"mime_type": "application/pdf",
"size_bytes": 102400,
"type": "file",
"downloadable": false,
"expires_at": "2025-05-15T18:37:24.100435Z"
}
```
## List Files
**get** `/v1/files`
List Files
### Query Parameters
- `ids: optional array of string`
Restrict the result set to Files whose `id` is in this list. At most 100 entries (after de-duplication). Mutually exclusive with `page` and `limit`. When supplied, the response is always a single page (`next_page` is null). IDs that do not resolve to a visible File — including deleted Files — are silently omitted.
- `limit: optional number`
Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
- `page: optional string`
Opaque page cursor returned in a prior list response's `next_page`. Prefixed `page_`.
### Returns
- `data: array of FileMetadata`
List of file metadata objects.
- `id: string`
Unique object identifier.
The format and length of IDs may change over time.
- `created_at: string`
RFC 3339 datetime string representing when the file was created.
- `filename: string`
Original filename of the uploaded file.
- `mime_type: string`
MIME type of the file.
- `size_bytes: number`
Size of the file in bytes.
- `type: "file"`
Object type.
For files, this is always `"file"`.
- `"file"`
- `downloadable: optional boolean`
Whether the file can be downloaded.
- `expires_at: optional string or null`
RFC 3339 datetime string representing when the file will expire and become unavailable for download. Null if the file does not expire. For files uploaded with `expires_in_seconds`, this is the upload time plus that value.
- `next_page: optional string or null`
Opaque cursor for the next page. Supply as `?page=` to fetch the next page; null when there are no more results.
### Example
```http
curl https://api.anthropic.com/v1/files \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
#### Response
```json
{
"data": [
{
"id": "file_011CNha8iCJcU1wXNR6q4V8w",
"created_at": "2025-04-15T18:37:24.100435Z",
"filename": "document.pdf",
"mime_type": "application/pdf",
"size_bytes": 102400,
"type": "file",
"downloadable": false,
"expires_at": "2025-05-15T18:37:24.100435Z"
}
],
"next_page": "next_page"
}
```
## Download File
**get** `/v1/files/{file_id}/content`
Download File
### Path Parameters
- `file_id: string`
ID of the File.
### Example
```http
curl https://api.anthropic.com/v1/files/$FILE_ID/content \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
## Get File Metadata
**get** `/v1/files/{file_id}`
Get File Metadata
### Path Parameters
- `file_id: string`
ID of the File.
### Returns
- `FileMetadata object { id, created_at, filename, 5 more }`
- `id: string`
Unique object identifier.
The format and length of IDs may change over time.
- `created_at: string`
RFC 3339 datetime string representing when the file was created.
- `filename: string`
Original filename of the uploaded file.
- `mime_type: string`
MIME type of the file.
- `size_bytes: number`
Size of the file in bytes.
- `type: "file"`
Object type.
For files, this is always `"file"`.
- `"file"`
- `downloadable: optional boolean`
Whether the file can be downloaded.
- `expires_at: optional string or null`
RFC 3339 datetime string representing when the file will expire and become unavailable for download. Null if the file does not expire. For files uploaded with `expires_in_seconds`, this is the upload time plus that value.
### Example
```http
curl https://api.anthropic.com/v1/files/$FILE_ID \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
#### Response
```json
{
"id": "file_011CNha8iCJcU1wXNR6q4V8w",
"created_at": "2025-04-15T18:37:24.100435Z",
"filename": "document.pdf",
"mime_type": "application/pdf",
"size_bytes": 102400,
"type": "file",
"downloadable": false,
"expires_at": "2025-05-15T18:37:24.100435Z"
}
```
## Delete File
**delete** `/v1/files/{file_id}`
Delete File
### Path Parameters
- `file_id: string`
ID of the File.
### Returns
- `DeletedFile object { id, type }`
- `id: string`
ID of the deleted file.
- `type: optional "file_deleted"`
Deleted object type.
For file deletion, this is always `"file_deleted"`.
Cut at 300 lines. The page has the rest.
api/files/delete New page · 50 lines, new page
## Delete File ### Path Parameters ### Returns ### Example #### Response
A whole new page. There's nothing to diff it against, so here is what it says.
---
title: Delete File
url: https://platform.claude.com/docs/en/api/files/delete
---
## Delete File
**delete** `/v1/files/{file_id}`
Delete File
### Path Parameters
- `file_id: string`
ID of the File.
### Returns
- `DeletedFile object { id, type }`
- `id: string`
ID of the deleted file.
- `type: optional "file_deleted"`
Deleted object type.
For file deletion, this is always `"file_deleted"`.
- `"file_deleted"`
### Example
```http
curl https://api.anthropic.com/v1/files/$FILE_ID \
-X DELETE \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
#### Response
```json
{
"id": "file_011CNha8iCJcU1wXNR6q4V8w",
"type": "file_deleted"
}
```
api/files/download New page · 24 lines, new page
## Download File ### Path Parameters ### Example
A whole new page. There's nothing to diff it against, so here is what it says.
---
title: Download File
url: https://platform.claude.com/docs/en/api/files/download
---
## Download File
**get** `/v1/files/{file_id}/content`
Download File
### Path Parameters
- `file_id: string`
ID of the File.
### Example
```http
curl https://api.anthropic.com/v1/files/$FILE_ID/content \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
api/files/list New page · 102 lines, new page
## List Files ### Query Parameters ### Returns ### Example #### Response
A whole new page. There's nothing to diff it against, so here is what it says.
---
title: List Files
url: https://platform.claude.com/docs/en/api/files/list
---
## List Files
**get** `/v1/files`
List Files
### Query Parameters
- `ids: optional array of string`
Restrict the result set to Files whose `id` is in this list. At most 100 entries (after de-duplication). Mutually exclusive with `page` and `limit`. When supplied, the response is always a single page (`next_page` is null). IDs that do not resolve to a visible File — including deleted Files — are silently omitted.
- `limit: optional number`
Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
- `page: optional string`
Opaque page cursor returned in a prior list response's `next_page`. Prefixed `page_`.
### Returns
- `data: array of FileMetadata`
List of file metadata objects.
- `id: string`
Unique object identifier.
The format and length of IDs may change over time.
- `created_at: string`
RFC 3339 datetime string representing when the file was created.
- `filename: string`
Original filename of the uploaded file.
- `mime_type: string`
MIME type of the file.
- `size_bytes: number`
Size of the file in bytes.
- `type: "file"`
Object type.
For files, this is always `"file"`.
- `"file"`
- `downloadable: optional boolean`
Whether the file can be downloaded.
- `expires_at: optional string or null`
RFC 3339 datetime string representing when the file will expire and become unavailable for download. Null if the file does not expire. For files uploaded with `expires_in_seconds`, this is the upload time plus that value.
- `next_page: optional string or null`
Opaque cursor for the next page. Supply as `?page=` to fetch the next page; null when there are no more results.
### Example
```http
curl https://api.anthropic.com/v1/files \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
#### Response
```json
{
"data": [
{
"id": "file_011CNha8iCJcU1wXNR6q4V8w",
"created_at": "2025-04-15T18:37:24.100435Z",
"filename": "document.pdf",
"mime_type": "application/pdf",
"size_bytes": 102400,
"type": "file",
"downloadable": false,
"expires_at": "2025-05-15T18:37:24.100435Z"
}
],
"next_page": "next_page"
}
```
api/files/retrieve_metadata New page · 81 lines, new page
## Get File Metadata ### Path Parameters ### Returns ### Example #### Response
A whole new page. There's nothing to diff it against, so here is what it says.
---
title: Get File Metadata
url: https://platform.claude.com/docs/en/api/files/retrieve_metadata
---
## Get File Metadata
**get** `/v1/files/{file_id}`
Get File Metadata
### Path Parameters
- `file_id: string`
ID of the File.
### Returns
- `FileMetadata object { id, created_at, filename, 5 more }`
- `id: string`
Unique object identifier.
The format and length of IDs may change over time.
- `created_at: string`
RFC 3339 datetime string representing when the file was created.
- `filename: string`
Original filename of the uploaded file.
- `mime_type: string`
MIME type of the file.
- `size_bytes: number`
Size of the file in bytes.
- `type: "file"`
Object type.
For files, this is always `"file"`.
- `"file"`
- `downloadable: optional boolean`
Whether the file can be downloaded.
- `expires_at: optional string or null`
RFC 3339 datetime string representing when the file will expire and become unavailable for download. Null if the file does not expire. For files uploaded with `expires_in_seconds`, this is the upload time plus that value.
### Example
```http
curl https://api.anthropic.com/v1/files/$FILE_ID \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
#### Response
```json
{
"id": "file_011CNha8iCJcU1wXNR6q4V8w",
"created_at": "2025-04-15T18:37:24.100435Z",
"filename": "document.pdf",
"mime_type": "application/pdf",
"size_bytes": 102400,
"type": "file",
"downloadable": false,
"expires_at": "2025-05-15T18:37:24.100435Z"
}
```
api/files/upload New page · 77 lines, new page
## Upload File ### Returns ### Example #### Response
A whole new page. There's nothing to diff it against, so here is what it says.
---
title: Upload File
url: https://platform.claude.com/docs/en/api/files/upload
---
## Upload File
**post** `/v1/files`
Upload File
### Returns
- `FileMetadata object { id, created_at, filename, 5 more }`
- `id: string`
Unique object identifier.
The format and length of IDs may change over time.
- `created_at: string`
RFC 3339 datetime string representing when the file was created.
- `filename: string`
Original filename of the uploaded file.
- `mime_type: string`
MIME type of the file.
- `size_bytes: number`
Size of the file in bytes.
- `type: "file"`
Object type.
For files, this is always `"file"`.
- `"file"`
- `downloadable: optional boolean`
Whether the file can be downloaded.
- `expires_at: optional string or null`
RFC 3339 datetime string representing when the file will expire and become unavailable for download. Null if the file does not expire. For files uploaded with `expires_in_seconds`, this is the upload time plus that value.
### Example
```http
curl https://api.anthropic.com/v1/files \
-H 'Content-Type: multipart/form-data' \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY" \
-F 'file=@/path/to/file'
```
#### Response
```json
{
"id": "file_011CNha8iCJcU1wXNR6q4V8w",
"created_at": "2025-04-15T18:37:24.100435Z",
"filename": "document.pdf",
"mime_type": "application/pdf",
"size_bytes": 102400,
"type": "file",
"downloadable": false,
"expires_at": "2025-05-15T18:37:24.100435Z"
}
```
api/messages Changed · +7211 / -404 lines
### Browser Close Tab Config ### Browser Double Click Config ### Browser File Upload Config ### Browser Find Config ### Browser Form Input Config ### Browser Get Page Text Config ### Browser Hold Key Config ### Browser Hover Config ### Browser Javascript Exec Config ### Browser Key Config ### Browser Left Click Config ### Browser Left Click Drag Config ### Browser Left Mouse Down Config ### Browser Left Mouse Up Config ### Browser List Tabs Config ### Browser Middle Click Config ### Browser Mouse Move Config ### Browser Navigate Config ### Browser New Tab Config ### Browser Read Console Config ### Browser Read Network Config ### Browser Read Page Config ### Browser Right Click Config ### Browser Screenshot Config ### Browser Scroll Config ### Browser Scroll To Config ### Browser State Block Param ### Browser State Change ### Browser State Change Download Completed ### Browser State Change Download Failed ### Browser State Change Download Started ### Browser State Change Tab Opened ### Browser State Tab Entry ### Browser Switch Tab Config ### Browser Toolset 20260801 ### Browser Toolset Configs ### Browser Triple Click Config ### Browser Type Config ### Browser Wait Config ### Browser Zoom Config ### Computer Cursor Position Config ### Computer Double Click Config ### Computer Hold Key Config ### Computer Key Config ### Computer Left Click Config ### Computer Left Click Drag Config ### Computer Left Mouse Down Config ### Computer Left Mouse Up Config ### Computer Middle Click Config ### Computer Mouse Move Config ### Computer Right Click Config ### Computer Screenshot Config ### Computer Scroll Config ### Computer Toolset 20260801 ### Computer Toolset Configs ### Computer Triple Click Config ### Computer Type Config ### Computer Wait Config ### Computer Zoom Config ### Container Params ### Container Skill ### File Document Source ### File Image Source ### Image Transformations Param ### Message Create Params Container ### Skill Params ### Mid Conversation System Block Param
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/messages/batches Changed · +949 / -45 lines
The two sides of this change are more than 400 edits apart, too far apart to line up, so this is the differ's own diff of it and the words inside a line are not marked.
from line 243
243243
244244 - `"search_result_location"`
245245
246 - `ImageBlockParam object { source, type, cache_control }`
247
248 - `source: Base64ImageSource or URLImageSource`
246 - `ImageBlockParam object { source, type, cache_control, transformations }`
247
248 - `source: Base64ImageSource or URLImageSource or FileImageSource`
249249
250250 - `Base64ImageSource object { data, media_type, type }`
251251
from line 273
273273
274274 - `url: string`
275275
276 - `FileImageSource object { file_id, type }`
277
278 - `file_id: string`
279
280 - `type: "file"`
281
282 - `"file"`
283
276284 - `type: "image"`
277285
278286 - `"image"`
from line 289
281289
282290 Create a cache control breakpoint at this content block.
283291
292 - `transformations: optional ImageTransformationsParam or null`
293
294 Configures the transformations the server applies to this image before the model observes it. Each key names a condition the server transforms images for; its value selects the transformation applied. Omitted keys keep their default behavior, and an empty object is equivalent to omitting the field.
295
296 - `oversized_image: optional "downsize" or "error"`
297
298 What the server does when this image exceeds the model's maximum image size. `"downsize"` (the default) scales the image down to fit, which changes the dimensions the model observes without telling you. `"error"` instead rejects the request with a 400 error naming the image's dimensions and the largest dimensions that fit, so you can scale the image deliberately — your image is never silently scaled down.
299
300 - `"downsize"`
301
302 - `"error"`
303
284304 - `DocumentBlockParam object { source, type, cache_control, 3 more }`
285305
286 - `source: Base64PDFSource or PlainTextSource or ContentBlockSource or URLPDFSource`
306 - `source: Base64PDFSource or PlainTextSource or ContentBlockSource or 2 more`
287307
288308 - `Base64PDFSource object { data, media_type, type }`
289309
from line 339
319339
320340 - `TextBlockParam object { text, type, cache_control, citations }`
321341
322 - `ImageBlockParam object { source, type, cache_control }`
342 - `ImageBlockParam object { source, type, cache_control, transformations }`
323343
324344 - `type: "content"`
325345
from line 353
333353
334354 - `url: string`
335355
356 - `FileDocumentSource object { file_id, type }`
357
358 - `file_id: string`
359
360 - `type: "file"`
361
362 - `"file"`
363
336364 - `type: "document"`
337365
338366 - `"document"`
from line 431
403431
404432 - `"redacted_thinking"`
405433
406 - `ToolUseBlockParam object { id, input, name, 3 more }`
434 - `ToolUseBlockParam object { id, input, name, 4 more }`
407435
408436 - `id: string`
409437
from line 477
449477
450478 - `"code_execution_20260120"`
451479
452 - `ToolResultBlockParam object { tool_use_id, type, cache_control, 2 more }`
480 - `toolset_name: optional string or null`
481
482 For a toolset member tool_use, the toolset family this member belongs to.
483
484 - `ToolResultBlockParam object { tool_use_id, type, cache_control, 3 more }`
453485
454486 - `tool_use_id: string`
455487
from line 493
461493
462494 Create a cache control breakpoint at this content block.
463495
464 - `content: optional string or array of TextBlockParam or ImageBlockParam or SearchResultBlockParam or 2 more`
496 - `content: optional string or array of TextBlockParam or ImageBlockParam or SearchResultBlockParam or 3 more`
465497
466498 - `string`
467499
468 - `array of TextBlockParam or ImageBlockParam or SearchResultBlockParam or 2 more`
500 - `array of TextBlockParam or ImageBlockParam or SearchResultBlockParam or 3 more`
469501
470502 - `TextBlockParam object { text, type, cache_control, citations }`
471503
472 - `ImageBlockParam object { source, type, cache_control }`
504 - `ImageBlockParam object { source, type, cache_control, transformations }`
473505
474506 - `SearchResultBlockParam object { content, source, title, 3 more }`
475507
from line 521
489521
490522 Create a cache control breakpoint at this content block.
491523
524 - `BrowserStateBlockParam object { tabs, type, cache_control, state_changes }`
525
526 The caller's browser state after a browser toolset member call —
527 the full inventory of open tabs, which tab is active, and any side
528 effects (tabs opened, download state changes) the call produced.
529
530 At most one per `tool_result`, only on a non-error result answering a
531 browser toolset member `tool_use`. The server renders the
532 model-visible text from it; the model never sees the raw fields.
533
534 - `tabs: array of BrowserStateTabEntry`
535
536 All tabs open in the browser after this call — the full inventory, not a delta. May be empty. Whenever non-empty, exactly one entry carries `active: true`.
537
538 - `tab_id: string`
539
540 The caller-assigned identifier for this tab, unique within the inventory.
541
542 - `title: string`
543
544 The title of the page the tab is showing. May be empty.
545
546 - `url: string`
547
548 The URL of the page the tab is showing. May be empty.
549
550 - `active: optional boolean`
551
552 Whether this tab is the active tab after this call. Whenever `tabs` is non-empty, exactly one entry is marked `active: true`.
553
554 - `type: "browser_state"`
555
556 - `"browser_state"`
557
558 - `cache_control: optional CacheControlEphemeral or null`
559
560 Create a cache control breakpoint at this content block.
561
562 - `state_changes: optional array of BrowserStateChange or null`
563
564 Tabs opened and download state changes during this call. "Nothing to report" is expressed by omitting the field, never by an empty list.
565
566 - `BrowserStateChangeTabOpened object { tab_id, type }`
567
568 A tab this call's execution opened that remains open at its end —
569 the creation delta of the `tabs` inventory, not an event log.
570
571 Carries only the `tab_id`; the tab's `title` and `url` live on its
572 `tabs` entry, which must include the same `tab_id`. A tab opened
573 during a failed call gets no deferred `tab_opened`; it simply appears
574 in the next result's `tabs` inventory.
575
576 - `tab_id: string`
577
578 The `tab_id` of the opened tab, present in `tabs`.
579
580 - `type: "tab_opened"`
581
582 - `"tab_opened"`
583
584 - `BrowserStateChangeDownloadStarted object { download_id, type, url }`
585
586 A file download that started during this call.
587
588 - `download_id: string`
589
590 The caller-assigned identifier for this download, stable across the state changes reporting it.
591
592 - `type: "download_started"`
593
594 - `"download_started"`
595
596 - `url: string`
597
598 The final post-redirect URL the download was served from.
599
600 - `BrowserStateChangeDownloadCompleted object { download_id, type, url, 2 more }`
601
602 A file download that finished during this call, reported with the
603 same `download_id` as its `download_started` — or without a prior
604 `download_started`, when the download finished during the call that
605 started it (at most one state change per `download_id` per result).
606
607 - `download_id: string`
608
609 The caller-assigned identifier for this download, stable across the state changes reporting it.
610
611 - `type: "download_completed"`
612
613 - `"download_completed"`
614
615 - `url: string`
616
617 The final post-redirect URL the download was served from.
618
619 - `path: optional string or null`
620
621 Where the executor saved the file, on the executor's filesystem. Only included when another tool in the same environment can read the file at that path.
622
623 - `size_bytes: optional number or null`
624
625 The completed download's size.
626
627 - `BrowserStateChangeDownloadFailed object { download_id, type, url, error }`
628
629 A file download that failed — or was cancelled — during this call.
630
631 - `download_id: string`
632
633 The caller-assigned identifier for this download, stable across the state changes reporting it.
634
635 - `type: "download_failed"`
636
637 - `"download_failed"`
638
639 - `url: string`
640
641 The final post-redirect URL the download was served from.
642
643 - `error: optional string or null`
644
645 The failure or cancellation detail, when known.
646
492647 - `is_error: optional boolean`
648
649 - `toolset_name: optional string or null`
650
651 For a toolset member tool_result, the toolset family of the paired tool_use.
493652
494653 - `ServerToolUseBlockParam object { id, input, name, 3 more }`
495654
from line 1093
9341093
9351094 Create a cache control breakpoint at this content block.
9361095
937 - `MidConversationSystemBlockParam object { content, type, cache_control }`
938
939 System instructions that appear mid-conversation.
940
941 Use this block to provide or update system-level instructions at a specific
942 point in the conversation, rather than only via the top-level `system` parameter.
943
944 - `content: array of TextBlockParam`
945
946 System instruction text blocks.
947
948 - `text: string`
949
950 - `type: "text"`
951
952 - `cache_control: optional CacheControlEphemeral or null`
953
954 Create a cache control breakpoint at this content block.
955
956 - `citations: optional array of TextCitationParam or null`
957
958 - `type: "mid_conv_system"`
959
960 - `"mid_conv_system"`
961
962 - `cache_control: optional CacheControlEphemeral or null`
963
964 Create a cache control breakpoint at this content block.
965
9661096 - `role: "user" or "assistant" or "system"`
9671097
9681098 - `"user"`
from line 1179
10491179
10501180 Top-level cache control automatically applies a cache_control marker to the last cacheable block in the request.
10511181
1052 - `container: optional string or null`
1182 - `container: optional MessageCreateParamsContainer or null`
10531183
10541184 Container identifier for reuse across requests.
1185
1186 - `ContainerParams object { id, skills }`
1187
1188 Container parameters with skills to be loaded.
1189
1190 - `id: optional string or null`
1191
1192 Container id
1193
1194 - `skills: optional array of SkillParams or null`
1195
1196 List of skills to load in the container
1197
1198 - `skill_id: string`
1199
1200 Skill ID
1201
1202 - `type: "anthropic" or "custom"`
1203
1204 Type of skill - either 'anthropic' (built-in) or 'custom' (user-defined)
1205
1206 - `"anthropic"`
1207
1208 - `"custom"`
1209
1210 - `version: optional string`
1211
1212 Skill version or 'latest' for most recent version
1213
1214 - `string`
10551215
10561216 - `inference_geo: optional string or null`
10571217
from line 1727
15671727
15681728 When true, guarantees schema validation on tool names and inputs
15691729
1730 - `BrowserToolset20260801 object { type, allowed_callers, cache_control, configs }`
1731
1732 The browser toolset: a single `tools[]` entry (carrying no
1733 `name`) that declares the browser tool family. The model is served
1734 the family's tool with any members disabled via `configs` removed
1735 from its schema.
1736
1737 - `type: "browser_toolset_20260801"`
1738
1739 - `"browser_toolset_20260801"`
1740
1741 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
1742
1743 - `"direct"`
1744
1745 - `"code_execution_20250825"`
1746
1747 - `"code_execution_20260120"`
1748
1749 - `"code_execution_20260521"`
1750
1751 - `cache_control: optional CacheControlEphemeral or null`
1752
1753 Create a cache control breakpoint at this content block.
1754
1755 - `configs: optional BrowserToolsetConfigs or null`
1756
1757 Per-member configuration for `browser_toolset_20260801`: one
1758 optional field per member tool, keyed by the member name — the same
1759 name the member's `tool_use` blocks carry. Every member is an
1760 accepted key, and a member's defaults apply wherever its key is
1761 absent. Unknown keys are rejected: the field set is this toolset
1762 version's complete member set.
1763
1764 - `close_tab: optional BrowserCloseTabConfig or null`
1765
1766 `close_tab`'s config overrides.
1767
1768 - `defer_loading: optional boolean or null`
1769
1770 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1771
1772 - `enabled: optional boolean or null`
1773
1774 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.
1775
1776 - `double_click: optional BrowserDoubleClickConfig or null`
1777
1778 `double_click`'s config overrides.
1779
1780 - `defer_loading: optional boolean or null`
1781
1782 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1783
1784 - `enabled: optional boolean or null`
1785
1786 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.
1787
1788 - `file_upload: optional BrowserFileUploadConfig or null`
1789
1790 `file_upload`'s config overrides.
1791
1792 - `defer_loading: optional boolean or null`
1793
1794 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1795
1796 - `enabled: optional boolean or null`
1797
1798 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.
1799
1800 - `find: optional BrowserFindConfig or null`
1801
1802 `find`'s config overrides.
1803
1804 - `defer_loading: optional boolean or null`
1805
1806 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1807
1808 - `enabled: optional boolean or null`
1809
1810 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.
1811
1812 - `form_input: optional BrowserFormInputConfig or null`
1813
1814 `form_input`'s config overrides.
1815
1816 - `defer_loading: optional boolean or null`
1817
1818 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1819
1820 - `enabled: optional boolean or null`
1821
1822 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.
1823
1824 - `get_page_text: optional BrowserGetPageTextConfig or null`
1825
1826 `get_page_text`'s config overrides.
1827
1828 - `defer_loading: optional boolean or null`
1829
1830 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1831
1832 - `enabled: optional boolean or null`
1833
1834 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.
1835
1836 - `hold_key: optional BrowserHoldKeyConfig or null`
1837
1838 `hold_key`'s config overrides.
1839
1840 - `defer_loading: optional boolean or null`
1841
1842 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1843
1844 - `enabled: optional boolean or null`
1845
1846 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.
1847
1848 - `hover: optional BrowserHoverConfig or null`
1849
1850 `hover`'s config overrides.
1851
1852 - `defer_loading: optional boolean or null`
1853
1854 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1855
1856 - `enabled: optional boolean or null`
1857
1858 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.
1859
1860 - `javascript_exec: optional BrowserJavascriptExecConfig or null`
1861
1862 `javascript_exec`'s config overrides.
1863
1864 - `defer_loading: optional boolean or null`
1865
1866 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1867
1868 - `enabled: optional boolean or null`
1869
1870 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.
1871
1872 - `key: optional BrowserKeyConfig or null`
1873
1874 `key`'s config overrides.
1875
1876 - `defer_loading: optional boolean or null`
1877
1878 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1879
1880 - `enabled: optional boolean or null`
1881
1882 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.
1883
1884 - `left_click: optional BrowserLeftClickConfig or null`
1885
1886 `left_click`'s config overrides.
1887
1888 - `defer_loading: optional boolean or null`
1889
1890 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1891
1892 - `enabled: optional boolean or null`
1893
1894 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.
1895
1896 - `left_click_drag: optional BrowserLeftClickDragConfig or null`
1897
1898 `left_click_drag`'s config overrides.
1899
1900 - `defer_loading: optional boolean or null`
1901
1902 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1903
1904 - `enabled: optional boolean or null`
1905
1906 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.
1907
1908 - `left_mouse_down: optional BrowserLeftMouseDownConfig or null`
1909
1910 `left_mouse_down`'s config overrides.
1911
1912 - `defer_loading: optional boolean or null`
1913
1914 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1915
1916 - `enabled: optional boolean or null`
1917
1918 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.
1919
1920 - `left_mouse_up: optional BrowserLeftMouseUpConfig or null`
1921
1922 `left_mouse_up`'s config overrides.
1923
1924 - `defer_loading: optional boolean or null`
1925
1926 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1927
1928 - `enabled: optional boolean or null`
1929
1930 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.
1931
1932 - `list_tabs: optional BrowserListTabsConfig or null`
1933
1934 `list_tabs`'s config overrides.
1935
1936 - `defer_loading: optional boolean or null`
1937
1938 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1939
1940 - `enabled: optional boolean or null`
1941
1942 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.
1943
1944 - `middle_click: optional BrowserMiddleClickConfig or null`
1945
1946 `middle_click`'s config overrides.
1947
1948 - `defer_loading: optional boolean or null`
1949
1950 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1951
1952 - `enabled: optional boolean or null`
1953
1954 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.
1955
1956 - `mouse_move: optional BrowserMouseMoveConfig or null`
1957
1958 `mouse_move`'s config overrides.
1959
1960 - `defer_loading: optional boolean or null`
1961
1962 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1963
1964 - `enabled: optional boolean or null`
1965
1966 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.
1967
1968 - `navigate: optional BrowserNavigateConfig or null`
1969
1970 `navigate`'s config overrides.
1971
1972 - `defer_loading: optional boolean or null`
1973
1974 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1975
1976 - `enabled: optional boolean or null`
1977
1978 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.
1979
1980 - `new_tab: optional BrowserNewTabConfig or null`
1981
1982 `new_tab`'s config overrides.
1983
1984 - `defer_loading: optional boolean or null`
1985
1986 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1987
1988 - `enabled: optional boolean or null`
1989
1990 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.
1991
1992 - `read_console: optional BrowserReadConsoleConfig or null`
1993
1994 `read_console`'s config overrides.
1995
1996 - `defer_loading: optional boolean or null`
1997
1998 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1999
2000 - `enabled: optional boolean or null`
2001
2002 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.
2003
2004 - `read_network: optional BrowserReadNetworkConfig or null`
2005
2006 `read_network`'s config overrides.
2007
2008 - `defer_loading: optional boolean or null`
2009
2010 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2011
2012 - `enabled: optional boolean or null`
2013
2014 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.
2015
2016 - `read_page: optional BrowserReadPageConfig or null`
2017
2018 `read_page`'s config overrides.
2019
2020 - `defer_loading: optional boolean or null`
2021
2022 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2023
2024 - `enabled: optional boolean or null`
2025
2026 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.
2027
2028 - `right_click: optional BrowserRightClickConfig or null`
2029
2030 `right_click`'s config overrides.
2031
2032 - `defer_loading: optional boolean or null`
2033
2034 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2035
2036 - `enabled: optional boolean or null`
2037
2038 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.
2039
2040 - `screenshot: optional BrowserScreenshotConfig or null`
2041
2042 `screenshot`'s config overrides.
2043
2044 - `defer_loading: optional boolean or null`
2045
2046 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2047
2048 - `enabled: optional boolean or null`
2049
2050 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.
2051
2052 - `scroll: optional BrowserScrollConfig or null`
2053
2054 `scroll`'s config overrides.
2055
2056 - `defer_loading: optional boolean or null`
2057
2058 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2059
2060 - `enabled: optional boolean or null`
2061
2062 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.
2063
2064 - `scroll_to: optional BrowserScrollToConfig or null`
2065
2066 `scroll_to`'s config overrides.
2067
2068 - `defer_loading: optional boolean or null`
2069
2070 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2071
2072 - `enabled: optional boolean or null`
2073
2074 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.
2075
2076 - `switch_tab: optional BrowserSwitchTabConfig or null`
2077
2078 `switch_tab`'s config overrides.
2079
2080 - `defer_loading: optional boolean or null`
2081
2082 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2083
2084 - `enabled: optional boolean or null`
2085
2086 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.
2087
2088 - `triple_click: optional BrowserTripleClickConfig or null`
2089
2090 `triple_click`'s config overrides.
2091
2092 - `defer_loading: optional boolean or null`
2093
2094 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2095
2096 - `enabled: optional boolean or null`
2097
2098 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.
2099
2100 - `type: optional BrowserTypeConfig or null`
2101
2102 `type`'s config overrides.
2103
2104 - `defer_loading: optional boolean or null`
2105
2106 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2107
2108 - `enabled: optional boolean or null`
2109
2110 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.
2111
2112 - `wait: optional BrowserWaitConfig or null`
2113
2114 `wait`'s config overrides.
2115
2116 - `defer_loading: optional boolean or null`
2117
2118 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2119
2120 - `enabled: optional boolean or null`
2121
2122 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.
2123
2124 - `zoom: optional BrowserZoomConfig or null`
2125
2126 `zoom`'s config overrides.
2127
2128 - `defer_loading: optional boolean or null`
2129
2130 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2131
2132 - `enabled: optional boolean or null`
2133
2134 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.
2135
15702136 - `MemoryTool20250818 object { name, type, allowed_callers, 4 more }`
15712137
15722138 - `name: "memory"`
from line 2170
16042170 - `strict: optional boolean`
16052171
16062172 When true, guarantees schema validation on tool names and inputs
2173
2174 - `ComputerToolset20260801 object { type, allowed_callers, cache_control, configs }`
2175
2176 The computer toolset: a single `tools[]` entry (carrying no
2177 `name`) that declares the computer tool family. The model is
2178 served the family's tool with any members disabled via `configs`
2179 removed from its schema. Every member is enabled by default, zoom
2180 included. The single-tool options `display_number` and
2181 `enable_zoom` are not fields of a toolset entry — it carries only
2182 `type`, `configs`, and `cache_control`; zoom is controlled
2183 via `configs.zoom.enabled`.
2184
2185 - `type: "computer_toolset_20260801"`
2186
2187 - `"computer_toolset_20260801"`
2188
2189 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
2190
2191 - `"direct"`
2192
2193 - `"code_execution_20250825"`
2194
2195 - `"code_execution_20260120"`
2196
2197 - `"code_execution_20260521"`
2198
2199 - `cache_control: optional CacheControlEphemeral or null`
2200
2201 Create a cache control breakpoint at this content block.
2202
2203 - `configs: optional ComputerToolsetConfigs or null`
2204
2205 Per-member configuration for `computer_toolset_20260801`: one
2206 optional field per member tool, keyed by the member name — the same
2207 name the member's `tool_use` blocks carry. Every member is an
2208 accepted key, and a member's defaults apply wherever its key is
2209 absent. Unknown keys are rejected: the field set is this toolset
2210 version's complete member set.
2211
2212 - `cursor_position: optional ComputerCursorPositionConfig or null`
2213
2214 `cursor_position`'s config overrides.
2215
2216 - `defer_loading: optional boolean or null`
2217
2218 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2219
2220 - `enabled: optional boolean or null`
2221
2222 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.
2223
2224 - `double_click: optional ComputerDoubleClickConfig or null`
2225
2226 `double_click`'s config overrides.
2227
2228 - `defer_loading: optional boolean or null`
2229
2230 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2231
2232 - `enabled: optional boolean or null`
2233
2234 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.
2235
2236 - `hold_key: optional ComputerHoldKeyConfig or null`
2237
2238 `hold_key`'s config overrides.
2239
2240 - `defer_loading: optional boolean or null`
2241
2242 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2243
2244 - `enabled: optional boolean or null`
2245
2246 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.
2247
2248 - `key: optional ComputerKeyConfig or null`
2249
2250 `key`'s config overrides.
2251
2252 - `defer_loading: optional boolean or null`
2253
2254 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2255
2256 - `enabled: optional boolean or null`
2257
2258 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.
2259
2260 - `left_click: optional ComputerLeftClickConfig or null`
2261
2262 `left_click`'s config overrides.
2263
2264 - `defer_loading: optional boolean or null`
2265
2266 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2267
2268 - `enabled: optional boolean or null`
2269
2270 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.
2271
2272 - `left_click_drag: optional ComputerLeftClickDragConfig or null`
2273
2274 `left_click_drag`'s config overrides.
2275
2276 - `defer_loading: optional boolean or null`
2277
2278 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2279
2280 - `enabled: optional boolean or null`
2281
2282 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.
2283
2284 - `left_mouse_down: optional ComputerLeftMouseDownConfig or null`
2285
2286 `left_mouse_down`'s config overrides.
2287
2288 - `defer_loading: optional boolean or null`
2289
2290 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2291
2292 - `enabled: optional boolean or null`
2293
2294 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.
2295
2296 - `left_mouse_up: optional ComputerLeftMouseUpConfig or null`
2297
2298 `left_mouse_up`'s config overrides.
2299
2300 - `defer_loading: optional boolean or null`
2301
2302 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2303
2304 - `enabled: optional boolean or null`
2305
2306 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.
2307
2308 - `middle_click: optional ComputerMiddleClickConfig or null`
2309
2310 `middle_click`'s config overrides.
2311
2312 - `defer_loading: optional boolean or null`
2313
2314 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2315
2316 - `enabled: optional boolean or null`
2317
2318 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.
2319
2320 - `mouse_move: optional ComputerMouseMoveConfig or null`
2321
2322 `mouse_move`'s config overrides.
2323
2324 - `defer_loading: optional boolean or null`
2325
2326 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2327
2328 - `enabled: optional boolean or null`
2329
2330 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.
2331
2332 - `right_click: optional ComputerRightClickConfig or null`
2333
2334 `right_click`'s config overrides.
2335
2336 - `defer_loading: optional boolean or null`
2337
2338 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2339
2340 - `enabled: optional boolean or null`
2341
2342 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.
2343
2344 - `screenshot: optional ComputerScreenshotConfig or null`
2345
2346 `screenshot`'s config overrides.
2347
2348 - `defer_loading: optional boolean or null`
2349
2350 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2351
2352 - `enabled: optional boolean or null`
2353
2354 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.
2355
2356 - `scroll: optional ComputerScrollConfig or null`
2357
2358 `scroll`'s config overrides.
2359
2360 - `defer_loading: optional boolean or null`
2361
2362 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2363
2364 - `enabled: optional boolean or null`
2365
2366 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.
2367
2368 - `triple_click: optional ComputerTripleClickConfig or null`
2369
2370 `triple_click`'s config overrides.
2371
2372 - `defer_loading: optional boolean or null`
2373
2374 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2375
2376 - `enabled: optional boolean or null`
2377
2378 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.
2379
2380 - `type: optional ComputerTypeConfig or null`
2381
2382 `type`'s config overrides.
2383
2384 - `defer_loading: optional boolean or null`
2385
2386 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2387
2388 - `enabled: optional boolean or null`
2389
2390 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.
2391
2392 - `wait: optional ComputerWaitConfig or null`
2393
2394 `wait`'s config overrides.
2395
2396 - `defer_loading: optional boolean or null`
2397
2398 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2399
2400 - `enabled: optional boolean or null`
2401
2402 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.
2403
2404 - `zoom: optional ComputerZoomConfig or null`
2405
2406 `zoom`'s config overrides.
2407
2408 - `defer_loading: optional boolean or null`
2409
2410 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2411
2412 - `enabled: optional boolean or null`
2413
2414 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.
16072415
16082416 - `ToolTextEditor20250124 object { name, type, allowed_callers, 4 more }`
16092417
from line 3158
23503158 "role": "user"
23513159 }
23523160 ],
2353 "model": "claude-opus-4-6"
3161 "model": "claude-opus-5"
23543162 }
23553163 }
23563164 ]
from line 3731
29233731
29243732 The time at which the container will expire.
29253733
3734 - `skills: array of ContainerSkill or null`
3735
3736 Skills loaded in the container
3737
3738 - `skill_id: string`
3739
3740 Skill ID
3741
3742 - `type: "anthropic" or "custom"`
3743
3744 Type of skill - either 'anthropic' (built-in) or 'custom' (user-defined)
3745
3746 - `"anthropic"`
3747
3748 - `"custom"`
3749
3750 - `version: string`
3751
3752 Skill version or 'latest' for most recent version
3753
29263754 - `content: array of ContentBlock`
29273755
29283756 Content generated by the model.
from line 3936
31083936
31093937 - `"redacted_thinking"`
31103938
3111 - `ToolUseBlock object { id, caller, input, 2 more }`
3939 - `ToolUseBlock object { id, caller, input, 3 more }`
31123940
31133941 - `id: string`
31143942
from line 3977
31493977 - `type: "tool_use"`
31503978
31513979 - `"tool_use"`
3980
3981 - `toolset_name: optional string or null`
3982
3983 For a toolset member tool_use, the toolset family.
31523984
31533985 - `ServerToolUseBlock object { id, caller, input, 2 more }`
31543986
from line 5046
42145046
42155047 The time at which the container will expire.
42165048
5049 - `skills: array of ContainerSkill or null`
5050
5051 Skills loaded in the container
5052
5053 - `skill_id: string`
5054
5055 Skill ID
5056
5057 - `type: "anthropic" or "custom"`
5058
5059 Type of skill - either 'anthropic' (built-in) or 'custom' (user-defined)
5060
5061 - `"anthropic"`
5062
5063 - `"custom"`
5064
5065 - `version: string`
5066
5067 Skill version or 'latest' for most recent version
5068
42175069 - `content: array of ContentBlock`
42185070
42195071 Content generated by the model.
from line 5251
43995251
44005252 - `"redacted_thinking"`
44015253
4402 - `ToolUseBlock object { id, caller, input, 2 more }`
5254 - `ToolUseBlock object { id, caller, input, 3 more }`
44035255
44045256 - `id: string`
44055257
from line 5292
44405292 - `type: "tool_use"`
44415293
44425294 - `"tool_use"`
5295
5296 - `toolset_name: optional string or null`
5297
5298 For a toolset member tool_use, the toolset family.
44435299
44445300 - `ServerToolUseBlock object { id, caller, input, 2 more }`
44455301
from line 6161
53056161
53066162 The time at which the container will expire.
53076163
6164 - `skills: array of ContainerSkill or null`
6165
6166 Skills loaded in the container
6167
6168 - `skill_id: string`
6169
6170 Skill ID
6171
6172 - `type: "anthropic" or "custom"`
6173
6174 Type of skill - either 'anthropic' (built-in) or 'custom' (user-defined)
6175
6176 - `"anthropic"`
6177
6178 - `"custom"`
6179
6180 - `version: string`
6181
6182 Skill version or 'latest' for most recent version
6183
53086184 - `content: array of ContentBlock`
53096185
53106186 Content generated by the model.
from line 6366
54906366
54916367 - `"redacted_thinking"`
54926368
5493 - `ToolUseBlock object { id, caller, input, 2 more }`
6369 - `ToolUseBlock object { id, caller, input, 3 more }`
54946370
54956371 - `id: string`
54966372
from line 6407
55316407 - `type: "tool_use"`
55326408
55336409 - `"tool_use"`
6410
6411 - `toolset_name: optional string or null`
6412
6413 For a toolset member tool_use, the toolset family.
55346414
55356415 - `ServerToolUseBlock object { id, caller, input, 2 more }`
55366416
from line 7238
63587238
63597239 The time at which the container will expire.
63607240
7241 - `skills: array of ContainerSkill or null`
7242
7243 Skills loaded in the container
7244
7245 - `skill_id: string`
7246
7247 Skill ID
7248
7249 - `type: "anthropic" or "custom"`
7250
7251 Type of skill - either 'anthropic' (built-in) or 'custom' (user-defined)
7252
7253 - `"anthropic"`
7254
7255 - `"custom"`
7256
7257 - `version: string`
7258
7259 Skill version or 'latest' for most recent version
7260
63617261 - `content: array of ContentBlock`
63627262
63637263 Content generated by the model.
from line 7443
65437443
65447444 - `"redacted_thinking"`
65457445
6546 - `ToolUseBlock object { id, caller, input, 2 more }`
7446 - `ToolUseBlock object { id, caller, input, 3 more }`
65477447
65487448 - `id: string`
65497449
from line 7484
65847484 - `type: "tool_use"`
65857485
65867486 - `"tool_use"`
7487
7488 - `toolset_name: optional string or null`
7489
7490 For a toolset member tool_use, the toolset family.
65877491
65887492 - `ServerToolUseBlock object { id, caller, input, 2 more }`
65897493
65907494
api/messages/batches/create Changed · +849 / -41 lines
The two sides of this change are more than 400 edits apart, too far apart to line up, so this is the differ's own diff of it and the words inside a line are not marked.
from line 241
241241
242242 - `"search_result_location"`
243243
244 - `ImageBlockParam object { source, type, cache_control }`
245
246 - `source: Base64ImageSource or URLImageSource`
244 - `ImageBlockParam object { source, type, cache_control, transformations }`
245
246 - `source: Base64ImageSource or URLImageSource or FileImageSource`
247247
248248 - `Base64ImageSource object { data, media_type, type }`
249249
from line 271
271271
272272 - `url: string`
273273
274 - `FileImageSource object { file_id, type }`
275
276 - `file_id: string`
277
278 - `type: "file"`
279
280 - `"file"`
281
274282 - `type: "image"`
275283
276284 - `"image"`
from line 287
279287
280288 Create a cache control breakpoint at this content block.
281289
290 - `transformations: optional ImageTransformationsParam or null`
291
292 Configures the transformations the server applies to this image before the model observes it. Each key names a condition the server transforms images for; its value selects the transformation applied. Omitted keys keep their default behavior, and an empty object is equivalent to omitting the field.
293
294 - `oversized_image: optional "downsize" or "error"`
295
296 What the server does when this image exceeds the model's maximum image size. `"downsize"` (the default) scales the image down to fit, which changes the dimensions the model observes without telling you. `"error"` instead rejects the request with a 400 error naming the image's dimensions and the largest dimensions that fit, so you can scale the image deliberately — your image is never silently scaled down.
297
298 - `"downsize"`
299
300 - `"error"`
301
282302 - `DocumentBlockParam object { source, type, cache_control, 3 more }`
283303
284 - `source: Base64PDFSource or PlainTextSource or ContentBlockSource or URLPDFSource`
304 - `source: Base64PDFSource or PlainTextSource or ContentBlockSource or 2 more`
285305
286306 - `Base64PDFSource object { data, media_type, type }`
287307
from line 337
317337
318338 - `TextBlockParam object { text, type, cache_control, citations }`
319339
320 - `ImageBlockParam object { source, type, cache_control }`
340 - `ImageBlockParam object { source, type, cache_control, transformations }`
321341
322342 - `type: "content"`
323343
from line 351
331351
332352 - `url: string`
333353
354 - `FileDocumentSource object { file_id, type }`
355
356 - `file_id: string`
357
358 - `type: "file"`
359
360 - `"file"`
361
334362 - `type: "document"`
335363
336364 - `"document"`
from line 429
401429
402430 - `"redacted_thinking"`
403431
404 - `ToolUseBlockParam object { id, input, name, 3 more }`
432 - `ToolUseBlockParam object { id, input, name, 4 more }`
405433
406434 - `id: string`
407435
from line 475
447475
448476 - `"code_execution_20260120"`
449477
450 - `ToolResultBlockParam object { tool_use_id, type, cache_control, 2 more }`
478 - `toolset_name: optional string or null`
479
480 For a toolset member tool_use, the toolset family this member belongs to.
481
482 - `ToolResultBlockParam object { tool_use_id, type, cache_control, 3 more }`
451483
452484 - `tool_use_id: string`
453485
from line 491
459491
460492 Create a cache control breakpoint at this content block.
461493
462 - `content: optional string or array of TextBlockParam or ImageBlockParam or SearchResultBlockParam or 2 more`
494 - `content: optional string or array of TextBlockParam or ImageBlockParam or SearchResultBlockParam or 3 more`
463495
464496 - `string`
465497
466 - `array of TextBlockParam or ImageBlockParam or SearchResultBlockParam or 2 more`
498 - `array of TextBlockParam or ImageBlockParam or SearchResultBlockParam or 3 more`
467499
468500 - `TextBlockParam object { text, type, cache_control, citations }`
469501
470 - `ImageBlockParam object { source, type, cache_control }`
502 - `ImageBlockParam object { source, type, cache_control, transformations }`
471503
472504 - `SearchResultBlockParam object { content, source, title, 3 more }`
473505
from line 519
487519
488520 Create a cache control breakpoint at this content block.
489521
522 - `BrowserStateBlockParam object { tabs, type, cache_control, state_changes }`
523
524 The caller's browser state after a browser toolset member call —
525 the full inventory of open tabs, which tab is active, and any side
526 effects (tabs opened, download state changes) the call produced.
527
528 At most one per `tool_result`, only on a non-error result answering a
529 browser toolset member `tool_use`. The server renders the
530 model-visible text from it; the model never sees the raw fields.
531
532 - `tabs: array of BrowserStateTabEntry`
533
534 All tabs open in the browser after this call — the full inventory, not a delta. May be empty. Whenever non-empty, exactly one entry carries `active: true`.
535
536 - `tab_id: string`
537
538 The caller-assigned identifier for this tab, unique within the inventory.
539
540 - `title: string`
541
542 The title of the page the tab is showing. May be empty.
543
544 - `url: string`
545
546 The URL of the page the tab is showing. May be empty.
547
548 - `active: optional boolean`
549
550 Whether this tab is the active tab after this call. Whenever `tabs` is non-empty, exactly one entry is marked `active: true`.
551
552 - `type: "browser_state"`
553
554 - `"browser_state"`
555
556 - `cache_control: optional CacheControlEphemeral or null`
557
558 Create a cache control breakpoint at this content block.
559
560 - `state_changes: optional array of BrowserStateChange or null`
561
562 Tabs opened and download state changes during this call. "Nothing to report" is expressed by omitting the field, never by an empty list.
563
564 - `BrowserStateChangeTabOpened object { tab_id, type }`
565
566 A tab this call's execution opened that remains open at its end —
567 the creation delta of the `tabs` inventory, not an event log.
568
569 Carries only the `tab_id`; the tab's `title` and `url` live on its
570 `tabs` entry, which must include the same `tab_id`. A tab opened
571 during a failed call gets no deferred `tab_opened`; it simply appears
572 in the next result's `tabs` inventory.
573
574 - `tab_id: string`
575
576 The `tab_id` of the opened tab, present in `tabs`.
577
578 - `type: "tab_opened"`
579
580 - `"tab_opened"`
581
582 - `BrowserStateChangeDownloadStarted object { download_id, type, url }`
583
584 A file download that started during this call.
585
586 - `download_id: string`
587
588 The caller-assigned identifier for this download, stable across the state changes reporting it.
589
590 - `type: "download_started"`
591
592 - `"download_started"`
593
594 - `url: string`
595
596 The final post-redirect URL the download was served from.
597
598 - `BrowserStateChangeDownloadCompleted object { download_id, type, url, 2 more }`
599
600 A file download that finished during this call, reported with the
601 same `download_id` as its `download_started` — or without a prior
602 `download_started`, when the download finished during the call that
603 started it (at most one state change per `download_id` per result).
604
605 - `download_id: string`
606
607 The caller-assigned identifier for this download, stable across the state changes reporting it.
608
609 - `type: "download_completed"`
610
611 - `"download_completed"`
612
613 - `url: string`
614
615 The final post-redirect URL the download was served from.
616
617 - `path: optional string or null`
618
619 Where the executor saved the file, on the executor's filesystem. Only included when another tool in the same environment can read the file at that path.
620
621 - `size_bytes: optional number or null`
622
623 The completed download's size.
624
625 - `BrowserStateChangeDownloadFailed object { download_id, type, url, error }`
626
627 A file download that failed — or was cancelled — during this call.
628
629 - `download_id: string`
630
631 The caller-assigned identifier for this download, stable across the state changes reporting it.
632
633 - `type: "download_failed"`
634
635 - `"download_failed"`
636
637 - `url: string`
638
639 The final post-redirect URL the download was served from.
640
641 - `error: optional string or null`
642
643 The failure or cancellation detail, when known.
644
490645 - `is_error: optional boolean`
646
647 - `toolset_name: optional string or null`
648
649 For a toolset member tool_result, the toolset family of the paired tool_use.
491650
492651 - `ServerToolUseBlockParam object { id, input, name, 3 more }`
493652
from line 1091
9321091
9331092 Create a cache control breakpoint at this content block.
9341093
935 - `MidConversationSystemBlockParam object { content, type, cache_control }`
936
937 System instructions that appear mid-conversation.
938
939 Use this block to provide or update system-level instructions at a specific
940 point in the conversation, rather than only via the top-level `system` parameter.
941
942 - `content: array of TextBlockParam`
943
944 System instruction text blocks.
945
946 - `text: string`
947
948 - `type: "text"`
949
950 - `cache_control: optional CacheControlEphemeral or null`
951
952 Create a cache control breakpoint at this content block.
953
954 - `citations: optional array of TextCitationParam or null`
955
956 - `type: "mid_conv_system"`
957
958 - `"mid_conv_system"`
959
960 - `cache_control: optional CacheControlEphemeral or null`
961
962 Create a cache control breakpoint at this content block.
963
9641094 - `role: "user" or "assistant" or "system"`
9651095
9661096 - `"user"`
from line 1177
10471177
10481178 Top-level cache control automatically applies a cache_control marker to the last cacheable block in the request.
10491179
1050 - `container: optional string or null`
1180 - `container: optional MessageCreateParamsContainer or null`
10511181
10521182 Container identifier for reuse across requests.
1183
1184 - `ContainerParams object { id, skills }`
1185
1186 Container parameters with skills to be loaded.
1187
1188 - `id: optional string or null`
1189
1190 Container id
1191
1192 - `skills: optional array of SkillParams or null`
1193
1194 List of skills to load in the container
1195
1196 - `skill_id: string`
1197
1198 Skill ID
1199
1200 - `type: "anthropic" or "custom"`
1201
1202 Type of skill - either 'anthropic' (built-in) or 'custom' (user-defined)
1203
1204 - `"anthropic"`
1205
1206 - `"custom"`
1207
1208 - `version: optional string`
1209
1210 Skill version or 'latest' for most recent version
1211
1212 - `string`
10531213
10541214 - `inference_geo: optional string or null`
10551215
from line 1725
15651725
15661726 When true, guarantees schema validation on tool names and inputs
15671727
1728 - `BrowserToolset20260801 object { type, allowed_callers, cache_control, configs }`
1729
1730 The browser toolset: a single `tools[]` entry (carrying no
1731 `name`) that declares the browser tool family. The model is served
1732 the family's tool with any members disabled via `configs` removed
1733 from its schema.
1734
1735 - `type: "browser_toolset_20260801"`
1736
1737 - `"browser_toolset_20260801"`
1738
1739 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
1740
1741 - `"direct"`
1742
1743 - `"code_execution_20250825"`
1744
1745 - `"code_execution_20260120"`
1746
1747 - `"code_execution_20260521"`
1748
1749 - `cache_control: optional CacheControlEphemeral or null`
1750
1751 Create a cache control breakpoint at this content block.
1752
1753 - `configs: optional BrowserToolsetConfigs or null`
1754
1755 Per-member configuration for `browser_toolset_20260801`: one
1756 optional field per member tool, keyed by the member name — the same
1757 name the member's `tool_use` blocks carry. Every member is an
1758 accepted key, and a member's defaults apply wherever its key is
1759 absent. Unknown keys are rejected: the field set is this toolset
1760 version's complete member set.
1761
1762 - `close_tab: optional BrowserCloseTabConfig or null`
1763
1764 `close_tab`'s config overrides.
1765
1766 - `defer_loading: optional boolean or null`
1767
1768 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1769
1770 - `enabled: optional boolean or null`
1771
1772 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.
1773
1774 - `double_click: optional BrowserDoubleClickConfig or null`
1775
1776 `double_click`'s config overrides.
1777
1778 - `defer_loading: optional boolean or null`
1779
1780 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1781
1782 - `enabled: optional boolean or null`
1783
1784 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.
1785
1786 - `file_upload: optional BrowserFileUploadConfig or null`
1787
1788 `file_upload`'s config overrides.
1789
1790 - `defer_loading: optional boolean or null`
1791
1792 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1793
1794 - `enabled: optional boolean or null`
1795
1796 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.
1797
1798 - `find: optional BrowserFindConfig or null`
1799
1800 `find`'s config overrides.
1801
1802 - `defer_loading: optional boolean or null`
1803
1804 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1805
1806 - `enabled: optional boolean or null`
1807
1808 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.
1809
1810 - `form_input: optional BrowserFormInputConfig or null`
1811
1812 `form_input`'s config overrides.
1813
1814 - `defer_loading: optional boolean or null`
1815
1816 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1817
1818 - `enabled: optional boolean or null`
1819
1820 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.
1821
1822 - `get_page_text: optional BrowserGetPageTextConfig or null`
1823
1824 `get_page_text`'s config overrides.
1825
1826 - `defer_loading: optional boolean or null`
1827
1828 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1829
1830 - `enabled: optional boolean or null`
1831
1832 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.
1833
1834 - `hold_key: optional BrowserHoldKeyConfig or null`
1835
1836 `hold_key`'s config overrides.
1837
1838 - `defer_loading: optional boolean or null`
1839
1840 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1841
1842 - `enabled: optional boolean or null`
1843
1844 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.
1845
1846 - `hover: optional BrowserHoverConfig or null`
1847
1848 `hover`'s config overrides.
1849
1850 - `defer_loading: optional boolean or null`
1851
1852 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1853
1854 - `enabled: optional boolean or null`
1855
1856 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.
1857
1858 - `javascript_exec: optional BrowserJavascriptExecConfig or null`
1859
1860 `javascript_exec`'s config overrides.
1861
1862 - `defer_loading: optional boolean or null`
1863
1864 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1865
1866 - `enabled: optional boolean or null`
1867
1868 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.
1869
1870 - `key: optional BrowserKeyConfig or null`
1871
1872 `key`'s config overrides.
1873
1874 - `defer_loading: optional boolean or null`
1875
1876 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1877
1878 - `enabled: optional boolean or null`
1879
1880 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.
1881
1882 - `left_click: optional BrowserLeftClickConfig or null`
1883
1884 `left_click`'s config overrides.
1885
1886 - `defer_loading: optional boolean or null`
1887
1888 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1889
1890 - `enabled: optional boolean or null`
1891
1892 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.
1893
1894 - `left_click_drag: optional BrowserLeftClickDragConfig or null`
1895
1896 `left_click_drag`'s config overrides.
1897
1898 - `defer_loading: optional boolean or null`
1899
1900 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1901
1902 - `enabled: optional boolean or null`
1903
1904 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.
1905
1906 - `left_mouse_down: optional BrowserLeftMouseDownConfig or null`
1907
1908 `left_mouse_down`'s config overrides.
1909
1910 - `defer_loading: optional boolean or null`
1911
1912 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1913
1914 - `enabled: optional boolean or null`
1915
1916 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.
1917
1918 - `left_mouse_up: optional BrowserLeftMouseUpConfig or null`
1919
1920 `left_mouse_up`'s config overrides.
1921
1922 - `defer_loading: optional boolean or null`
1923
1924 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1925
1926 - `enabled: optional boolean or null`
1927
1928 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.
1929
1930 - `list_tabs: optional BrowserListTabsConfig or null`
1931
1932 `list_tabs`'s config overrides.
1933
1934 - `defer_loading: optional boolean or null`
1935
1936 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1937
1938 - `enabled: optional boolean or null`
1939
1940 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.
1941
1942 - `middle_click: optional BrowserMiddleClickConfig or null`
1943
1944 `middle_click`'s config overrides.
1945
1946 - `defer_loading: optional boolean or null`
1947
1948 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1949
1950 - `enabled: optional boolean or null`
1951
1952 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.
1953
1954 - `mouse_move: optional BrowserMouseMoveConfig or null`
1955
1956 `mouse_move`'s config overrides.
1957
1958 - `defer_loading: optional boolean or null`
1959
1960 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1961
1962 - `enabled: optional boolean or null`
1963
1964 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.
1965
1966 - `navigate: optional BrowserNavigateConfig or null`
1967
1968 `navigate`'s config overrides.
1969
1970 - `defer_loading: optional boolean or null`
1971
1972 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1973
1974 - `enabled: optional boolean or null`
1975
1976 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.
1977
1978 - `new_tab: optional BrowserNewTabConfig or null`
1979
1980 `new_tab`'s config overrides.
1981
1982 - `defer_loading: optional boolean or null`
1983
1984 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1985
1986 - `enabled: optional boolean or null`
1987
1988 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.
1989
1990 - `read_console: optional BrowserReadConsoleConfig or null`
1991
1992 `read_console`'s config overrides.
1993
1994 - `defer_loading: optional boolean or null`
1995
1996 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1997
1998 - `enabled: optional boolean or null`
1999
2000 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.
2001
2002 - `read_network: optional BrowserReadNetworkConfig or null`
2003
2004 `read_network`'s config overrides.
2005
2006 - `defer_loading: optional boolean or null`
2007
2008 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2009
2010 - `enabled: optional boolean or null`
2011
2012 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.
2013
2014 - `read_page: optional BrowserReadPageConfig or null`
2015
2016 `read_page`'s config overrides.
2017
2018 - `defer_loading: optional boolean or null`
2019
2020 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2021
2022 - `enabled: optional boolean or null`
2023
2024 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.
2025
2026 - `right_click: optional BrowserRightClickConfig or null`
2027
2028 `right_click`'s config overrides.
2029
2030 - `defer_loading: optional boolean or null`
2031
2032 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2033
2034 - `enabled: optional boolean or null`
2035
2036 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.
2037
2038 - `screenshot: optional BrowserScreenshotConfig or null`
2039
2040 `screenshot`'s config overrides.
2041
2042 - `defer_loading: optional boolean or null`
2043
2044 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2045
2046 - `enabled: optional boolean or null`
2047
2048 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.
2049
2050 - `scroll: optional BrowserScrollConfig or null`
2051
2052 `scroll`'s config overrides.
2053
2054 - `defer_loading: optional boolean or null`
2055
2056 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2057
2058 - `enabled: optional boolean or null`
2059
2060 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.
2061
2062 - `scroll_to: optional BrowserScrollToConfig or null`
2063
2064 `scroll_to`'s config overrides.
2065
2066 - `defer_loading: optional boolean or null`
2067
2068 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2069
2070 - `enabled: optional boolean or null`
2071
2072 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.
2073
2074 - `switch_tab: optional BrowserSwitchTabConfig or null`
2075
2076 `switch_tab`'s config overrides.
2077
2078 - `defer_loading: optional boolean or null`
2079
2080 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2081
2082 - `enabled: optional boolean or null`
2083
2084 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.
2085
2086 - `triple_click: optional BrowserTripleClickConfig or null`
2087
2088 `triple_click`'s config overrides.
2089
2090 - `defer_loading: optional boolean or null`
2091
2092 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2093
2094 - `enabled: optional boolean or null`
2095
2096 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.
2097
2098 - `type: optional BrowserTypeConfig or null`
2099
2100 `type`'s config overrides.
2101
2102 - `defer_loading: optional boolean or null`
2103
2104 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2105
2106 - `enabled: optional boolean or null`
2107
2108 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.
2109
2110 - `wait: optional BrowserWaitConfig or null`
2111
2112 `wait`'s config overrides.
2113
2114 - `defer_loading: optional boolean or null`
2115
2116 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2117
2118 - `enabled: optional boolean or null`
2119
2120 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.
2121
2122 - `zoom: optional BrowserZoomConfig or null`
2123
2124 `zoom`'s config overrides.
2125
2126 - `defer_loading: optional boolean or null`
2127
2128 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2129
2130 - `enabled: optional boolean or null`
2131
2132 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.
2133
15682134 - `MemoryTool20250818 object { name, type, allowed_callers, 4 more }`
15692135
15702136 - `name: "memory"`
from line 2168
16022168 - `strict: optional boolean`
16032169
16042170 When true, guarantees schema validation on tool names and inputs
2171
2172 - `ComputerToolset20260801 object { type, allowed_callers, cache_control, configs }`
2173
2174 The computer toolset: a single `tools[]` entry (carrying no
2175 `name`) that declares the computer tool family. The model is
2176 served the family's tool with any members disabled via `configs`
2177 removed from its schema. Every member is enabled by default, zoom
2178 included. The single-tool options `display_number` and
2179 `enable_zoom` are not fields of a toolset entry — it carries only
2180 `type`, `configs`, and `cache_control`; zoom is controlled
2181 via `configs.zoom.enabled`.
2182
2183 - `type: "computer_toolset_20260801"`
2184
2185 - `"computer_toolset_20260801"`
2186
2187 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
2188
2189 - `"direct"`
2190
2191 - `"code_execution_20250825"`
2192
2193 - `"code_execution_20260120"`
2194
2195 - `"code_execution_20260521"`
2196
2197 - `cache_control: optional CacheControlEphemeral or null`
2198
2199 Create a cache control breakpoint at this content block.
2200
2201 - `configs: optional ComputerToolsetConfigs or null`
2202
2203 Per-member configuration for `computer_toolset_20260801`: one
2204 optional field per member tool, keyed by the member name — the same
2205 name the member's `tool_use` blocks carry. Every member is an
2206 accepted key, and a member's defaults apply wherever its key is
2207 absent. Unknown keys are rejected: the field set is this toolset
2208 version's complete member set.
2209
2210 - `cursor_position: optional ComputerCursorPositionConfig or null`
2211
2212 `cursor_position`'s config overrides.
2213
2214 - `defer_loading: optional boolean or null`
2215
2216 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2217
2218 - `enabled: optional boolean or null`
2219
2220 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.
2221
2222 - `double_click: optional ComputerDoubleClickConfig or null`
2223
2224 `double_click`'s config overrides.
2225
2226 - `defer_loading: optional boolean or null`
2227
2228 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2229
2230 - `enabled: optional boolean or null`
2231
2232 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.
2233
2234 - `hold_key: optional ComputerHoldKeyConfig or null`
2235
2236 `hold_key`'s config overrides.
2237
2238 - `defer_loading: optional boolean or null`
2239
2240 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2241
2242 - `enabled: optional boolean or null`
2243
2244 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.
2245
2246 - `key: optional ComputerKeyConfig or null`
2247
2248 `key`'s config overrides.
2249
2250 - `defer_loading: optional boolean or null`
2251
2252 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2253
2254 - `enabled: optional boolean or null`
2255
2256 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.
2257
2258 - `left_click: optional ComputerLeftClickConfig or null`
2259
2260 `left_click`'s config overrides.
2261
2262 - `defer_loading: optional boolean or null`
2263
2264 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2265
2266 - `enabled: optional boolean or null`
2267
2268 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.
2269
2270 - `left_click_drag: optional ComputerLeftClickDragConfig or null`
2271
2272 `left_click_drag`'s config overrides.
2273
2274 - `defer_loading: optional boolean or null`
2275
2276 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2277
2278 - `enabled: optional boolean or null`
2279
2280 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.
2281
2282 - `left_mouse_down: optional ComputerLeftMouseDownConfig or null`
2283
2284 `left_mouse_down`'s config overrides.
2285
2286 - `defer_loading: optional boolean or null`
2287
2288 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2289
2290 - `enabled: optional boolean or null`
2291
2292 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.
2293
2294 - `left_mouse_up: optional ComputerLeftMouseUpConfig or null`
2295
2296 `left_mouse_up`'s config overrides.
2297
2298 - `defer_loading: optional boolean or null`
2299
2300 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2301
2302 - `enabled: optional boolean or null`
2303
2304 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.
2305
2306 - `middle_click: optional ComputerMiddleClickConfig or null`
2307
2308 `middle_click`'s config overrides.
2309
2310 - `defer_loading: optional boolean or null`
2311
2312 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2313
2314 - `enabled: optional boolean or null`
2315
2316 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.
2317
2318 - `mouse_move: optional ComputerMouseMoveConfig or null`
2319
2320 `mouse_move`'s config overrides.
2321
2322 - `defer_loading: optional boolean or null`
2323
2324 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2325
2326 - `enabled: optional boolean or null`
2327
2328 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.
2329
2330 - `right_click: optional ComputerRightClickConfig or null`
2331
2332 `right_click`'s config overrides.
2333
2334 - `defer_loading: optional boolean or null`
2335
2336 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2337
2338 - `enabled: optional boolean or null`
2339
2340 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.
2341
2342 - `screenshot: optional ComputerScreenshotConfig or null`
2343
2344 `screenshot`'s config overrides.
2345
2346 - `defer_loading: optional boolean or null`
2347
2348 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2349
2350 - `enabled: optional boolean or null`
2351
2352 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.
2353
2354 - `scroll: optional ComputerScrollConfig or null`
2355
2356 `scroll`'s config overrides.
2357
2358 - `defer_loading: optional boolean or null`
2359
2360 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2361
2362 - `enabled: optional boolean or null`
2363
2364 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.
2365
2366 - `triple_click: optional ComputerTripleClickConfig or null`
2367
2368 `triple_click`'s config overrides.
2369
2370 - `defer_loading: optional boolean or null`
2371
2372 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2373
2374 - `enabled: optional boolean or null`
2375
2376 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.
2377
2378 - `type: optional ComputerTypeConfig or null`
2379
2380 `type`'s config overrides.
2381
2382 - `defer_loading: optional boolean or null`
2383
2384 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2385
2386 - `enabled: optional boolean or null`
2387
2388 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.
2389
2390 - `wait: optional ComputerWaitConfig or null`
2391
2392 `wait`'s config overrides.
2393
2394 - `defer_loading: optional boolean or null`
2395
2396 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2397
2398 - `enabled: optional boolean or null`
2399
2400 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.
2401
2402 - `zoom: optional ComputerZoomConfig or null`
2403
2404 `zoom`'s config overrides.
2405
2406 - `defer_loading: optional boolean or null`
2407
2408 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2409
2410 - `enabled: optional boolean or null`
2411
2412 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.
16052413
16062414 - `ToolTextEditor20250124 object { name, type, allowed_callers, 4 more }`
16072415
from line 3156
23483156 "role": "user"
23493157 }
23503158 ],
2351 "model": "claude-opus-4-6"
3159 "model": "claude-opus-5"
23523160 }
23533161 }
23543162 ]
23553163
api/messages/batches/results Changed · +25 / -1 lines
from line 59
5959
6060 The time at which the container will expire.
6161
62 - `skills: array of ContainerSkill or null`
63
64 Skills loaded in the container
65
66 - `skill_id: string`
67
68 Skill ID
69
70 - `type: "anthropic" or "custom"`
71
72 Type of skill - either 'anthropic' (built-in) or 'custom' (user-defined)
73
74 - `"anthropic"`
75
76 - `"custom"`
77
78 - `version: string`
79
80 Skill version or 'latest' for most recent version
81
6282 - `content: array of ContentBlock`
6383
6484 Content generated by the model.
from line 264
244264
245265 - `"redacted_thinking"`
246266
247 - `ToolUseBlock object { id, caller, input, 2 more }`
267 - `ToolUseBlock object { id, caller, input, 3 more }`
248268
249269 - `id: string`
250270
from line 305
285305 - `type: "tool_use"`
286306
287307 - `"tool_use"`
308
309 - `toolset_name: optional string or null`
310
311 For a toolset member tool_use, the toolset family.
288312
289313 - `ServerToolUseBlock object { id, caller, input, 2 more }`
290314
api/messages/count_tokens Changed · +818 / -40 lines
The two sides of this change are more than 400 edits apart, too far apart to line up, so this is the differ's own diff of it and the words inside a line are not marked.
from line 215
215215
216216 - `"search_result_location"`
217217
218 - `ImageBlockParam object { source, type, cache_control }`
219
220 - `source: Base64ImageSource or URLImageSource`
218 - `ImageBlockParam object { source, type, cache_control, transformations }`
219
220 - `source: Base64ImageSource or URLImageSource or FileImageSource`
221221
222222 - `Base64ImageSource object { data, media_type, type }`
223223
from line 245
245245
246246 - `url: string`
247247
248 - `FileImageSource object { file_id, type }`
249
250 - `file_id: string`
251
252 - `type: "file"`
253
254 - `"file"`
255
248256 - `type: "image"`
249257
250258 - `"image"`
from line 261
253261
254262 Create a cache control breakpoint at this content block.
255263
264 - `transformations: optional ImageTransformationsParam or null`
265
266 Configures the transformations the server applies to this image before the model observes it. Each key names a condition the server transforms images for; its value selects the transformation applied. Omitted keys keep their default behavior, and an empty object is equivalent to omitting the field.
267
268 - `oversized_image: optional "downsize" or "error"`
269
270 What the server does when this image exceeds the model's maximum image size. `"downsize"` (the default) scales the image down to fit, which changes the dimensions the model observes without telling you. `"error"` instead rejects the request with a 400 error naming the image's dimensions and the largest dimensions that fit, so you can scale the image deliberately — your image is never silently scaled down.
271
272 - `"downsize"`
273
274 - `"error"`
275
256276 - `DocumentBlockParam object { source, type, cache_control, 3 more }`
257277
258 - `source: Base64PDFSource or PlainTextSource or ContentBlockSource or URLPDFSource`
278 - `source: Base64PDFSource or PlainTextSource or ContentBlockSource or 2 more`
259279
260280 - `Base64PDFSource object { data, media_type, type }`
261281
from line 311
291311
292312 - `TextBlockParam object { text, type, cache_control, citations }`
293313
294 - `ImageBlockParam object { source, type, cache_control }`
314 - `ImageBlockParam object { source, type, cache_control, transformations }`
295315
296316 - `type: "content"`
297317
from line 325
305325
306326 - `url: string`
307327
328 - `FileDocumentSource object { file_id, type }`
329
330 - `file_id: string`
331
332 - `type: "file"`
333
334 - `"file"`
335
308336 - `type: "document"`
309337
310338 - `"document"`
from line 403
375403
376404 - `"redacted_thinking"`
377405
378 - `ToolUseBlockParam object { id, input, name, 3 more }`
406 - `ToolUseBlockParam object { id, input, name, 4 more }`
379407
380408 - `id: string`
381409
from line 449
421449
422450 - `"code_execution_20260120"`
423451
424 - `ToolResultBlockParam object { tool_use_id, type, cache_control, 2 more }`
452 - `toolset_name: optional string or null`
453
454 For a toolset member tool_use, the toolset family this member belongs to.
455
456 - `ToolResultBlockParam object { tool_use_id, type, cache_control, 3 more }`
425457
426458 - `tool_use_id: string`
427459
from line 465
433465
434466 Create a cache control breakpoint at this content block.
435467
436 - `content: optional string or array of TextBlockParam or ImageBlockParam or SearchResultBlockParam or 2 more`
468 - `content: optional string or array of TextBlockParam or ImageBlockParam or SearchResultBlockParam or 3 more`
437469
438470 - `string`
439471
440 - `array of TextBlockParam or ImageBlockParam or SearchResultBlockParam or 2 more`
472 - `array of TextBlockParam or ImageBlockParam or SearchResultBlockParam or 3 more`
441473
442474 - `TextBlockParam object { text, type, cache_control, citations }`
443475
444 - `ImageBlockParam object { source, type, cache_control }`
476 - `ImageBlockParam object { source, type, cache_control, transformations }`
445477
446478 - `SearchResultBlockParam object { content, source, title, 3 more }`
447479
from line 493
461493
462494 Create a cache control breakpoint at this content block.
463495
496 - `BrowserStateBlockParam object { tabs, type, cache_control, state_changes }`
497
498 The caller's browser state after a browser toolset member call —
499 the full inventory of open tabs, which tab is active, and any side
500 effects (tabs opened, download state changes) the call produced.
501
502 At most one per `tool_result`, only on a non-error result answering a
503 browser toolset member `tool_use`. The server renders the
504 model-visible text from it; the model never sees the raw fields.
505
506 - `tabs: array of BrowserStateTabEntry`
507
508 All tabs open in the browser after this call — the full inventory, not a delta. May be empty. Whenever non-empty, exactly one entry carries `active: true`.
509
510 - `tab_id: string`
511
512 The caller-assigned identifier for this tab, unique within the inventory.
513
514 - `title: string`
515
516 The title of the page the tab is showing. May be empty.
517
518 - `url: string`
519
520 The URL of the page the tab is showing. May be empty.
521
522 - `active: optional boolean`
523
524 Whether this tab is the active tab after this call. Whenever `tabs` is non-empty, exactly one entry is marked `active: true`.
525
526 - `type: "browser_state"`
527
528 - `"browser_state"`
529
530 - `cache_control: optional CacheControlEphemeral or null`
531
532 Create a cache control breakpoint at this content block.
533
534 - `state_changes: optional array of BrowserStateChange or null`
535
536 Tabs opened and download state changes during this call. "Nothing to report" is expressed by omitting the field, never by an empty list.
537
538 - `BrowserStateChangeTabOpened object { tab_id, type }`
539
540 A tab this call's execution opened that remains open at its end —
541 the creation delta of the `tabs` inventory, not an event log.
542
543 Carries only the `tab_id`; the tab's `title` and `url` live on its
544 `tabs` entry, which must include the same `tab_id`. A tab opened
545 during a failed call gets no deferred `tab_opened`; it simply appears
546 in the next result's `tabs` inventory.
547
548 - `tab_id: string`
549
550 The `tab_id` of the opened tab, present in `tabs`.
551
552 - `type: "tab_opened"`
553
554 - `"tab_opened"`
555
556 - `BrowserStateChangeDownloadStarted object { download_id, type, url }`
557
558 A file download that started during this call.
559
560 - `download_id: string`
561
562 The caller-assigned identifier for this download, stable across the state changes reporting it.
563
564 - `type: "download_started"`
565
566 - `"download_started"`
567
568 - `url: string`
569
570 The final post-redirect URL the download was served from.
571
572 - `BrowserStateChangeDownloadCompleted object { download_id, type, url, 2 more }`
573
574 A file download that finished during this call, reported with the
575 same `download_id` as its `download_started` — or without a prior
576 `download_started`, when the download finished during the call that
577 started it (at most one state change per `download_id` per result).
578
579 - `download_id: string`
580
581 The caller-assigned identifier for this download, stable across the state changes reporting it.
582
583 - `type: "download_completed"`
584
585 - `"download_completed"`
586
587 - `url: string`
588
589 The final post-redirect URL the download was served from.
590
591 - `path: optional string or null`
592
593 Where the executor saved the file, on the executor's filesystem. Only included when another tool in the same environment can read the file at that path.
594
595 - `size_bytes: optional number or null`
596
597 The completed download's size.
598
599 - `BrowserStateChangeDownloadFailed object { download_id, type, url, error }`
600
601 A file download that failed — or was cancelled — during this call.
602
603 - `download_id: string`
604
605 The caller-assigned identifier for this download, stable across the state changes reporting it.
606
607 - `type: "download_failed"`
608
609 - `"download_failed"`
610
611 - `url: string`
612
613 The final post-redirect URL the download was served from.
614
615 - `error: optional string or null`
616
617 The failure or cancellation detail, when known.
618
464619 - `is_error: optional boolean`
620
621 - `toolset_name: optional string or null`
622
623 For a toolset member tool_result, the toolset family of the paired tool_use.
465624
466625 - `ServerToolUseBlockParam object { id, input, name, 3 more }`
467626
from line 1060
9011060 - `type: "container_upload"`
9021061
9031062 - `"container_upload"`
904
905 - `cache_control: optional CacheControlEphemeral or null`
906
907 Create a cache control breakpoint at this content block.
908
909 - `MidConversationSystemBlockParam object { content, type, cache_control }`
910
911 System instructions that appear mid-conversation.
912
913 Use this block to provide or update system-level instructions at a specific
914 point in the conversation, rather than only via the top-level `system` parameter.
915
916 - `content: array of TextBlockParam`
917
918 System instruction text blocks.
919
920 - `text: string`
921
922 - `type: "text"`
923
924 - `cache_control: optional CacheControlEphemeral or null`
925
926 Create a cache control breakpoint at this content block.
927
928 - `citations: optional array of TextCitationParam or null`
929
930 - `type: "mid_conv_system"`
931
932 - `"mid_conv_system"`
9331063
9341064 - `cache_control: optional CacheControlEphemeral or null`
9351065
from line 1619
14891619
14901620 When true, guarantees schema validation on tool names and inputs
14911621
1622 - `BrowserToolset20260801 object { type, allowed_callers, cache_control, configs }`
1623
1624 The browser toolset: a single `tools[]` entry (carrying no
1625 `name`) that declares the browser tool family. The model is served
1626 the family's tool with any members disabled via `configs` removed
1627 from its schema.
1628
1629 - `type: "browser_toolset_20260801"`
1630
1631 - `"browser_toolset_20260801"`
1632
1633 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
1634
1635 - `"direct"`
1636
1637 - `"code_execution_20250825"`
1638
1639 - `"code_execution_20260120"`
1640
1641 - `"code_execution_20260521"`
1642
1643 - `cache_control: optional CacheControlEphemeral or null`
1644
1645 Create a cache control breakpoint at this content block.
1646
1647 - `configs: optional BrowserToolsetConfigs or null`
1648
1649 Per-member configuration for `browser_toolset_20260801`: one
1650 optional field per member tool, keyed by the member name — the same
1651 name the member's `tool_use` blocks carry. Every member is an
1652 accepted key, and a member's defaults apply wherever its key is
1653 absent. Unknown keys are rejected: the field set is this toolset
1654 version's complete member set.
1655
1656 - `close_tab: optional BrowserCloseTabConfig or null`
1657
1658 `close_tab`'s config overrides.
1659
1660 - `defer_loading: optional boolean or null`
1661
1662 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1663
1664 - `enabled: optional boolean or null`
1665
1666 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.
1667
1668 - `double_click: optional BrowserDoubleClickConfig or null`
1669
1670 `double_click`'s config overrides.
1671
1672 - `defer_loading: optional boolean or null`
1673
1674 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1675
1676 - `enabled: optional boolean or null`
1677
1678 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.
1679
1680 - `file_upload: optional BrowserFileUploadConfig or null`
1681
1682 `file_upload`'s config overrides.
1683
1684 - `defer_loading: optional boolean or null`
1685
1686 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1687
1688 - `enabled: optional boolean or null`
1689
1690 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.
1691
1692 - `find: optional BrowserFindConfig or null`
1693
1694 `find`'s config overrides.
1695
1696 - `defer_loading: optional boolean or null`
1697
1698 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1699
1700 - `enabled: optional boolean or null`
1701
1702 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.
1703
1704 - `form_input: optional BrowserFormInputConfig or null`
1705
1706 `form_input`'s config overrides.
1707
1708 - `defer_loading: optional boolean or null`
1709
1710 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1711
1712 - `enabled: optional boolean or null`
1713
1714 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.
1715
1716 - `get_page_text: optional BrowserGetPageTextConfig or null`
1717
1718 `get_page_text`'s config overrides.
1719
1720 - `defer_loading: optional boolean or null`
1721
1722 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1723
1724 - `enabled: optional boolean or null`
1725
1726 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.
1727
1728 - `hold_key: optional BrowserHoldKeyConfig or null`
1729
1730 `hold_key`'s config overrides.
1731
1732 - `defer_loading: optional boolean or null`
1733
1734 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1735
1736 - `enabled: optional boolean or null`
1737
1738 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.
1739
1740 - `hover: optional BrowserHoverConfig or null`
1741
1742 `hover`'s config overrides.
1743
1744 - `defer_loading: optional boolean or null`
1745
1746 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1747
1748 - `enabled: optional boolean or null`
1749
1750 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.
1751
1752 - `javascript_exec: optional BrowserJavascriptExecConfig or null`
1753
1754 `javascript_exec`'s config overrides.
1755
1756 - `defer_loading: optional boolean or null`
1757
1758 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1759
1760 - `enabled: optional boolean or null`
1761
1762 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.
1763
1764 - `key: optional BrowserKeyConfig or null`
1765
1766 `key`'s config overrides.
1767
1768 - `defer_loading: optional boolean or null`
1769
1770 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1771
1772 - `enabled: optional boolean or null`
1773
1774 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.
1775
1776 - `left_click: optional BrowserLeftClickConfig or null`
1777
1778 `left_click`'s config overrides.
1779
1780 - `defer_loading: optional boolean or null`
1781
1782 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1783
1784 - `enabled: optional boolean or null`
1785
1786 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.
1787
1788 - `left_click_drag: optional BrowserLeftClickDragConfig or null`
1789
1790 `left_click_drag`'s config overrides.
1791
1792 - `defer_loading: optional boolean or null`
1793
1794 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1795
1796 - `enabled: optional boolean or null`
1797
1798 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.
1799
1800 - `left_mouse_down: optional BrowserLeftMouseDownConfig or null`
1801
1802 `left_mouse_down`'s config overrides.
1803
1804 - `defer_loading: optional boolean or null`
1805
1806 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1807
1808 - `enabled: optional boolean or null`
1809
1810 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.
1811
1812 - `left_mouse_up: optional BrowserLeftMouseUpConfig or null`
1813
1814 `left_mouse_up`'s config overrides.
1815
1816 - `defer_loading: optional boolean or null`
1817
1818 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1819
1820 - `enabled: optional boolean or null`
1821
1822 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.
1823
1824 - `list_tabs: optional BrowserListTabsConfig or null`
1825
1826 `list_tabs`'s config overrides.
1827
1828 - `defer_loading: optional boolean or null`
1829
1830 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1831
1832 - `enabled: optional boolean or null`
1833
1834 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.
1835
1836 - `middle_click: optional BrowserMiddleClickConfig or null`
1837
1838 `middle_click`'s config overrides.
1839
1840 - `defer_loading: optional boolean or null`
1841
1842 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1843
1844 - `enabled: optional boolean or null`
1845
1846 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.
1847
1848 - `mouse_move: optional BrowserMouseMoveConfig or null`
1849
1850 `mouse_move`'s config overrides.
1851
1852 - `defer_loading: optional boolean or null`
1853
1854 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1855
1856 - `enabled: optional boolean or null`
1857
1858 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.
1859
1860 - `navigate: optional BrowserNavigateConfig or null`
1861
1862 `navigate`'s config overrides.
1863
1864 - `defer_loading: optional boolean or null`
1865
1866 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1867
1868 - `enabled: optional boolean or null`
1869
1870 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.
1871
1872 - `new_tab: optional BrowserNewTabConfig or null`
1873
1874 `new_tab`'s config overrides.
1875
1876 - `defer_loading: optional boolean or null`
1877
1878 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1879
1880 - `enabled: optional boolean or null`
1881
1882 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.
1883
1884 - `read_console: optional BrowserReadConsoleConfig or null`
1885
1886 `read_console`'s config overrides.
1887
1888 - `defer_loading: optional boolean or null`
1889
1890 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1891
1892 - `enabled: optional boolean or null`
1893
1894 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.
1895
1896 - `read_network: optional BrowserReadNetworkConfig or null`
1897
1898 `read_network`'s config overrides.
1899
1900 - `defer_loading: optional boolean or null`
1901
1902 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1903
1904 - `enabled: optional boolean or null`
1905
1906 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.
1907
1908 - `read_page: optional BrowserReadPageConfig or null`
1909
1910 `read_page`'s config overrides.
1911
1912 - `defer_loading: optional boolean or null`
1913
1914 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1915
1916 - `enabled: optional boolean or null`
1917
1918 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.
1919
1920 - `right_click: optional BrowserRightClickConfig or null`
1921
1922 `right_click`'s config overrides.
1923
1924 - `defer_loading: optional boolean or null`
1925
1926 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1927
1928 - `enabled: optional boolean or null`
1929
1930 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.
1931
1932 - `screenshot: optional BrowserScreenshotConfig or null`
1933
1934 `screenshot`'s config overrides.
1935
1936 - `defer_loading: optional boolean or null`
1937
1938 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1939
1940 - `enabled: optional boolean or null`
1941
1942 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.
1943
1944 - `scroll: optional BrowserScrollConfig or null`
1945
1946 `scroll`'s config overrides.
1947
1948 - `defer_loading: optional boolean or null`
1949
1950 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1951
1952 - `enabled: optional boolean or null`
1953
1954 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.
1955
1956 - `scroll_to: optional BrowserScrollToConfig or null`
1957
1958 `scroll_to`'s config overrides.
1959
1960 - `defer_loading: optional boolean or null`
1961
1962 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1963
1964 - `enabled: optional boolean or null`
1965
1966 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.
1967
1968 - `switch_tab: optional BrowserSwitchTabConfig or null`
1969
1970 `switch_tab`'s config overrides.
1971
1972 - `defer_loading: optional boolean or null`
1973
1974 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1975
1976 - `enabled: optional boolean or null`
1977
1978 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.
1979
1980 - `triple_click: optional BrowserTripleClickConfig or null`
1981
1982 `triple_click`'s config overrides.
1983
1984 - `defer_loading: optional boolean or null`
1985
1986 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1987
1988 - `enabled: optional boolean or null`
1989
1990 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.
1991
1992 - `type: optional BrowserTypeConfig or null`
1993
1994 `type`'s config overrides.
1995
1996 - `defer_loading: optional boolean or null`
1997
1998 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1999
2000 - `enabled: optional boolean or null`
2001
2002 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.
2003
2004 - `wait: optional BrowserWaitConfig or null`
2005
2006 `wait`'s config overrides.
2007
2008 - `defer_loading: optional boolean or null`
2009
2010 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2011
2012 - `enabled: optional boolean or null`
2013
2014 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.
2015
2016 - `zoom: optional BrowserZoomConfig or null`
2017
2018 `zoom`'s config overrides.
2019
2020 - `defer_loading: optional boolean or null`
2021
2022 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2023
2024 - `enabled: optional boolean or null`
2025
2026 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.
2027
14922028 - `MemoryTool20250818 object { name, type, allowed_callers, 4 more }`
14932029
14942030 - `name: "memory"`
from line 2062
15262062 - `strict: optional boolean`
15272063
15282064 When true, guarantees schema validation on tool names and inputs
2065
2066 - `ComputerToolset20260801 object { type, allowed_callers, cache_control, configs }`
2067
2068 The computer toolset: a single `tools[]` entry (carrying no
2069 `name`) that declares the computer tool family. The model is
2070 served the family's tool with any members disabled via `configs`
2071 removed from its schema. Every member is enabled by default, zoom
2072 included. The single-tool options `display_number` and
2073 `enable_zoom` are not fields of a toolset entry — it carries only
2074 `type`, `configs`, and `cache_control`; zoom is controlled
2075 via `configs.zoom.enabled`.
2076
2077 - `type: "computer_toolset_20260801"`
2078
2079 - `"computer_toolset_20260801"`
2080
2081 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
2082
2083 - `"direct"`
2084
2085 - `"code_execution_20250825"`
2086
2087 - `"code_execution_20260120"`
2088
2089 - `"code_execution_20260521"`
2090
2091 - `cache_control: optional CacheControlEphemeral or null`
2092
2093 Create a cache control breakpoint at this content block.
2094
2095 - `configs: optional ComputerToolsetConfigs or null`
2096
2097 Per-member configuration for `computer_toolset_20260801`: one
2098 optional field per member tool, keyed by the member name — the same
2099 name the member's `tool_use` blocks carry. Every member is an
2100 accepted key, and a member's defaults apply wherever its key is
2101 absent. Unknown keys are rejected: the field set is this toolset
2102 version's complete member set.
2103
2104 - `cursor_position: optional ComputerCursorPositionConfig or null`
2105
2106 `cursor_position`'s config overrides.
2107
2108 - `defer_loading: optional boolean or null`
2109
2110 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2111
2112 - `enabled: optional boolean or null`
2113
2114 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.
2115
2116 - `double_click: optional ComputerDoubleClickConfig or null`
2117
2118 `double_click`'s config overrides.
2119
2120 - `defer_loading: optional boolean or null`
2121
2122 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2123
2124 - `enabled: optional boolean or null`
2125
2126 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.
2127
2128 - `hold_key: optional ComputerHoldKeyConfig or null`
2129
2130 `hold_key`'s config overrides.
2131
2132 - `defer_loading: optional boolean or null`
2133
2134 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2135
2136 - `enabled: optional boolean or null`
2137
2138 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.
2139
2140 - `key: optional ComputerKeyConfig or null`
2141
2142 `key`'s config overrides.
2143
2144 - `defer_loading: optional boolean or null`
2145
2146 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2147
2148 - `enabled: optional boolean or null`
2149
2150 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.
2151
2152 - `left_click: optional ComputerLeftClickConfig or null`
2153
2154 `left_click`'s config overrides.
2155
2156 - `defer_loading: optional boolean or null`
2157
2158 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2159
2160 - `enabled: optional boolean or null`
2161
2162 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.
2163
2164 - `left_click_drag: optional ComputerLeftClickDragConfig or null`
2165
2166 `left_click_drag`'s config overrides.
2167
2168 - `defer_loading: optional boolean or null`
2169
2170 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2171
2172 - `enabled: optional boolean or null`
2173
2174 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.
2175
2176 - `left_mouse_down: optional ComputerLeftMouseDownConfig or null`
2177
2178 `left_mouse_down`'s config overrides.
2179
2180 - `defer_loading: optional boolean or null`
2181
2182 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2183
2184 - `enabled: optional boolean or null`
2185
2186 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.
2187
2188 - `left_mouse_up: optional ComputerLeftMouseUpConfig or null`
2189
2190 `left_mouse_up`'s config overrides.
2191
2192 - `defer_loading: optional boolean or null`
2193
2194 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2195
2196 - `enabled: optional boolean or null`
2197
2198 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.
2199
2200 - `middle_click: optional ComputerMiddleClickConfig or null`
2201
2202 `middle_click`'s config overrides.
2203
2204 - `defer_loading: optional boolean or null`
2205
2206 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2207
2208 - `enabled: optional boolean or null`
2209
2210 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.
2211
2212 - `mouse_move: optional ComputerMouseMoveConfig or null`
2213
2214 `mouse_move`'s config overrides.
2215
2216 - `defer_loading: optional boolean or null`
2217
2218 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2219
2220 - `enabled: optional boolean or null`
2221
2222 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.
2223
2224 - `right_click: optional ComputerRightClickConfig or null`
2225
2226 `right_click`'s config overrides.
2227
2228 - `defer_loading: optional boolean or null`
2229
2230 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2231
2232 - `enabled: optional boolean or null`
2233
2234 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.
2235
2236 - `screenshot: optional ComputerScreenshotConfig or null`
2237
2238 `screenshot`'s config overrides.
2239
2240 - `defer_loading: optional boolean or null`
2241
2242 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2243
2244 - `enabled: optional boolean or null`
2245
2246 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.
2247
2248 - `scroll: optional ComputerScrollConfig or null`
2249
2250 `scroll`'s config overrides.
2251
2252 - `defer_loading: optional boolean or null`
2253
2254 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2255
2256 - `enabled: optional boolean or null`
2257
2258 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.
2259
2260 - `triple_click: optional ComputerTripleClickConfig or null`
2261
2262 `triple_click`'s config overrides.
2263
2264 - `defer_loading: optional boolean or null`
2265
2266 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2267
2268 - `enabled: optional boolean or null`
2269
2270 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.
2271
2272 - `type: optional ComputerTypeConfig or null`
2273
2274 `type`'s config overrides.
2275
2276 - `defer_loading: optional boolean or null`
2277
2278 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2279
2280 - `enabled: optional boolean or null`
2281
2282 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.
2283
2284 - `wait: optional ComputerWaitConfig or null`
2285
2286 `wait`'s config overrides.
2287
2288 - `defer_loading: optional boolean or null`
2289
2290 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2291
2292 - `enabled: optional boolean or null`
2293
2294 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.
2295
2296 - `zoom: optional ComputerZoomConfig or null`
2297
2298 `zoom`'s config overrides.
2299
2300 - `defer_loading: optional boolean or null`
2301
2302 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2303
2304 - `enabled: optional boolean or null`
2305
2306 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.
15292307
15302308 - `ToolTextEditor20250124 object { name, type, allowed_callers, 4 more }`
15312309
from line 2947
21692947 "role": "user"
21702948 }
21712949 ],
2172 "model": "claude-opus-4-6",
2950 "model": "claude-opus-5",
21732951 "system": [
21742952 {
21752953 "text": "Today'\''s date is 2024-06-01.",
21762954
api/messages/create Changed · +883 / -44 lines
The two sides of this change are more than 400 edits apart, too far apart to line up, so this is the differ's own diff of it and the words inside a line are not marked.
from line 225
225225
226226 - `"search_result_location"`
227227
228 - `ImageBlockParam object { source, type, cache_control }`
229
230 - `source: Base64ImageSource or URLImageSource`
228 - `ImageBlockParam object { source, type, cache_control, transformations }`
229
230 - `source: Base64ImageSource or URLImageSource or FileImageSource`
231231
232232 - `Base64ImageSource object { data, media_type, type }`
233233
from line 255
255255
256256 - `url: string`
257257
258 - `FileImageSource object { file_id, type }`
259
260 - `file_id: string`
261
262 - `type: "file"`
263
264 - `"file"`
265
258266 - `type: "image"`
259267
260268 - `"image"`
from line 271
263271
264272 Create a cache control breakpoint at this content block.
265273
274 - `transformations: optional ImageTransformationsParam or null`
275
276 Configures the transformations the server applies to this image before the model observes it. Each key names a condition the server transforms images for; its value selects the transformation applied. Omitted keys keep their default behavior, and an empty object is equivalent to omitting the field.
277
278 - `oversized_image: optional "downsize" or "error"`
279
280 What the server does when this image exceeds the model's maximum image size. `"downsize"` (the default) scales the image down to fit, which changes the dimensions the model observes without telling you. `"error"` instead rejects the request with a 400 error naming the image's dimensions and the largest dimensions that fit, so you can scale the image deliberately — your image is never silently scaled down.
281
282 - `"downsize"`
283
284 - `"error"`
285
266286 - `DocumentBlockParam object { source, type, cache_control, 3 more }`
267287
268 - `source: Base64PDFSource or PlainTextSource or ContentBlockSource or URLPDFSource`
288 - `source: Base64PDFSource or PlainTextSource or ContentBlockSource or 2 more`
269289
270290 - `Base64PDFSource object { data, media_type, type }`
271291
from line 321
301321
302322 - `TextBlockParam object { text, type, cache_control, citations }`
303323
304 - `ImageBlockParam object { source, type, cache_control }`
324 - `ImageBlockParam object { source, type, cache_control, transformations }`
305325
306326 - `type: "content"`
307327
from line 335
315335
316336 - `url: string`
317337
338 - `FileDocumentSource object { file_id, type }`
339
340 - `file_id: string`
341
342 - `type: "file"`
343
344 - `"file"`
345
318346 - `type: "document"`
319347
320348 - `"document"`
from line 413
385413
386414 - `"redacted_thinking"`
387415
388 - `ToolUseBlockParam object { id, input, name, 3 more }`
416 - `ToolUseBlockParam object { id, input, name, 4 more }`
389417
390418 - `id: string`
391419
from line 459
431459
432460 - `"code_execution_20260120"`
433461
434 - `ToolResultBlockParam object { tool_use_id, type, cache_control, 2 more }`
462 - `toolset_name: optional string or null`
463
464 For a toolset member tool_use, the toolset family this member belongs to.
465
466 - `ToolResultBlockParam object { tool_use_id, type, cache_control, 3 more }`
435467
436468 - `tool_use_id: string`
437469
from line 475
443475
444476 Create a cache control breakpoint at this content block.
445477
446 - `content: optional string or array of TextBlockParam or ImageBlockParam or SearchResultBlockParam or 2 more`
478 - `content: optional string or array of TextBlockParam or ImageBlockParam or SearchResultBlockParam or 3 more`
447479
448480 - `string`
449481
450 - `array of TextBlockParam or ImageBlockParam or SearchResultBlockParam or 2 more`
482 - `array of TextBlockParam or ImageBlockParam or SearchResultBlockParam or 3 more`
451483
452484 - `TextBlockParam object { text, type, cache_control, citations }`
453485
454 - `ImageBlockParam object { source, type, cache_control }`
486 - `ImageBlockParam object { source, type, cache_control, transformations }`
455487
456488 - `SearchResultBlockParam object { content, source, title, 3 more }`
457489
from line 503
471503
472504 Create a cache control breakpoint at this content block.
473505
506 - `BrowserStateBlockParam object { tabs, type, cache_control, state_changes }`
507
508 The caller's browser state after a browser toolset member call —
509 the full inventory of open tabs, which tab is active, and any side
510 effects (tabs opened, download state changes) the call produced.
511
512 At most one per `tool_result`, only on a non-error result answering a
513 browser toolset member `tool_use`. The server renders the
514 model-visible text from it; the model never sees the raw fields.
515
516 - `tabs: array of BrowserStateTabEntry`
517
518 All tabs open in the browser after this call — the full inventory, not a delta. May be empty. Whenever non-empty, exactly one entry carries `active: true`.
519
520 - `tab_id: string`
521
522 The caller-assigned identifier for this tab, unique within the inventory.
523
524 - `title: string`
525
526 The title of the page the tab is showing. May be empty.
527
528 - `url: string`
529
530 The URL of the page the tab is showing. May be empty.
531
532 - `active: optional boolean`
533
534 Whether this tab is the active tab after this call. Whenever `tabs` is non-empty, exactly one entry is marked `active: true`.
535
536 - `type: "browser_state"`
537
538 - `"browser_state"`
539
540 - `cache_control: optional CacheControlEphemeral or null`
541
542 Create a cache control breakpoint at this content block.
543
544 - `state_changes: optional array of BrowserStateChange or null`
545
546 Tabs opened and download state changes during this call. "Nothing to report" is expressed by omitting the field, never by an empty list.
547
548 - `BrowserStateChangeTabOpened object { tab_id, type }`
549
550 A tab this call's execution opened that remains open at its end —
551 the creation delta of the `tabs` inventory, not an event log.
552
553 Carries only the `tab_id`; the tab's `title` and `url` live on its
554 `tabs` entry, which must include the same `tab_id`. A tab opened
555 during a failed call gets no deferred `tab_opened`; it simply appears
556 in the next result's `tabs` inventory.
557
558 - `tab_id: string`
559
560 The `tab_id` of the opened tab, present in `tabs`.
561
562 - `type: "tab_opened"`
563
564 - `"tab_opened"`
565
566 - `BrowserStateChangeDownloadStarted object { download_id, type, url }`
567
568 A file download that started during this call.
569
570 - `download_id: string`
571
572 The caller-assigned identifier for this download, stable across the state changes reporting it.
573
574 - `type: "download_started"`
575
576 - `"download_started"`
577
578 - `url: string`
579
580 The final post-redirect URL the download was served from.
581
582 - `BrowserStateChangeDownloadCompleted object { download_id, type, url, 2 more }`
583
584 A file download that finished during this call, reported with the
585 same `download_id` as its `download_started` — or without a prior
586 `download_started`, when the download finished during the call that
587 started it (at most one state change per `download_id` per result).
588
589 - `download_id: string`
590
591 The caller-assigned identifier for this download, stable across the state changes reporting it.
592
593 - `type: "download_completed"`
594
595 - `"download_completed"`
596
597 - `url: string`
598
599 The final post-redirect URL the download was served from.
600
601 - `path: optional string or null`
602
603 Where the executor saved the file, on the executor's filesystem. Only included when another tool in the same environment can read the file at that path.
604
605 - `size_bytes: optional number or null`
606
607 The completed download's size.
608
609 - `BrowserStateChangeDownloadFailed object { download_id, type, url, error }`
610
611 A file download that failed — or was cancelled — during this call.
612
613 - `download_id: string`
614
615 The caller-assigned identifier for this download, stable across the state changes reporting it.
616
617 - `type: "download_failed"`
618
619 - `"download_failed"`
620
621 - `url: string`
622
623 The final post-redirect URL the download was served from.
624
625 - `error: optional string or null`
626
627 The failure or cancellation detail, when known.
628
474629 - `is_error: optional boolean`
630
631 - `toolset_name: optional string or null`
632
633 For a toolset member tool_result, the toolset family of the paired tool_use.
475634
476635 - `ServerToolUseBlockParam object { id, input, name, 3 more }`
477636
from line 1075
9161075
9171076 Create a cache control breakpoint at this content block.
9181077
919 - `MidConversationSystemBlockParam object { content, type, cache_control }`
920
921 System instructions that appear mid-conversation.
922
923 Use this block to provide or update system-level instructions at a specific
924 point in the conversation, rather than only via the top-level `system` parameter.
925
926 - `content: array of TextBlockParam`
927
928 System instruction text blocks.
929
930 - `text: string`
931
932 - `type: "text"`
933
934 - `cache_control: optional CacheControlEphemeral or null`
935
936 Create a cache control breakpoint at this content block.
937
938 - `citations: optional array of TextCitationParam or null`
939
940 - `type: "mid_conv_system"`
941
942 - `"mid_conv_system"`
943
944 - `cache_control: optional CacheControlEphemeral or null`
945
946 Create a cache control breakpoint at this content block.
947
9481078 - `role: "user" or "assistant" or "system"`
9491079
9501080 - `"user"`
from line 1161
10311161
10321162 Top-level cache control automatically applies a cache_control marker to the last cacheable block in the request.
10331163
1034- `container: optional string or null`
1164- `container: optional MessageCreateParamsContainer or null`
10351165
10361166 Container identifier for reuse across requests.
1167
1168 - `ContainerParams object { id, skills }`
1169
1170 Container parameters with skills to be loaded.
1171
1172 - `id: optional string or null`
1173
1174 Container id
1175
1176 - `skills: optional array of SkillParams or null`
1177
1178 List of skills to load in the container
1179
1180 - `skill_id: string`
1181
1182 Skill ID
1183
1184 - `type: "anthropic" or "custom"`
1185
1186 Type of skill - either 'anthropic' (built-in) or 'custom' (user-defined)
1187
1188 - `"anthropic"`
1189
1190 - `"custom"`
1191
1192 - `version: optional string`
1193
1194 Skill version or 'latest' for most recent version
1195
1196 - `string`
10371197
10381198- `inference_geo: optional string or null`
10391199
from line 1709
15491709
15501710 When true, guarantees schema validation on tool names and inputs
15511711
1712 - `BrowserToolset20260801 object { type, allowed_callers, cache_control, configs }`
1713
1714 The browser toolset: a single `tools[]` entry (carrying no
1715 `name`) that declares the browser tool family. The model is served
1716 the family's tool with any members disabled via `configs` removed
1717 from its schema.
1718
1719 - `type: "browser_toolset_20260801"`
1720
1721 - `"browser_toolset_20260801"`
1722
1723 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
1724
1725 - `"direct"`
1726
1727 - `"code_execution_20250825"`
1728
1729 - `"code_execution_20260120"`
1730
1731 - `"code_execution_20260521"`
1732
1733 - `cache_control: optional CacheControlEphemeral or null`
1734
1735 Create a cache control breakpoint at this content block.
1736
1737 - `configs: optional BrowserToolsetConfigs or null`
1738
1739 Per-member configuration for `browser_toolset_20260801`: one
1740 optional field per member tool, keyed by the member name — the same
1741 name the member's `tool_use` blocks carry. Every member is an
1742 accepted key, and a member's defaults apply wherever its key is
1743 absent. Unknown keys are rejected: the field set is this toolset
1744 version's complete member set.
1745
1746 - `close_tab: optional BrowserCloseTabConfig or null`
1747
1748 `close_tab`'s config overrides.
1749
1750 - `defer_loading: optional boolean or null`
1751
1752 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1753
1754 - `enabled: optional boolean or null`
1755
1756 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.
1757
1758 - `double_click: optional BrowserDoubleClickConfig or null`
1759
1760 `double_click`'s config overrides.
1761
1762 - `defer_loading: optional boolean or null`
1763
1764 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1765
1766 - `enabled: optional boolean or null`
1767
1768 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.
1769
1770 - `file_upload: optional BrowserFileUploadConfig or null`
1771
1772 `file_upload`'s config overrides.
1773
1774 - `defer_loading: optional boolean or null`
1775
1776 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1777
1778 - `enabled: optional boolean or null`
1779
1780 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.
1781
1782 - `find: optional BrowserFindConfig or null`
1783
1784 `find`'s config overrides.
1785
1786 - `defer_loading: optional boolean or null`
1787
1788 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1789
1790 - `enabled: optional boolean or null`
1791
1792 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.
1793
1794 - `form_input: optional BrowserFormInputConfig or null`
1795
1796 `form_input`'s config overrides.
1797
1798 - `defer_loading: optional boolean or null`
1799
1800 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1801
1802 - `enabled: optional boolean or null`
1803
1804 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.
1805
1806 - `get_page_text: optional BrowserGetPageTextConfig or null`
1807
1808 `get_page_text`'s config overrides.
1809
1810 - `defer_loading: optional boolean or null`
1811
1812 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1813
1814 - `enabled: optional boolean or null`
1815
1816 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.
1817
1818 - `hold_key: optional BrowserHoldKeyConfig or null`
1819
1820 `hold_key`'s config overrides.
1821
1822 - `defer_loading: optional boolean or null`
1823
1824 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1825
1826 - `enabled: optional boolean or null`
1827
1828 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.
1829
1830 - `hover: optional BrowserHoverConfig or null`
1831
1832 `hover`'s config overrides.
1833
1834 - `defer_loading: optional boolean or null`
1835
1836 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1837
1838 - `enabled: optional boolean or null`
1839
1840 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.
1841
1842 - `javascript_exec: optional BrowserJavascriptExecConfig or null`
1843
1844 `javascript_exec`'s config overrides.
1845
1846 - `defer_loading: optional boolean or null`
1847
1848 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1849
1850 - `enabled: optional boolean or null`
1851
1852 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.
1853
1854 - `key: optional BrowserKeyConfig or null`
1855
1856 `key`'s config overrides.
1857
1858 - `defer_loading: optional boolean or null`
1859
1860 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1861
1862 - `enabled: optional boolean or null`
1863
1864 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.
1865
1866 - `left_click: optional BrowserLeftClickConfig or null`
1867
1868 `left_click`'s config overrides.
1869
1870 - `defer_loading: optional boolean or null`
1871
1872 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1873
1874 - `enabled: optional boolean or null`
1875
1876 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.
1877
1878 - `left_click_drag: optional BrowserLeftClickDragConfig or null`
1879
1880 `left_click_drag`'s config overrides.
1881
1882 - `defer_loading: optional boolean or null`
1883
1884 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1885
1886 - `enabled: optional boolean or null`
1887
1888 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.
1889
1890 - `left_mouse_down: optional BrowserLeftMouseDownConfig or null`
1891
1892 `left_mouse_down`'s config overrides.
1893
1894 - `defer_loading: optional boolean or null`
1895
1896 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1897
1898 - `enabled: optional boolean or null`
1899
1900 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.
1901
1902 - `left_mouse_up: optional BrowserLeftMouseUpConfig or null`
1903
1904 `left_mouse_up`'s config overrides.
1905
1906 - `defer_loading: optional boolean or null`
1907
1908 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1909
1910 - `enabled: optional boolean or null`
1911
1912 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.
1913
1914 - `list_tabs: optional BrowserListTabsConfig or null`
1915
1916 `list_tabs`'s config overrides.
1917
1918 - `defer_loading: optional boolean or null`
1919
1920 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1921
1922 - `enabled: optional boolean or null`
1923
1924 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.
1925
1926 - `middle_click: optional BrowserMiddleClickConfig or null`
1927
1928 `middle_click`'s config overrides.
1929
1930 - `defer_loading: optional boolean or null`
1931
1932 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1933
1934 - `enabled: optional boolean or null`
1935
1936 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.
1937
1938 - `mouse_move: optional BrowserMouseMoveConfig or null`
1939
1940 `mouse_move`'s config overrides.
1941
1942 - `defer_loading: optional boolean or null`
1943
1944 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1945
1946 - `enabled: optional boolean or null`
1947
1948 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.
1949
1950 - `navigate: optional BrowserNavigateConfig or null`
1951
1952 `navigate`'s config overrides.
1953
1954 - `defer_loading: optional boolean or null`
1955
1956 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1957
1958 - `enabled: optional boolean or null`
1959
1960 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.
1961
1962 - `new_tab: optional BrowserNewTabConfig or null`
1963
1964 `new_tab`'s config overrides.
1965
1966 - `defer_loading: optional boolean or null`
1967
1968 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1969
1970 - `enabled: optional boolean or null`
1971
1972 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.
1973
1974 - `read_console: optional BrowserReadConsoleConfig or null`
1975
1976 `read_console`'s config overrides.
1977
1978 - `defer_loading: optional boolean or null`
1979
1980 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1981
1982 - `enabled: optional boolean or null`
1983
1984 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.
1985
1986 - `read_network: optional BrowserReadNetworkConfig or null`
1987
1988 `read_network`'s config overrides.
1989
1990 - `defer_loading: optional boolean or null`
1991
1992 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1993
1994 - `enabled: optional boolean or null`
1995
1996 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.
1997
1998 - `read_page: optional BrowserReadPageConfig or null`
1999
2000 `read_page`'s config overrides.
2001
2002 - `defer_loading: optional boolean or null`
2003
2004 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2005
2006 - `enabled: optional boolean or null`
2007
2008 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.
2009
2010 - `right_click: optional BrowserRightClickConfig or null`
2011
2012 `right_click`'s config overrides.
2013
2014 - `defer_loading: optional boolean or null`
2015
2016 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2017
2018 - `enabled: optional boolean or null`
2019
2020 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.
2021
2022 - `screenshot: optional BrowserScreenshotConfig or null`
2023
2024 `screenshot`'s config overrides.
2025
2026 - `defer_loading: optional boolean or null`
2027
2028 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2029
2030 - `enabled: optional boolean or null`
2031
2032 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.
2033
2034 - `scroll: optional BrowserScrollConfig or null`
2035
2036 `scroll`'s config overrides.
2037
2038 - `defer_loading: optional boolean or null`
2039
2040 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2041
2042 - `enabled: optional boolean or null`
2043
2044 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.
2045
2046 - `scroll_to: optional BrowserScrollToConfig or null`
2047
2048 `scroll_to`'s config overrides.
2049
2050 - `defer_loading: optional boolean or null`
2051
2052 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2053
2054 - `enabled: optional boolean or null`
2055
2056 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.
2057
2058 - `switch_tab: optional BrowserSwitchTabConfig or null`
2059
2060 `switch_tab`'s config overrides.
2061
2062 - `defer_loading: optional boolean or null`
2063
2064 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2065
2066 - `enabled: optional boolean or null`
2067
2068 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.
2069
2070 - `triple_click: optional BrowserTripleClickConfig or null`
2071
2072 `triple_click`'s config overrides.
2073
2074 - `defer_loading: optional boolean or null`
2075
2076 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2077
2078 - `enabled: optional boolean or null`
2079
2080 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.
2081
2082 - `type: optional BrowserTypeConfig or null`
2083
2084 `type`'s config overrides.
2085
2086 - `defer_loading: optional boolean or null`
2087
2088 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2089
2090 - `enabled: optional boolean or null`
2091
2092 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.
2093
2094 - `wait: optional BrowserWaitConfig or null`
2095
2096 `wait`'s config overrides.
2097
2098 - `defer_loading: optional boolean or null`
2099
2100 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2101
2102 - `enabled: optional boolean or null`
2103
2104 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.
2105
2106 - `zoom: optional BrowserZoomConfig or null`
2107
2108 `zoom`'s config overrides.
2109
2110 - `defer_loading: optional boolean or null`
2111
2112 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2113
2114 - `enabled: optional boolean or null`
2115
2116 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.
2117
15522118 - `MemoryTool20250818 object { name, type, allowed_callers, 4 more }`
15532119
15542120 - `name: "memory"`
from line 2153
15872153
15882154 When true, guarantees schema validation on tool names and inputs
15892155
2156 - `ComputerToolset20260801 object { type, allowed_callers, cache_control, configs }`
2157
2158 The computer toolset: a single `tools[]` entry (carrying no
2159 `name`) that declares the computer tool family. The model is
2160 served the family's tool with any members disabled via `configs`
2161 removed from its schema. Every member is enabled by default, zoom
2162 included. The single-tool options `display_number` and
2163 `enable_zoom` are not fields of a toolset entry — it carries only
2164 `type`, `configs`, and `cache_control`; zoom is controlled
2165 via `configs.zoom.enabled`.
2166
2167 - `type: "computer_toolset_20260801"`
2168
2169 - `"computer_toolset_20260801"`
2170
2171 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
2172
2173 - `"direct"`
2174
2175 - `"code_execution_20250825"`
2176
2177 - `"code_execution_20260120"`
2178
2179 - `"code_execution_20260521"`
2180
2181 - `cache_control: optional CacheControlEphemeral or null`
2182
2183 Create a cache control breakpoint at this content block.
2184
2185 - `configs: optional ComputerToolsetConfigs or null`
2186
2187 Per-member configuration for `computer_toolset_20260801`: one
2188 optional field per member tool, keyed by the member name — the same
2189 name the member's `tool_use` blocks carry. Every member is an
2190 accepted key, and a member's defaults apply wherever its key is
2191 absent. Unknown keys are rejected: the field set is this toolset
2192 version's complete member set.
2193
2194 - `cursor_position: optional ComputerCursorPositionConfig or null`
2195
2196 `cursor_position`'s config overrides.
2197
2198 - `defer_loading: optional boolean or null`
2199
2200 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2201
2202 - `enabled: optional boolean or null`
2203
2204 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.
2205
2206 - `double_click: optional ComputerDoubleClickConfig or null`
2207
2208 `double_click`'s config overrides.
2209
2210 - `defer_loading: optional boolean or null`
2211
2212 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2213
2214 - `enabled: optional boolean or null`
2215
2216 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.
2217
2218 - `hold_key: optional ComputerHoldKeyConfig or null`
2219
2220 `hold_key`'s config overrides.
2221
2222 - `defer_loading: optional boolean or null`
2223
2224 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2225
2226 - `enabled: optional boolean or null`
2227
2228 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.
2229
2230 - `key: optional ComputerKeyConfig or null`
2231
2232 `key`'s config overrides.
2233
2234 - `defer_loading: optional boolean or null`
2235
2236 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2237
2238 - `enabled: optional boolean or null`
2239
2240 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.
2241
2242 - `left_click: optional ComputerLeftClickConfig or null`
2243
2244 `left_click`'s config overrides.
2245
2246 - `defer_loading: optional boolean or null`
2247
2248 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2249
2250 - `enabled: optional boolean or null`
2251
2252 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.
2253
2254 - `left_click_drag: optional ComputerLeftClickDragConfig or null`
2255
2256 `left_click_drag`'s config overrides.
2257
2258 - `defer_loading: optional boolean or null`
2259
2260 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2261
2262 - `enabled: optional boolean or null`
2263
2264 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.
2265
2266 - `left_mouse_down: optional ComputerLeftMouseDownConfig or null`
2267
2268 `left_mouse_down`'s config overrides.
2269
2270 - `defer_loading: optional boolean or null`
2271
2272 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2273
2274 - `enabled: optional boolean or null`
2275
2276 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.
2277
2278 - `left_mouse_up: optional ComputerLeftMouseUpConfig or null`
2279
2280 `left_mouse_up`'s config overrides.
2281
2282 - `defer_loading: optional boolean or null`
2283
2284 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2285
2286 - `enabled: optional boolean or null`
2287
2288 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.
2289
2290 - `middle_click: optional ComputerMiddleClickConfig or null`
2291
2292 `middle_click`'s config overrides.
2293
2294 - `defer_loading: optional boolean or null`
2295
2296 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2297
2298 - `enabled: optional boolean or null`
2299
2300 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.
2301
2302 - `mouse_move: optional ComputerMouseMoveConfig or null`
2303
2304 `mouse_move`'s config overrides.
2305
2306 - `defer_loading: optional boolean or null`
2307
2308 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2309
2310 - `enabled: optional boolean or null`
2311
2312 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.
2313
2314 - `right_click: optional ComputerRightClickConfig or null`
2315
2316 `right_click`'s config overrides.
2317
2318 - `defer_loading: optional boolean or null`
2319
2320 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2321
2322 - `enabled: optional boolean or null`
2323
2324 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.
2325
2326 - `screenshot: optional ComputerScreenshotConfig or null`
2327
2328 `screenshot`'s config overrides.
2329
2330 - `defer_loading: optional boolean or null`
2331
2332 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2333
2334 - `enabled: optional boolean or null`
2335
2336 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.
2337
2338 - `scroll: optional ComputerScrollConfig or null`
2339
2340 `scroll`'s config overrides.
2341
2342 - `defer_loading: optional boolean or null`
2343
2344 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2345
2346 - `enabled: optional boolean or null`
2347
2348 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.
2349
2350 - `triple_click: optional ComputerTripleClickConfig or null`
2351
2352 `triple_click`'s config overrides.
2353
2354 - `defer_loading: optional boolean or null`
2355
2356 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2357
2358 - `enabled: optional boolean or null`
2359
2360 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.
2361
2362 - `type: optional ComputerTypeConfig or null`
2363
2364 `type`'s config overrides.
2365
2366 - `defer_loading: optional boolean or null`
2367
2368 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2369
2370 - `enabled: optional boolean or null`
2371
2372 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.
2373
2374 - `wait: optional ComputerWaitConfig or null`
2375
2376 `wait`'s config overrides.
2377
2378 - `defer_loading: optional boolean or null`
2379
2380 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2381
2382 - `enabled: optional boolean or null`
2383
2384 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.
2385
2386 - `zoom: optional ComputerZoomConfig or null`
2387
2388 `zoom`'s config overrides.
2389
2390 - `defer_loading: optional boolean or null`
2391
2392 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2393
2394 - `enabled: optional boolean or null`
2395
2396 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.
2397
15902398 - `ToolTextEditor20250124 object { name, type, allowed_callers, 4 more }`
15912399
15922400 - `name: "str_replace_editor"`
from line 3052
22443052 - `expires_at: string`
22453053
22463054 The time at which the container will expire.
3055
3056 - `skills: array of ContainerSkill or null`
3057
3058 Skills loaded in the container
3059
3060 - `skill_id: string`
3061
3062 Skill ID
3063
3064 - `type: "anthropic" or "custom"`
3065
3066 Type of skill - either 'anthropic' (built-in) or 'custom' (user-defined)
3067
3068 - `"anthropic"`
3069
3070 - `"custom"`
3071
3072 - `version: string`
3073
3074 Skill version or 'latest' for most recent version
22473075
22483076 - `content: array of ContentBlock`
22493077
from line 3258
24303258
24313259 - `"redacted_thinking"`
24323260
2433 - `ToolUseBlock object { id, caller, input, 2 more }`
3261 - `ToolUseBlock object { id, caller, input, 3 more }`
24343262
24353263 - `id: string`
24363264
from line 3299
24713299 - `type: "tool_use"`
24723300
24733301 - `"tool_use"`
3302
3303 - `toolset_name: optional string or null`
3304
3305 For a toolset member tool_use, the toolset family.
24743306
24753307 - `ServerToolUseBlock object { id, caller, input, 2 more }`
24763308
from line 4018
31864018 "role": "user"
31874019 }
31884020 ],
3189 "model": "claude-opus-4-6",
4021 "model": "claude-opus-5",
31904022 "stream": false,
31914023 "system": [
31924024 {
from line 4057
32254057 "id": "msg_013Zva2CMHLNnXjNJJKqJ2EF",
32264058 "container": {
32274059 "id": "container_011CpZohnwH4vuy7gazohgSP",
3228 "expires_at": "2019-12-27T18:11:19.117Z"
4060 "expires_at": "2019-12-27T18:11:19.117Z",
4061 "skills": [
4062 {
4063 "skill_id": "pdf",
4064 "type": "anthropic",
4065 "version": "latest"
4066 }
4067 ]
32294068 },
32304069 "content": [
32314070 {
from line 4083
32444083 "type": "text"
32454084 }
32464085 ],
3247 "model": "claude-opus-4-6",
4086 "model": "claude-opus-5",
32484087 "role": "assistant",
32494088 "stop_details": {
32504089 "category": "cyber",
32514090
api/models Changed · +12 / -8 lines
from line 37
3737
3838 - `string`
3939
40 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
40 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
4141
4242 - `"message-batches-2024-09-24"`
4343
from line 83
8383
8484 - `"user-profiles-2026-03-24"`
8585
86 - `"user-profiles-2026-08-18"`
87
8688 - `"advisor-tool-2026-03-01"`
8789
8890 - `"managed-agents-2026-04-01"`
from line 265
263265{
264266 "data": [
265267 {
266 "id": "claude-opus-4-6",
268 "id": "claude-opus-5",
267269 "capabilities": {
268270 "batch": {
269271 "supported": true
from line 327
325327 }
326328 }
327329 },
328 "created_at": "2026-02-04T00:00:00Z",
329 "display_name": "Claude Opus 4.6",
330 "created_at": "2026-07-24T00:00:00Z",
331 "display_name": "Claude Opus 5",
330332 "max_input_tokens": 0,
331333 "max_tokens": 0,
332334 "type": "model"
from line 362
360362
361363 - `string`
362364
363 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
365 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
364366
365367 - `"message-batches-2024-09-24"`
366368
from line 408
406408
407409 - `"user-profiles-2026-03-24"`
408410
411 - `"user-profiles-2026-08-18"`
412
409413 - `"advisor-tool-2026-03-01"`
410414
411415 - `"managed-agents-2026-04-01"`
from line 576
572576
573577```json
574578{
575 "id": "claude-opus-4-6",
579 "id": "claude-opus-5",
576580 "capabilities": {
577581 "batch": {
578582 "supported": true
from line 638
634638 }
635639 }
636640 },
637 "created_at": "2026-02-04T00:00:00Z",
638 "display_name": "Claude Opus 4.6",
641 "created_at": "2026-07-24T00:00:00Z",
642 "display_name": "Claude Opus 5",
639643 "max_input_tokens": 0,
640644 "max_tokens": 0,
641645 "type": "model"
api/models/list Changed · +6 / -4 lines
from line 35
3535
3636 - `string`
3737
38 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
38 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
3939
4040 - `"message-batches-2024-09-24"`
4141
from line 81
8181
8282 - `"user-profiles-2026-03-24"`
8383
84 - `"user-profiles-2026-08-18"`
85
8486 - `"advisor-tool-2026-03-01"`
8587
8688 - `"managed-agents-2026-04-01"`
from line 263
261263{
262264 "data": [
263265 {
264 "id": "claude-opus-4-6",
266 "id": "claude-opus-5",
265267 "capabilities": {
266268 "batch": {
267269 "supported": true
from line 325
323325 }
324326 }
325327 },
326 "created_at": "2026-02-04T00:00:00Z",
327 "display_name": "Claude Opus 4.6",
328 "created_at": "2026-07-24T00:00:00Z",
329 "display_name": "Claude Opus 5",
328330 "max_input_tokens": 0,
329331 "max_tokens": 0,
330332 "type": "model"
api/models/retrieve Changed · +6 / -4 lines
from line 25
2525
2626 - `string`
2727
28 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
28 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2929
3030 - `"message-batches-2024-09-24"`
3131
from line 71
7171
7272 - `"user-profiles-2026-03-24"`
7373
74 - `"user-profiles-2026-08-18"`
75
7476 - `"advisor-tool-2026-03-01"`
7577
7678 - `"managed-agents-2026-04-01"`
from line 239
237239
238240```json
239241{
240 "id": "claude-opus-4-6",
242 "id": "claude-opus-5",
241243 "capabilities": {
242244 "batch": {
243245 "supported": true
from line 301
299301 }
300302 }
301303 },
302 "created_at": "2026-02-04T00:00:00Z",
303 "display_name": "Claude Opus 4.6",
304 "created_at": "2026-07-24T00:00:00Z",
305 "display_name": "Claude Opus 5",
304306 "max_input_tokens": 0,
305307 "max_tokens": 0,
306308 "type": "model"
api/overview Changed · +3 / -3 lines
from line 29
2929* **[Message Batches API](https://platform.claude.com/docs/en/api/messages/batches/create)**: Process large volumes of Messages requests asynchronously with 50% cost reduction (`POST /v1/messages/batches`)
3030* **[Token Counting API](https://platform.claude.com/docs/en/api/messages-count-tokens)**: Count tokens in a message before sending to manage costs and rate limits (`POST /v1/messages/count_tokens`)
3131* **[Models API](https://platform.claude.com/docs/en/api/models/list)**: List available Claude models and their details (`GET /v1/models`)
32* **[Files API](https://platform.claude.com/docs/en/api/beta/files/upload)**: Upload and manage files for use across multiple API calls (`POST /v1/files`, `GET /v1/files`)
33* **[Skills API](https://platform.claude.com/docs/en/api/skills/create-skill)**: Create and manage custom agent skills (`POST /v1/skills`, `GET /v1/skills`)
32* **[Files API](https://platform.claude.com/docs/en/api/files/upload)**: Upload and manage files for use across multiple API calls (`POST /v1/files`, `GET /v1/files`)
33* **[Skills API](https://platform.claude.com/docs/en/api/skills/create)**: Create and manage custom agent skills (`POST /v1/skills`, `GET /v1/skills`)
3434
3535**Beta:**
3636
from line 152
152152Every SDK provides an auto-paginating iterator that follows `next_page` for you. In Python and TypeScript, you get it by iterating the list result directly. The other SDKs provide the iterator through a separate method. SDK auto-pagination is forward-only; to go back a page, read `prev_page` from the response and pass it back as the `page` parameter yourself. See [client SDKs](https://platform.claude.com/docs/en/cli-sdks-libraries/overview) for language-specific details.
153153
154154<Note>
155 Some list endpoints use a different cursor scheme. The [Message Batches API](https://platform.claude.com/docs/en/build-with-claude/batch-processing), the [Models API](https://platform.claude.com/docs/en/api/models/list), and several [Admin API](https://platform.claude.com/docs/en/manage-claude/admin-api) endpoints take `after_id` and `before_id` query parameters instead of `page`. Their responses return `has_more`, `first_id`, and `last_id` instead of `next_page`. The [Files API](https://platform.claude.com/docs/en/build-with-claude/files) also uses that scheme when a request includes the `files-api-2025-04-14` beta header; without the header, `GET /v1/files` takes `page` and returns `next_page`. Some endpoints that use the `page` scheme, such as `GET /v1/skills`, also return a `has_more` Boolean alongside `next_page`. See the reference page for each endpoint for its exact pagination fields.
155 Some list endpoints use a different cursor scheme. The [Message Batches API](https://platform.claude.com/docs/en/build-with-claude/batch-processing), the [Models API](https://platform.claude.com/docs/en/api/models/list), and several [Admin API](https://platform.claude.com/docs/en/manage-claude/admin-api) endpoints take `after_id` and `before_id` query parameters instead of `page`. Their responses return `has_more`, `first_id`, and `last_id` instead of `next_page`. The [Files API](https://platform.claude.com/docs/en/build-with-claude/files) also uses that scheme when a request includes the `files-api-2025-04-14` beta header; without the header, `GET /v1/files` takes `page` and returns `next_page`. The [Skills API](https://platform.claude.com/docs/en/build-with-claude/skills-guide) list endpoints, `GET /v1/skills` and `GET /v1/skills/{skill_id}/versions`, take `page` and return `next_page`; requests that include the `skills-2025-10-02` beta header also receive a `has_more` Boolean alongside `next_page`. See the reference page for each endpoint for its exact pagination fields.
156156</Note>
157157
158158## Rate limits and availability
api/rate-limits Changed · +51 / -25 lines
### Reaching your spend cap ### Setting your own spend limit
from line 29
2929## Spend limits
3030
3131<Note>
32 **[Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws):** Spend limits work differently on Claude Platform on AWS. See [Spend limits on Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#spend-limits) for how spend caps and self-set spend limits apply to your organization.
32 **[Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws):** The same monthly spend caps apply, and requests stop at the cap in the same way. Billing and tier increases work differently; see [Spend limits on Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#spend-limits).
3333</Note>
3434
35Each of the Start, Build, and Scale tiers carries a monthly spend cap, which is the maximum your organization can spend on the API each calendar month. Once you reach your tier's spend cap, API usage pauses until the next month unless you request a higher limit. You can view your organization's monthly spend cap and set your own limit on the [Billing](https://platform.claude.com/settings/billing) page.
35Each of the Start, Build, and Scale tiers carries a monthly spend cap, which is the maximum your organization can spend on the API each calendar month. You can view your organization's monthly spend cap and set your own limit on the [Billing](https://platform.claude.com/settings/billing) page.
3636
3737| Usage tier | Monthly spend cap |
3838| ---------- | ----------------- |
from line 42
4242
4343Organizations on the Custom tier have no monthly spend cap; limits are arranged with their account team.
4444
45### Reaching your spend cap
46
47Once you reach your tier's spend cap, API usage pauses until 00UTC on the first day of the next month, unless you request a higher limit sooner. While usage is paused, API requests return HTTP 429:
48
49```json
50{
51 "type": "error",
52 "error": {
53 "type": "rate_limit_error",
54 "message": "You have reached your API usage limits: your organization has crossed its monthly API usage threshold, set based on your organization's API tier. You will regain access on 2026-09-01 at 00:00 UTC.",
55 "details": { "error_code": "enforced_spend_limit_reached" }
56 },
57 "request_id": "req_018EeWyXxfu5pfWkrYcMdjWG"
58}
59```
60
61* The error type is `rate_limit_error`, the same as for a rate limit, but the response has no `retry-after` header. Retrying, including the SDKs' automatic retries, fails until access resumes.
62* On the Messages API, `error.details.error_code` is `enforced_spend_limit_reached`. Use it to tell this response apart from a rate limit.
63* Moving to a higher tier restores access; see [Requesting higher limits](https://platform.claude.com/docs/en/api/rate-limits#requesting-higher-limits).
64
65### Setting your own spend limit
66
4567You can also set your own spend limit below your tier's cap to control costs:
4668
4769<Steps>
from line 80
5880 </Step>
5981</Steps>
6082
83When usage reaches a spend limit you set, requests return HTTP 400 with error type `invalid_request_error`. The message begins `You have reached your specified API usage limits`, or `You have reached your specified workspace API usage limits` for a workspace limit, and states when access resumes. Raise or remove the limit to restore access sooner.
84
85Limits on the [Claude Code workspace](https://platform.claude.com/docs/en/manage-claude/workspaces#claude-code-workspace) are checked separately: Claude Code requests over that workspace's limit can instead receive a 429 that carries a `retry-after` header.
86
6187## Rate limits
6288
6389The rate limits for the Messages API are measured in requests per minute (RPM), input tokens per minute (ITPM), and output tokens per minute (OTPM) for each model class. If you exceed any of the rate limits you will get a [429 error](https://platform.claude.com/docs/en/api/errors) describing which rate limit was exceeded, along with a `retry-after` header indicating how long to wait.
from line 277
251277
252278The following headers are returned:
253279
254| Header | Description |
255| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
256| `retry-after` | The number of seconds to wait until you can retry the request. Earlier retries will fail. |
257| `anthropic-ratelimit-requests-limit` | The maximum number of requests allowed within any rate limit period. |
258| `anthropic-ratelimit-requests-remaining` | The number of requests remaining before being rate limited. |
259| `anthropic-ratelimit-requests-reset` | The time when the request rate limit will be fully replenished, provided in RFC 3339 format. |
260| `anthropic-ratelimit-tokens-limit` | The maximum number of tokens allowed within any rate limit period. |
261| `anthropic-ratelimit-tokens-remaining` | The number of tokens remaining (rounded to the nearest thousand) before being rate limited. |
262| `anthropic-ratelimit-tokens-reset` | The time when the token rate limit will be fully replenished, provided in RFC 3339 format. |
263| `anthropic-ratelimit-input-tokens-limit` | The maximum number of input tokens allowed within any rate limit period. |
264| `anthropic-ratelimit-input-tokens-remaining` | The number of input tokens remaining (rounded to the nearest thousand) before being rate limited. |
265| `anthropic-ratelimit-input-tokens-reset` | The time when the input token rate limit will be fully replenished, provided in RFC 3339 format. |
266| `anthropic-ratelimit-output-tokens-limit` | The maximum number of output tokens allowed within any rate limit period. |
267| `anthropic-ratelimit-output-tokens-remaining` | The number of output tokens remaining (rounded to the nearest thousand) before being rate limited. |
268| `anthropic-ratelimit-output-tokens-reset` | The time when the output token rate limit will be fully replenished, provided in RFC 3339 format. |
269| `anthropic-priority-input-tokens-limit` | The maximum number of Priority Tier input tokens allowed within any rate limit period. (Priority Tier only) |
270| `anthropic-priority-input-tokens-remaining` | The number of Priority Tier input tokens remaining (rounded to the nearest thousand) before being rate limited. (Priority Tier only) |
271| `anthropic-priority-input-tokens-reset` | The time when the Priority Tier input token rate limit will be fully replenished, provided in RFC 3339 format. (Priority Tier only) |
272| `anthropic-priority-output-tokens-limit` | The maximum number of Priority Tier output tokens allowed within any rate limit period. (Priority Tier only) |
273| `anthropic-priority-output-tokens-remaining` | The number of Priority Tier output tokens remaining (rounded to the nearest thousand) before being rate limited. (Priority Tier only) |
274| `anthropic-priority-output-tokens-reset` | The time when the Priority Tier output token rate limit will be fully replenished, provided in RFC 3339 format. (Priority Tier only) |
280| Header | Description |
281| --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
282| `retry-after` | The number of seconds to wait until you can retry the request. Earlier retries will fail. Not sent with the spend-cap 429 (see [Reaching your spend cap](https://platform.claude.com/docs/en/api/rate-limits#reaching-your-spend-cap)). |
283| `anthropic-ratelimit-requests-limit` | The maximum number of requests allowed within any rate limit period. |
284| `anthropic-ratelimit-requests-remaining` | The number of requests remaining before being rate limited. |
285| `anthropic-ratelimit-requests-reset` | The time when the request rate limit will be fully replenished, provided in RFC 3339 format. |
286| `anthropic-ratelimit-tokens-limit` | The maximum number of tokens allowed within any rate limit period. |
287| `anthropic-ratelimit-tokens-remaining` | The number of tokens remaining (rounded to the nearest thousand) before being rate limited. |
288| `anthropic-ratelimit-tokens-reset` | The time when the token rate limit will be fully replenished, provided in RFC 3339 format. |
289| `anthropic-ratelimit-input-tokens-limit` | The maximum number of input tokens allowed within any rate limit period. |
290| `anthropic-ratelimit-input-tokens-remaining` | The number of input tokens remaining (rounded to the nearest thousand) before being rate limited. |
291| `anthropic-ratelimit-input-tokens-reset` | The time when the input token rate limit will be fully replenished, provided in RFC 3339 format. |
292| `anthropic-ratelimit-output-tokens-limit` | The maximum number of output tokens allowed within any rate limit period. |
293| `anthropic-ratelimit-output-tokens-remaining` | The number of output tokens remaining (rounded to the nearest thousand) before being rate limited. |
294| `anthropic-ratelimit-output-tokens-reset` | The time when the output token rate limit will be fully replenished, provided in RFC 3339 format. |
295| `anthropic-priority-input-tokens-limit` | The maximum number of Priority Tier input tokens allowed within any rate limit period. (Priority Tier only) |
296| `anthropic-priority-input-tokens-remaining` | The number of Priority Tier input tokens remaining (rounded to the nearest thousand) before being rate limited. (Priority Tier only) |
297| `anthropic-priority-input-tokens-reset` | The time when the Priority Tier input token rate limit will be fully replenished, provided in RFC 3339 format. (Priority Tier only) |
298| `anthropic-priority-output-tokens-limit` | The maximum number of Priority Tier output tokens allowed within any rate limit period. (Priority Tier only) |
299| `anthropic-priority-output-tokens-remaining` | The number of Priority Tier output tokens remaining (rounded to the nearest thousand) before being rate limited. (Priority Tier only) |
300| `anthropic-priority-output-tokens-reset` | The time when the Priority Tier output token rate limit will be fully replenished, provided in RFC 3339 format. (Priority Tier only) |
275301
276302The `anthropic-ratelimit-tokens-*` headers display the values for the most restrictive limit currently in effect. For instance, if you have exceeded the Workspace per-minute token limit, the headers will contain the Workspace per-minute token rate limit values. If Workspace limits do not apply, the headers will return the total tokens remaining, where total is the sum of input and output tokens. This approach ensures that you have visibility into the most relevant constraint on your current API usage. To see which Workspace a request counted against, read the `anthropic-workspace-id` [response header](https://platform.claude.com/docs/en/api/overview#response-headers), which carries the ID of the Workspace that your API key or access token resolved to.
277303
api/skills New page · 873 lines, new page
# Skills ## Create Skill ### Returns ### Example #### Response ## List Skills ### Query Parameters ### Returns ### Example #### Response ## Get Skill ### Path Parameters ### Returns ### Example #### Response ## Delete Skill ### Path Parameters ### Returns ### Example #### Response ## Domain Types ### Deleted Skill ### Skill ### Skill Source # Versions ## Create Skill Version ### Path Parameters ### Returns ### Example #### Response ## List Skill Versions ### Path Parameters ### Query Parameters ### Returns ### Example #### Response ## Get Skill Version ### Path Parameters ### Returns ### Example #### Response ## Delete Skill Version ### Path Parameters ### Returns ### Example #### Response ## Domain Types ### Deleted Skill Version ### Skill Version
A whole new page. There's nothing to diff it against, so here is what it says.
---
title: Skills
url: https://platform.claude.com/docs/en/api/skills
---
# Skills
## Create Skill
**post** `/v1/skills`
Create Skill
### Returns
- `Skill object { id, created_at, display_name, 4 more }`
- `id: string`
Unique identifier for the skill.
The format and length of IDs may change over time.
- `created_at: string`
ISO 8601 timestamp of when the skill was created.
- `display_name: string`
Human-readable, single-line label for the Skill. Maximum 255 characters.
Always set: derived from the SKILL.md frontmatter `name` when omitted at
creation. Not unique.
- `latest_version_id: string`
ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version.
- `source: SkillSource`
Where the Skill comes from.
Possible values:
* `"custom"`: authored by the platform user; private to their workspace
* `"anthropic"`: published by Anthropic; shared and read-only
* `"anthropic_example"`: Anthropic-published sample Skill
* `"plugin"`: resolved from an installed plugin
- `type: "custom" or "anthropic" or "anthropic_example" or "plugin"`
Where the Skill comes from.
Possible values:
* `"custom"`: authored by the platform user; private to their workspace
* `"anthropic"`: published by Anthropic; shared and read-only
* `"anthropic_example"`: Anthropic-published sample Skill
* `"plugin"`: resolved from an installed plugin
- `"custom"`
- `"anthropic"`
- `"anthropic_example"`
- `"plugin"`
- `type: "skill"`
Object type.
For Skills, this is always `"skill"`.
- `"skill"`
- `updated_at: string`
ISO 8601 timestamp of when the skill was last updated.
### Example
```http
curl https://api.anthropic.com/v1/skills \
-H 'Content-Type: multipart/form-data' \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY" \
-F files='["Example data"]'
```
#### Response
```json
{
"id": "skill_01JAbcdefghijklmnopqrstuvw",
"created_at": "2024-10-30T23:58:27.427722Z",
"display_name": "display_name",
"latest_version_id": "latest_version_id",
"source": {
"type": "custom"
},
"type": "skill",
"updated_at": "2024-10-30T23:58:27.427722Z"
}
```
## List Skills
**get** `/v1/skills`
List Skills
### Query Parameters
- `limit: optional number`
Number of results to return per page.
Ranges from `1` to `1000`. Defaults to `20`.
- `page: optional string`
Pagination token for fetching a specific page of results.
Pass the value from a previous response's `next_page` field to get the next page of results.
- `source: optional string`
Filter skills by source.
If provided, only skills from the specified source will be returned:
* `"custom"`: only return user-created skills
* `"anthropic"`: only return Anthropic-created skills
### Returns
- `data: array of Skill`
List of skills.
- `id: string`
Unique identifier for the skill.
The format and length of IDs may change over time.
- `created_at: string`
ISO 8601 timestamp of when the skill was created.
- `display_name: string`
Human-readable, single-line label for the Skill. Maximum 255 characters.
Always set: derived from the SKILL.md frontmatter `name` when omitted at
creation. Not unique.
- `latest_version_id: string`
ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version.
- `source: SkillSource`
Where the Skill comes from.
Possible values:
* `"custom"`: authored by the platform user; private to their workspace
* `"anthropic"`: published by Anthropic; shared and read-only
* `"anthropic_example"`: Anthropic-published sample Skill
* `"plugin"`: resolved from an installed plugin
- `type: "custom" or "anthropic" or "anthropic_example" or "plugin"`
Where the Skill comes from.
Possible values:
* `"custom"`: authored by the platform user; private to their workspace
* `"anthropic"`: published by Anthropic; shared and read-only
* `"anthropic_example"`: Anthropic-published sample Skill
* `"plugin"`: resolved from an installed plugin
- `"custom"`
- `"anthropic"`
- `"anthropic_example"`
- `"plugin"`
- `type: "skill"`
Object type.
For Skills, this is always `"skill"`.
- `"skill"`
- `updated_at: string`
ISO 8601 timestamp of when the skill was last updated.
- `next_page: string or null`
Token for fetching the next page of results.
If `null`, there are no more results available. Pass this value to the `page` parameter in the next request to get the next page.
### Example
```http
curl https://api.anthropic.com/v1/skills \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
#### Response
```json
{
"data": [
{
"id": "skill_01JAbcdefghijklmnopqrstuvw",
"created_at": "2024-10-30T23:58:27.427722Z",
"display_name": "display_name",
"latest_version_id": "latest_version_id",
"source": {
"type": "custom"
},
"type": "skill",
"updated_at": "2024-10-30T23:58:27.427722Z"
}
],
"next_page": "next_page"
}
```
## Get Skill
**get** `/v1/skills/{skill_id}`
Get Skill
### Path Parameters
- `skill_id: string`
Unique identifier for the skill.
The format and length of IDs may change over time.
### Returns
- `Skill object { id, created_at, display_name, 4 more }`
- `id: string`
Unique identifier for the skill.
The format and length of IDs may change over time.
- `created_at: string`
ISO 8601 timestamp of when the skill was created.
- `display_name: string`
Human-readable, single-line label for the Skill. Maximum 255 characters.
Always set: derived from the SKILL.md frontmatter `name` when omitted at
creation. Not unique.
- `latest_version_id: string`
ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version.
- `source: SkillSource`
Where the Skill comes from.
Possible values:
* `"custom"`: authored by the platform user; private to their workspace
* `"anthropic"`: published by Anthropic; shared and read-only
* `"anthropic_example"`: Anthropic-published sample Skill
* `"plugin"`: resolved from an installed plugin
- `type: "custom" or "anthropic" or "anthropic_example" or "plugin"`
Where the Skill comes from.
Possible values:
* `"custom"`: authored by the platform user; private to their workspace
* `"anthropic"`: published by Anthropic; shared and read-only
* `"anthropic_example"`: Anthropic-published sample Skill
* `"plugin"`: resolved from an installed plugin
- `"custom"`
- `"anthropic"`
Cut at 300 lines. The page has the rest.
api/skills/create New page · 102 lines, new page
## Create Skill ### Returns ### Example #### Response
A whole new page. There's nothing to diff it against, so here is what it says.
---
title: Create Skill
url: https://platform.claude.com/docs/en/api/skills/create
---
## Create Skill
**post** `/v1/skills`
Create Skill
### Returns
- `Skill object { id, created_at, display_name, 4 more }`
- `id: string`
Unique identifier for the skill.
The format and length of IDs may change over time.
- `created_at: string`
ISO 8601 timestamp of when the skill was created.
- `display_name: string`
Human-readable, single-line label for the Skill. Maximum 255 characters.
Always set: derived from the SKILL.md frontmatter `name` when omitted at
creation. Not unique.
- `latest_version_id: string`
ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version.
- `source: SkillSource`
Where the Skill comes from.
Possible values:
* `"custom"`: authored by the platform user; private to their workspace
* `"anthropic"`: published by Anthropic; shared and read-only
* `"anthropic_example"`: Anthropic-published sample Skill
* `"plugin"`: resolved from an installed plugin
- `type: "custom" or "anthropic" or "anthropic_example" or "plugin"`
Where the Skill comes from.
Possible values:
* `"custom"`: authored by the platform user; private to their workspace
* `"anthropic"`: published by Anthropic; shared and read-only
* `"anthropic_example"`: Anthropic-published sample Skill
* `"plugin"`: resolved from an installed plugin
- `"custom"`
- `"anthropic"`
- `"anthropic_example"`
- `"plugin"`
- `type: "skill"`
Object type.
For Skills, this is always `"skill"`.
- `"skill"`
- `updated_at: string`
ISO 8601 timestamp of when the skill was last updated.
### Example
```http
curl https://api.anthropic.com/v1/skills \
-H 'Content-Type: multipart/form-data' \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY" \
-F files='["Example data"]'
```
#### Response
```json
{
"id": "skill_01JAbcdefghijklmnopqrstuvw",
"created_at": "2024-10-30T23:58:27.427722Z",
"display_name": "display_name",
"latest_version_id": "latest_version_id",
"source": {
"type": "custom"
},
"type": "skill",
"updated_at": "2024-10-30T23:58:27.427722Z"
}
```
api/skills/delete New page · 54 lines, new page
## Delete Skill ### Path Parameters ### Returns ### Example #### Response
A whole new page. There's nothing to diff it against, so here is what it says.
---
title: Delete Skill
url: https://platform.claude.com/docs/en/api/skills/delete
---
## Delete Skill
**delete** `/v1/skills/{skill_id}`
Delete Skill
### Path Parameters
- `skill_id: string`
Unique identifier for the skill.
The format and length of IDs may change over time.
### Returns
- `DeletedSkill object { id, type }`
- `id: string`
Unique identifier for the skill.
The format and length of IDs may change over time.
- `type: "skill_deleted"`
Deleted object type.
For Skills, this is always `"skill_deleted"`.
- `"skill_deleted"`
### Example
```http
curl https://api.anthropic.com/v1/skills/$SKILL_ID \
-X DELETE \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
#### Response
```json
{
"id": "skill_01JAbcdefghijklmnopqrstuvw",
"type": "skill_deleted"
}
```