agent-setup changedmanaged-agents/agent-setup
Nearest release: v2.1.304, published under an hour after 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+13added
Lines−28removed
From line
38
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits24to this page, all time
The whole hunk
from line 38, old and new numbered
/
from line 38
3838
3939<CodeGroup defaultLanguage="CLI">
4040 ```bash cURL
41 agent=$(curl -fsSL https://api.anthropic.com/v1/agents \
41 curl -fsSL https://api.anthropic.com/v1/agents \
4242 -H "x-api-key: $ANTHROPIC_API_KEY" \
4343 -H "anthropic-version: 2023-06-01" \
4444 -H "anthropic-beta: managed-agents-2026-04-01" \
from line 48
4848 "model": "claude-opus-5-5",
4949 "system": "You are a helpful coding agent.",
5050 "tools": [{"type": "agent_toolset_20260401"}]
51 }')
52
53 AGENT_ID=$(jq -r '.id' <<< "$agent")
54 AGENT_VERSION=$(jq -r '.version' <<< "$agent")
51 }'
5552 ```
5653
5754 <CodeGroupItem>
from line 211
214211
215212Like `speed` (csharp, go: `Speed`) and `effort` (csharp, go: `Effort`), `inference_geo` (java, php: `inferenceGeo`; csharp, go: `InferenceGeo`) is set through the object form of `model` (csharp, go: `Model`): pass `model` (csharp, go: `Model`) as an object and set `inference_geo` (java, php: `inferenceGeo`; csharp, go: `InferenceGeo`) alongside `id` (csharp, go: `ID`). The field accepts `"us"` or `"global"`. When it's unset, each model request follows the workspace's default inference geo at the time it's served. See [Data residency](https://platform.claude.com/docs/en/manage-claude/data-residency) for the workspace-level geo controls and pricing.
216213
217The following example pins an agent to US inference and prints the `inference_geo` (java, php: `inferenceGeo`; csharp, go: `InferenceGeo`) value from the agent's `model` (csharp, go: `Model`) object:
214The following example pins an agent to US inference. The response carries the `inference_geo` (java, php: `inferenceGeo`; csharp, go: `InferenceGeo`) value in the agent's `model` (csharp, go: `Model`) object:
218215
219216<CodeGroup defaultLanguage="CLI">
220217 ```bash cURL
221 agent=$(curl -fsSL https://api.anthropic.com/v1/agents \
218 curl -fsSL https://api.anthropic.com/v1/agents \
222219 -H "x-api-key: $ANTHROPIC_API_KEY" \
223220 -H "anthropic-version: 2023-06-01" \
224221 -H "anthropic-beta: managed-agents-2026-04-01" \
from line 224
227224 "name": "Geo-pinned assistant",
228225 "model": {"id": "claude-opus-5-5", "inference_geo": "us"},
229226 "system": "You are a helpful assistant."
230 }')
231
232 echo "Inference geo: $(jq -r '.model.inference_geo' <<< "$agent")"
227 }'
233228 ```
234229
235230 <CodeGroupItem>
from line 353
358353
359354<CodeGroup defaultLanguage="CLI">
360355 ```bash cURL
361 updated_agent=$(curl -fsSL "https://api.anthropic.com/v1/agents/$AGENT_ID" \
356 curl -fsSL "https://api.anthropic.com/v1/agents/$AGENT_ID" \
362357 -H "x-api-key: $ANTHROPIC_API_KEY" \
363358 -H "anthropic-version: 2023-06-01" \
364359 -H "anthropic-beta: managed-agents-2026-04-01" \
from line 362
367362 "version": '"$AGENT_VERSION"',
368363 "system": "You are a helpful coding agent. Always write tests."
369364 }'
370 )
371
372 echo "New version: $(jq -r '.version' <<< "$updated_agent")"
373365 ```
374366
375367 <CodeGroupItem>
from line 461
469461
470462<CodeGroup>
471463 ```bash cURL
472 updated_agent=$(curl -fsSL "https://api.anthropic.com/v1/agents/$AGENT_ID" \
464 curl -fsSL "https://api.anthropic.com/v1/agents/$AGENT_ID" \
473465 -H "x-api-key: $ANTHROPIC_API_KEY" \
474466 -H "anthropic-version: 2023-06-01" \
475467 -H "anthropic-beta: managed-agents-2026-04-01" \
from line 468
476468 -H "content-type: application/json" \
477469 -d '{
478470 "description": "Writes and reviews code."
479 }')
480
481 echo "New version: $(jq -r '.version' <<< "$updated_agent")"
471 }'
482472 ```
483473
484474 ```bash CLI
from line 566
576566
577567<CodeGroup defaultLanguage="CLI">
578568 ```bash cURL
579 cleared_agent=$(curl -fsSL "https://api.anthropic.com/v1/agents/$AGENT_ID" \
569 curl -fsSL "https://api.anthropic.com/v1/agents/$AGENT_ID" \
580570 -H "x-api-key: $ANTHROPIC_API_KEY" \
581571 -H "anthropic-version: 2023-06-01" \
582572 -H "anthropic-beta: managed-agents-2026-04-01" \
from line 575
585575 "description": null,
586576 "metadata": {"team": null},
587577 "multiagent": {"type": "multiagent_20261001", "workflows": null}
588 }')
589
590 echo "Description: $(jq -r '.description' <<< "$cleared_agent")"
578 }'
591579 ```
592580
593581 <CodeGroupItem>
from line 719
731719 curl -fsSL "https://api.anthropic.com/v1/agents/$AGENT_ID/versions" \
732720 -H "x-api-key: $ANTHROPIC_API_KEY" \
733721 -H "anthropic-version: 2023-06-01" \
734 -H "anthropic-beta: managed-agents-2026-04-01" \
735 | jq -r '.data[] | "Version \(.version): \(.updated_at)"'
722 -H "anthropic-beta: managed-agents-2026-04-01"
736723 ```
737724
738725 ```bash CLI
from line 781
794781
795782<CodeGroup>
796783 ```bash cURL
797 archived=$(curl -fsSL -X POST "https://api.anthropic.com/v1/agents/$AGENT_ID/archive" \
784 curl -fsSL -X POST "https://api.anthropic.com/v1/agents/$AGENT_ID/archive" \
798785 -H "x-api-key: $ANTHROPIC_API_KEY" \
799786 -H "anthropic-version: 2023-06-01" \
800 -H "anthropic-beta: managed-agents-2026-04-01")
801
802 echo "Archived at: $(jq -r '.archived_at' <<< "$archived")"
787 -H "anthropic-beta: managed-agents-2026-04-01"
803788 ```
804789
805790 ```bash CLI
No line in this hunk matches that.