Update Agent changedapi/beta/agents/update
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+869added
Lines−646removed
From line
217
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 217, old and new numbered
/
from line 217
217217
218218 - `"claude-haiku-4-5"`
219219
220 Fastest model with near-frontier intelligence
221
222220 - `"claude-haiku-4-5-20251001"`
223221
224 Fastest model with near-frontier intelligence
225
226222 - `"claude-opus-4-5"`
227223
228224 Powerful intelligence for long-running agents and coding
from line 321
325321
326322 Multiagent orchestration configuration. Full replacement. Omit to preserve; send null to clear.
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- `name: optional string`
373481
374482 Human-readable name. Must be non-empty. Omit to preserve. Cannot be cleared.
from line 1151
10431151
10441152 - `"claude-haiku-4-5"`
10451153
1046 Fastest model with near-frontier intelligence
1047
10481154 - `"claude-haiku-4-5-20251001"`
10491155
1050 Fastest model with near-frontier intelligence
1051
10521156 - `"claude-opus-4-5"`
10531157
10541158 Powerful intelligence for long-running agents and coding
from line 1225
11211225
11221226 Multiagent orchestration configuration. Null when the agent is single-threaded.
11231227
1124 - `type: "coordinator"`
1228 - `BetaManagedAgentsMultiagentCoordinator object`
11251229
1126 - `agents: array of BetaManagedAgentsAgentReference or BetaManagedAgentsAdvisor`
1230 Resolved coordinator topology with a concrete agent roster.
11271231
1128 Agents the coordinator may spawn as session threads, each resolved to a specific version.
1232 - `type: "coordinator"`
11291233
1130 - `BetaManagedAgentsAgentReference object`
1234 - `agents: array of BetaManagedAgentsAgentReference or BetaManagedAgentsAdvisor`
11311235
1132 A resolved agent reference with a concrete version.
1236 Agents the coordinator may spawn as session threads, each resolved to a specific version.
11331237
1134 - `type: "agent"`
1238 - `BetaManagedAgentsAgentReference object`
11351239
1136 - `id: string`
1240 A resolved agent reference with a concrete version.
11371241
1138 - `version: number`
1242 - `type: "agent"`
11391243
1140 format: int32
1244 - `id: string`
11411245
1142 - `BetaManagedAgentsAdvisor object`
1246 - `version: number`
11431247
1144 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
1248 format: int32
11451249
1146 - `type: "advisor"`
1250 - `BetaManagedAgentsAdvisor object`
11471251
1148 - `model: string`
1252 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
11491253
1150 The advisor model id.
1254 - `type: "advisor"`
11511255
1256 - `model: string`
1257
1258 The advisor model id.
1259
1260 - `BetaManagedAgentsMultiagent20261001 object`
1261
1262 Resolved multiagent configuration with three members, each enabled or disabled on its own.
1263
1264 - `type: "multiagent_20261001"`
1265
1266 - `advisor: BetaManagedAgentsMultiagentAdvisor`
1267
1268 Whether the session's primary thread can consult an advisor model.
1269
1270 - `BetaManagedAgentsMultiagentAdvisorEnabled object`
1271
1272 The session's primary thread can consult `model` mid-turn.
1273
1274 - `type: "enabled"`
1275
1276 - `model: string`
1277
1278 The advisor model id.
1279
1280 - `BetaManagedAgentsMultiagentAdvisorDisabled object`
1281
1282 The agent has no advisor.
1283
1284 - `type: "disabled"`
1285
1286 - `subagents: BetaManagedAgentsMultiagentSubagents`
1287
1288 Whether the agent can spawn session threads.
1289
1290 - `BetaManagedAgentsMultiagentSubagentsEnabled object`
1291
1292 The agent can spawn session threads.
1293
1294 - `type: "enabled"`
1295
1296 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
1297
1298 Whether the agent can define inline agents, which are not saved, when it spawns session threads.
1299
1300 - `BetaManagedAgentsMultiagentInlineAgentsEnabled object`
1301
1302 The agent can define inline agents.
1303
1304 - `type: "enabled"`
1305
1306 - `BetaManagedAgentsMultiagentInlineAgentsDisabled object`
1307
1308 The agent cannot define inline agents.
1309
1310 - `type: "disabled"`
1311
1312 - `predefined_agents: array of BetaManagedAgentsAgentReference`
1313
1314 Predefined agents, which are saved agents that this agent can spawn as session threads, each resolved to a specific version.
1315
1316 - `type: "agent"`
1317
1318 - `id: string`
1319
1320 - `version: number`
1321
1322 format: int32
1323
1324 - `BetaManagedAgentsMultiagentSubagentsDisabled object`
1325
1326 The agent cannot spawn session threads.
1327
1328 - `type: "disabled"`
1329
1330 - `workflows: BetaManagedAgentsMultiagentWorkflows`
1331
1332 Whether the agent can start workflow runs.
1333
1334 - `BetaManagedAgentsMultiagentWorkflowsEnabled object`
1335
1336 The agent can start workflow runs.
1337
1338 - `type: "enabled"`
1339
1340 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
1341
1342 Whether a run's plan can define inline agents, which are not saved.
1343
1344 - `predefined_agents: array of BetaManagedAgentsAgentReference`
1345
1346 Predefined agents, which are saved agents that a run's plan can use, each resolved to a specific version.
1347
1348 - `type: "agent"`
1349
1350 - `id: string`
1351
1352 - `version: number`
1353
1354 format: int32
1355
1356 - `BetaManagedAgentsMultiagentWorkflowsDisabled object`
1357
1358 The agent cannot start workflow runs.
1359
1360 - `type: "disabled"`
1361
11521362 - `name: string`
11531363
11541364 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
from line 1839
16291839 -H "X-Api-Key: $ANTHROPIC_API_KEY" \
16301840 -d '{
16311841 "description": "updated",
1632 "multiagent": {
1633 "agents": [
1634 "agent_011CZkYqphY8vELVzwCUpqiQ",
1635 {
1636 "type": "self"
1637 }
1638 ],
1639 "type": "coordinator"
1640 },
16411842 "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.",
16421843 "version": 1
16431844 }'
from line 1871
16701871 "speed": "standard"
16711872 },
16721873 "multiagent": {
1673 "agents": [
1674 {
1675 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
1676 "type": "agent",
1677 "version": 1
1678 }
1679 ],
1680 "type": "coordinator"
1874 "advisor": {
1875 "type": "disabled"
1876 },
1877 "subagents": {
1878 "inline_agents": {
1879 "type": "enabled"
1880 },
1881 "predefined_agents": [
1882 {
1883 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
1884 "type": "agent",
1885 "version": 1
1886 }
1887 ],
1888 "type": "enabled"
1889 },
1890 "type": "multiagent_20261001",
1891 "workflows": {
1892 "inline_agents": {
1893 "type": "enabled"
1894 },
1895 "predefined_agents": [
1896 {
1897 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
1898 "type": "agent",
1899 "version": 1
1900 }
1901 ],
1902 "type": "enabled"
1903 }
16811904 },
16821905 "name": "My First Agent",
16831906 "skills": [
No line in this hunk matches that.