Anthropic

Anthropic Agents API

Reusable, versioned agent configurations

GitHub OpenAPI
Business capability
Agent Infrastructure & Agentic Commerce AE-100

Operations 12

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v1/agents/{agent_id}/archive?beta=true Archive an agent (beta-flagged endpoint) · Archive Agent #
Ask an LLM
“Can I archive an agent through the ?beta=true agents endpoint?”
“Using the beta-query variant, how do I archive an agent?”
Tell an agent destructive · confirm first
Archive agent {agent_id} via the beta-flagged endpoint.
Call the ?beta=true archive route for agent {agent_id}.
GET /v1/agents/{agent_id}/versions?beta=true Page through an agent's versions · List Agent Versions #
Ask an LLM
“Can I page through an agent's versions a few at a time?”
“What's the paginated way to read an agent's version list?”
Tell an agent
Page through versions of agent {agent_id}, {limit} at a time.
Get the next page {page} of versions for agent {agent_id}.
GET /v1/agents/{agent_id}?beta=true Retrieve a specific agent version · Get Agent #
Ask an LLM
“Can I fetch an older version of an agent's configuration?”
“How do I pin a lookup to one particular agent version?”
Tell an agent
Get version {version} of agent {agent_id}.
Fetch agent {agent_id} as it was at version {version}.
POST /v1/agents/{agent_id}?beta=true Update an agent, version optional · Update Agent #
Ask an LLM
“Can I update an agent's multiagent settings?”
“Is there an agent update where passing the version is optional?”
Tell an agent
Turn on multiagent config {multiagent} for agent {agent_id}.
Switch agent {agent_id} to model {model} without a version check.
POST /v1/agents?beta=true Create an agent (beta-flagged endpoint) · Create Agent #
Ask an LLM
“Can I create an agent through the ?beta=true route with metadata attached?”
“Using the beta-query create, can an agent get skills and MCP servers?”
Tell an agent
Via the beta-flagged route, create agent {name} on {model} with metadata {metadata}.
Use ?beta=true to create agent {name} using {model} and skills {skills}.
GET /v1/agents?beta=true List agents with date and archive filters · List Agents #
Ask an LLM
“Which agents were created in a given date range?”
“Can I include archived agents when listing them?”
Tell an agent
List agents created after {created_after}.
List all agents including archived: {include_archived}.
POST /v1/agents Define a reusable, versioned agent · Anthropic Create Agent #
Ask an LLM
“How do I define a reusable agent with a system prompt and tools?”
“What does it take to set up a versioned Claude agent?”
Tell an agent
Define a reusable agent {name} running {model}.
Set up agent {name} on {model} with system prompt {system} and tools {tools}.
GET /v1/agents List the workspace's agents · Anthropic List Agents #
Ask an LLM
“What agents have been defined in my workspace?”
“How many agents can I get back in one page?”
Tell an agent
List the agents in my workspace.
Show {limit} agents from this workspace.
GET /v1/agents/{agent_id} Get an agent's latest version · Anthropic Get Agent #
Ask an LLM
“What is the current configuration of my agent?”
“How do I see the latest version of an agent?”
Tell an agent
Show the latest version of agent {agent_id}.
Get agent {agent_id}'s current config.
POST /v1/agents/{agent_id} Update an agent with a version lock · Anthropic Update Agent #
Ask an LLM
“How do I update an agent without clobbering someone else's change?”
“Does changing an agent's fields create a new version?”
Tell an agent
Update agent {agent_id} from version {version} with system prompt {system}.
Change the tools of agent {agent_id}, locking on version {version}, to {tools}.
POST /v1/agents/{agent_id}/archive Archive an agent, sessions keep running · Anthropic Archive Agent #
Ask an LLM
“Do existing sessions keep running when I archive an agent?”
“How do I retire an agent nobody should start new sessions with?”
Tell an agent destructive · confirm first
Archive agent {agent_id} and let its running sessions finish.
Retire agent {agent_id}.
GET /v1/agents/{agent_id}/versions Get an agent's full version history · Anthropic List Agent Versions #
Ask an LLM
“How has my agent's configuration changed over time?”
“Can I see the complete version history of an agent?”
Tell an agent
Show the full version history of agent {agent_id}.
List every version agent {agent_id} has had.

Documentation

📖
Documentation
https://docs.anthropic.com/en/api/admin-api/users/get-user
📖
Documentation
https://docs.anthropic.com/en/api/prompt-tools-generate
📖
Documentation
https://docs.anthropic.com/en/api/usage-cost-api
📖
Documentation
https://platform.claude.com/docs/en/managed-agents/overview
📖
Documentation
https://platform.claude.com/docs/en/managed-agents/agent-setup
📖
Documentation
https://platform.claude.com/docs/en/managed-agents/sessions
📖
Documentation
https://platform.claude.com/docs/en/managed-agents/environments

Specifications

⚙
OpenAPI
https://artifacts.apis.io/anthropic/openapi/anthropic-agents-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/anthropic/json-schema/anthropic-beta-managed-agents-agent-schema.json
📊
JSONSchema
https://artifacts.apis.io/anthropic/json-schema/anthropic-beta-managed-agents-update-agent-params-schema.json
📊
JSONSchema
https://artifacts.apis.io/anthropic/json-schema/anthropic-agent-schema.json
📊
JSONSchema
https://artifacts.apis.io/anthropic/json-schema/anthropic-create-agent-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/anthropic/json-schema/anthropic-beta-managed-agents-list-agent-versions-schema.json
📊
JSONSchema
https://artifacts.apis.io/anthropic/json-schema/anthropic-update-agent-request-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/anthropic:anthropic-agents-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

anthropic-agents-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Anthropic Agents API
  version: '1.0'
  description: 'Operations tagged Agents across 2 of this provider''s published API definitions: anthropic-api-openapi.json, anthropic-managed-agents-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.anthropic.com
tags:


# --- truncated at 32 KB (106 KB total) ---
# Full source: https://artifacts.apis.io/anthropic/openapi/anthropic-agents-api-openapi.yml