Create Agent changedapi/beta/agents/create
Nearest release: v2.1.296, published 4 hours before this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+863added
Lines−640removed
From line
183
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits19to this page, all time
The whole hunk
from line 183, old and new numbered
/
from line 183
183183
184184 - `"claude-haiku-4-5"`
185185
186 Fastest model with near-frontier intelligence
187
188186 - `"claude-haiku-4-5-20251001"`
189187
190 Fastest model with near-frontier intelligence
191
192188 - `"claude-opus-4-5"`
193189
194190 Powerful intelligence for long-running agents and coding
from line 321
325321
326322 Multiagent orchestration configuration.
327323
328 - `type: "coordinator"`
324 - `BetaManagedAgentsMultiagentCoordinatorParams object`
329325
330 - `agents: array of BetaManagedAgentsMultiagentRosterEntryParams`
326 A coordinator topology: the session's primary thread orchestrates work by spawning session threads, each running an agent drawn from the `agents` roster.
331327
332 Agents the coordinator may spawn as session threads. 1–20 entries. Each entry is an agent ID string, a versioned `{"type":"agent","id","version"}` reference, or `{"type":"self"}` to allow recursive self-invocation. Entries must reference distinct agents (after resolving `self` and string forms); at most one `self`. Referenced agents must exist, must not be archived, and must not themselves have `multiagent` set (depth limit 1).
328 - `type: "coordinator"`
333329
334 - `string`
330 - `agents: array of BetaManagedAgentsMultiagentRosterEntryParams`
335331
336 - `BetaManagedAgentsAgentParams object`
332 Agents the coordinator may spawn as session threads. 1–20 entries. Each entry is an agent ID string, a versioned `{"type":"agent","id","version"}` reference, or `{"type":"self"}` to allow recursive self-invocation. Entries must reference distinct agents (after resolving `self` and string forms); at most one `self`. Referenced agents must exist, must not be archived, and must not themselves have `multiagent` set (depth limit 1).
337333
338 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version
334 - `string`
339335
340 - `type: "agent"`
336 - `BetaManagedAgentsAgentParams object`
341337
342 - `id: string`
338 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version
343339
344 The `agent` ID.
340 - `type: "agent"`
345341
346 minLength: 1, maxLength: 128
342 - `id: string`
347343
348 - `version: optional number`
344 The `agent` ID.
349345
350 The specific `agent` version to use. Omit to use the latest version. Must be at least 1 if specified.
346 minLength: 1, maxLength: 128
351347
352 format: int32
348 - `version: optional number`
353349
354 - `BetaManagedAgentsMultiagentSelfParams object`
350 The specific `agent` version to use. Omit to use the latest version. Must be at least 1 if specified.
355351
356 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
352 format: int32
357353
358 - `type: "self"`
354 - `BetaManagedAgentsMultiagentSelfParams object`
359355
360 - `BetaManagedAgentsAdvisorParams object`
356 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
361357
362 Platform advisor roster entry: a model the session's primary thread may consult mid-turn. At most one per roster; the entry occupies the roster name `anthropic.advisor`.
358 - `type: "self"`
363359
364 - `type: "advisor"`
360 - `BetaManagedAgentsAdvisorParams object`
365361
366 - `model: string`
362 Platform advisor roster entry: a model the session's primary thread may consult mid-turn. At most one per roster; the entry occupies the roster name `anthropic.advisor`.
367363
368 A Claude model id. The model must be permitted as an advisor for this agent's model.
364 - `type: "advisor"`
369365
370 minLength: 1, maxLength: 256
366 - `model: string`
371367
368 A Claude model id. The model must be permitted as an advisor for this agent's model.
369
370 minLength: 1, maxLength: 256
371
372 - `BetaManagedAgentsMultiagent20261001Params object`
373
374 Multiagent configuration with three members, each enabled or disabled on its own. On an update, if the agent's stored `multiagent` also has type `multiagent_20261001`, this configuration is merged into the stored one, level by level, instead of replacing it. A key that the update omits keeps its stored value. A key sent as null takes its default, on create as well, so `"workflows": null` enables workflows. An object sent with a `type` other than the stored one replaces the stored object, and the keys that it omits take their defaults. A `predefined_agents` list that is sent replaces the stored list. Every object that is sent needs its `type`, and an enabled `advisor` needs its `model`. Other validation applies to the merged result.
375
376 - `type: "multiagent_20261001"`
377
378 - `advisor: optional BetaManagedAgentsMultiagentAdvisorParams or null`
379
380 Whether the session's primary thread can consult an advisor model. Defaults to disabled.
381
382 - `BetaManagedAgentsMultiagentAdvisorEnabledParams object`
383
384 The session's primary thread can consult `model` mid-turn.
385
386 - `type: "enabled"`
387
388 - `model: string`
389
390 A Claude model id. The model must be permitted as an advisor for this agent's model.
391
392 minLength: 1, maxLength: 256
393
394 - `BetaManagedAgentsMultiagentAdvisorDisabledParams object`
395
396 The agent has no advisor.
397
398 - `type: "disabled"`
399
400 - `subagents: optional BetaManagedAgentsMultiagentSubagentsParams or null`
401
402 Whether the agent can spawn session threads. Defaults to enabled.
403
404 - `BetaManagedAgentsMultiagentSubagentsEnabledParams object`
405
406 The agent can spawn session threads. Each thread runs a predefined agent, which is a saved agent in `predefined_agents`, or an inline agent, which the agent defines when it spawns the thread and which is not saved. If `inline_agents` is disabled, `predefined_agents` must name at least one agent.
407
408 - `type: "enabled"`
409
410 - `inline_agents: optional BetaManagedAgentsMultiagentInlineAgentsParams or null`
411
412 Whether the agent can define inline agents when it spawns session threads. Defaults to enabled.
413
414 - `BetaManagedAgentsMultiagentInlineAgentsEnabledParams object`
415
416 The agent can define inline agents.
417
418 - `type: "enabled"`
419
420 - `BetaManagedAgentsMultiagentInlineAgentsDisabledParams object`
421
422 The agent cannot define inline agents.
423
424 - `type: "disabled"`
425
426 - `predefined_agents: optional array of BetaManagedAgentsMultiagentPredefinedAgentParams or null`
427
428 Predefined agents that this agent can spawn as session threads. At most 20. Defaults to null. Null and an empty list both mean no predefined agents. This list is separate from `workflows.predefined_agents`, and an agent in one list is not added to the other.
429
430 - `string`
431
432 - `BetaManagedAgentsAgentParams object`
433
434 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version
435
436 - `BetaManagedAgentsMultiagentSelfParams object`
437
438 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
439
440 - `BetaManagedAgentsMultiagentSubagentsDisabledParams object`
441
442 The agent cannot spawn session threads.
443
444 - `type: "disabled"`
445
446 - `workflows: optional BetaManagedAgentsMultiagentWorkflowsParams or null`
447
448 Whether the agent can start workflow runs. Defaults to enabled.
449
450 - `BetaManagedAgentsMultiagentWorkflowsEnabledParams object`
451
452 The agent can start workflow runs. Each run follows a plan, a program that the agent writes. A plan can use predefined agents, which are the saved agents in `predefined_agents`, and inline agents, which it defines itself and which are not saved. If `inline_agents` is disabled, `predefined_agents` must name at least one agent.
453
454 - `type: "enabled"`
455
456 - `inline_agents: optional BetaManagedAgentsMultiagentInlineAgentsParams or null`
457
458 Whether a run's plan can define inline agents. Defaults to enabled.
459
460 - `predefined_agents: optional array of BetaManagedAgentsMultiagentPredefinedAgentParams or null`
461
462 Predefined agents that a run's plan can use. At most 20. Defaults to null. Null and an empty list both mean no predefined agents. This list is separate from `subagents.predefined_agents`, and an agent in one list is not added to the other.
463
464 - `string`
465
466 - `BetaManagedAgentsAgentParams object`
467
468 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version
469
470 - `BetaManagedAgentsMultiagentSelfParams object`
471
472 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
473
474 - `BetaManagedAgentsMultiagentWorkflowsDisabledParams object`
475
476 The agent cannot start workflow runs.
477
478 - `type: "disabled"`
479
372480- `skills: optional array of BetaManagedAgentsSkillParams`
373481
374482 Skills available to the agent.
from line 1139
10311139
10321140 - `"claude-haiku-4-5"`
10331141
1034 Fastest model with near-frontier intelligence
1035
10361142 - `"claude-haiku-4-5-20251001"`
10371143
1038 Fastest model with near-frontier intelligence
1039
10401144 - `"claude-opus-4-5"`
10411145
10421146 Powerful intelligence for long-running agents and coding
from line 1213
11091213
11101214 Multiagent orchestration configuration. Null when the agent is single-threaded.
11111215
1112 - `type: "coordinator"`
1216 - `BetaManagedAgentsMultiagentCoordinator object`
11131217
1114 - `agents: array of BetaManagedAgentsAgentReference or BetaManagedAgentsAdvisor`
1218 Resolved coordinator topology with a concrete agent roster.
11151219
1116 Agents the coordinator may spawn as session threads, each resolved to a specific version.
1220 - `type: "coordinator"`
11171221
1118 - `BetaManagedAgentsAgentReference object`
1222 - `agents: array of BetaManagedAgentsAgentReference or BetaManagedAgentsAdvisor`
11191223
1120 A resolved agent reference with a concrete version.
1224 Agents the coordinator may spawn as session threads, each resolved to a specific version.
11211225
1122 - `type: "agent"`
1226 - `BetaManagedAgentsAgentReference object`
11231227
1124 - `id: string`
1228 A resolved agent reference with a concrete version.
11251229
1126 - `version: number`
1230 - `type: "agent"`
11271231
1128 format: int32
1232 - `id: string`
11291233
1130 - `BetaManagedAgentsAdvisor object`
1234 - `version: number`
11311235
1132 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
1236 format: int32
11331237
1134 - `type: "advisor"`
1238 - `BetaManagedAgentsAdvisor object`
11351239
1136 - `model: string`
1240 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
11371241
1138 The advisor model id.
1242 - `type: "advisor"`
11391243
1244 - `model: string`
1245
1246 The advisor model id.
1247
1248 - `BetaManagedAgentsMultiagent20261001 object`
1249
1250 Resolved multiagent configuration with three members, each enabled or disabled on its own.
1251
1252 - `type: "multiagent_20261001"`
1253
1254 - `advisor: BetaManagedAgentsMultiagentAdvisor`
1255
1256 Whether the session's primary thread can consult an advisor model.
1257
1258 - `BetaManagedAgentsMultiagentAdvisorEnabled object`
1259
1260 The session's primary thread can consult `model` mid-turn.
1261
1262 - `type: "enabled"`
1263
1264 - `model: string`
1265
1266 The advisor model id.
1267
1268 - `BetaManagedAgentsMultiagentAdvisorDisabled object`
1269
1270 The agent has no advisor.
1271
1272 - `type: "disabled"`
1273
1274 - `subagents: BetaManagedAgentsMultiagentSubagents`
1275
1276 Whether the agent can spawn session threads.
1277
1278 - `BetaManagedAgentsMultiagentSubagentsEnabled object`
1279
1280 The agent can spawn session threads.
1281
1282 - `type: "enabled"`
1283
1284 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
1285
1286 Whether the agent can define inline agents, which are not saved, when it spawns session threads.
1287
1288 - `BetaManagedAgentsMultiagentInlineAgentsEnabled object`
1289
1290 The agent can define inline agents.
1291
1292 - `type: "enabled"`
1293
1294 - `BetaManagedAgentsMultiagentInlineAgentsDisabled object`
1295
1296 The agent cannot define inline agents.
1297
1298 - `type: "disabled"`
1299
1300 - `predefined_agents: array of BetaManagedAgentsAgentReference`
1301
1302 Predefined agents, which are saved agents that this agent can spawn as session threads, each resolved to a specific version.
1303
1304 - `type: "agent"`
1305
1306 - `id: string`
1307
1308 - `version: number`
1309
1310 format: int32
1311
1312 - `BetaManagedAgentsMultiagentSubagentsDisabled object`
1313
1314 The agent cannot spawn session threads.
1315
1316 - `type: "disabled"`
1317
1318 - `workflows: BetaManagedAgentsMultiagentWorkflows`
1319
1320 Whether the agent can start workflow runs.
1321
1322 - `BetaManagedAgentsMultiagentWorkflowsEnabled object`
1323
1324 The agent can start workflow runs.
1325
1326 - `type: "enabled"`
1327
1328 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
1329
1330 Whether a run's plan can define inline agents, which are not saved.
1331
1332 - `predefined_agents: array of BetaManagedAgentsAgentReference`
1333
1334 Predefined agents, which are saved agents that a run's plan can use, each resolved to a specific version.
1335
1336 - `type: "agent"`
1337
1338 - `id: string`
1339
1340 - `version: number`
1341
1342 format: int32
1343
1344 - `BetaManagedAgentsMultiagentWorkflowsDisabled object`
1345
1346 The agent cannot start workflow runs.
1347
1348 - `type: "disabled"`
1349
11401350 - `name: string`
11411351
11421352 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
from line 1832
16221832 "metadata": {
16231833 "foo": "bar"
16241834 },
1625 "multiagent": {
1626 "agents": [
1627 "agent_011CZkYqphY8vELVzwCUpqiQ",
1628 {
1629 "type": "self"
1630 }
1631 ],
1632 "type": "coordinator"
1633 },
16341835 "system": "You are a general-purpose agent that can research, write code, run commands, and use connected tools to complete the user'\''s task end to end.",
16351836 "tools": [
16361837 {
from line 1868
16671868 "speed": "standard"
16681869 },
16691870 "multiagent": {
1670 "agents": [
1671 {
1672 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
1673 "type": "agent",
1674 "version": 1
1675 }
1676 ],
1677 "type": "coordinator"
1871 "advisor": {
1872 "type": "disabled"
1873 },
1874 "subagents": {
1875 "inline_agents": {
1876 "type": "enabled"
1877 },
1878 "predefined_agents": [
1879 {
1880 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
1881 "type": "agent",
1882 "version": 1
1883 }
1884 ],
1885 "type": "enabled"
1886 },
1887 "type": "multiagent_20261001",
1888 "workflows": {
1889 "inline_agents": {
1890 "type": "enabled"
1891 },
1892 "predefined_agents": [
1893 {
1894 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
1895 "type": "agent",
1896 "version": 1
1897 }
1898 ],
1899 "type": "enabled"
1900 }
16781901 },
16791902 "name": "My First Agent",
16801903 "skills": [
No line in this hunk matches that.