Sign in

List Agents

get/v1/agents?beta=true

Query parameters

limitinteger

Maximum results per page. Default 20, maximum 100.

pagestring

Opaque pagination cursor from a previous response.

created_at[gte]string date-time

A timestamp in RFC 3339 format

Return agents created at or after this time (inclusive).

created_at[lte]string date-time

A timestamp in RFC 3339 format

Return agents created at or before this time (inclusive).

include_archivedboolean

Include archived agents in results. Defaults to false.

Headers

x-api-keystring
anthropic-versionstring
anthropic-betastring

Response

Successful response (OK)

next_pagestring nullable

Opaque cursor for the next page. Null when no more results.

Example response

{
  "data": [
    {
      "type": "agent",
      "id": "agent_011CZkYpogX7uDKUyvBTophP",
      "version": 1,
      "name": "My First Agent",
      "description": "A general-purpose starter agent.",
      "model": {
        "id": "claude-opus-5",
        "speed": "standard"
      },
      "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.",
      "tools": [
        {
          "type": "agent_toolset_20260401",
          "default_config": {
            "enabled": true,
            "permission_policy": {
              "type": "always_ask"
            }
          },
          "configs": []
        }
      ],
      "mcp_servers": [
        {
          "type": "url",
          "name": "example-mcp",
          "url": "https://example-server.modelcontextprotocol.io/sse"
        }
      ],
      "skills": [
        {
          "type": "anthropic",
          "skill_id": "xlsx",
          "version": "1"
        },
        {
          "type": "custom",
          "skill_id": "skill_011CZkZFNu9hAbo3jZPRgTlx",
          "version": "2"
        }
      ],
      "multiagent": null,
      "metadata": {
        "foo": "bar"
      },
      "created_at": "2026-03-15T10:00:00Z",
      "updated_at": "2026-03-15T10:00:00Z",
      "archived_at": null
    }
  ]
}

Changes

Changed in 12 of the 67 revisions of this API.1322

  • 0042750ea1ee41See the full diff
    • ▲

      added BetaManagedAgentsBashToolConfig BetaManagedAgentsEditToolConfig BetaManagedAgentsReadToolConfig BetaManagedAgentsWriteToolConfig BetaManagedAgentsGlobToolConfig BetaManagedAgentsGrepToolConfig BetaManagedAgentsWebFetchToolConfig BetaManagedAgentsWebSearchToolConfig to the data/items/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401]/configs/items/ response property oneOf list for the response status 200

      response-property-one-of-added

    • ▲

      removed the required property data/items/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401]/configs/items/enabled from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property data/items/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401]/configs/items/name from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property data/items/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401]/configs/items/permission_policy from the response with the 200 status

      response-required-property-removed

    • ○

      added discriminator to data/items/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401]/configs/items/ response property for the response status 200

      response-property-discriminator-added

  • d2b230555b7f34See the full diff
    • ▲

      response property data/items/description list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • ▲

      response property data/items/system list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • ▲

      response property next_page list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • ○

      removed BetaManagedAgentsMultiagent from the data/items/multiagent response property allOf list for the response status 200

      response-property-all-of-removed

    • ○

      removed BetaTimestamp from the data/items/archived_at response property allOf list for the response status 200

      response-property-all-of-removed

    • ○

      added BetaManagedAgentsMultiagent subschema #2 to the data/items/multiagent response property anyOf list for the response status 200

      response-property-any-of-added

    • ○

      added BetaTimestamp subschema #2 to the data/items/archived_at response property anyOf list for the response status 200

      response-property-any-of-added

  • 93d8fd7d649352See the full diff
    • ▲

      added BetaManagedAgentsAgentReference BetaManagedAgentsAdvisor to the data/items/multiagent/allOf[BetaManagedAgentsMultiagent]/oneOf[BetaManagedAgentsMultiagentCoordinator]/agents/items/ response property oneOf list for the response status 200

      response-property-one-of-added

    • ▲

      the data/items/multiagent/allOf[BetaManagedAgentsMultiagent]/oneOf[BetaManagedAgentsMultiagentCoordinator]/agents/items/ response's property type/format changed from object/ to / for status 200

      response-property-type-changed

    • ▲

      removed the required property data/items/multiagent/allOf[BetaManagedAgentsMultiagent]/oneOf[BetaManagedAgentsMultiagentCoordinator]/agents/items/id from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property data/items/multiagent/allOf[BetaManagedAgentsMultiagent]/oneOf[BetaManagedAgentsMultiagentCoordinator]/agents/items/type from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property data/items/multiagent/allOf[BetaManagedAgentsMultiagent]/oneOf[BetaManagedAgentsMultiagentCoordinator]/agents/items/version from the response with the 200 status

      response-required-property-removed

    • ○

      added the optional property data/items/model/inference_geo to the response with the 200 status

      response-optional-property-added

    • ○

      added discriminator to data/items/multiagent/allOf[BetaManagedAgentsMultiagent]/oneOf[BetaManagedAgentsMultiagentCoordinator]/agents/items/ response property for the response status 200

      response-property-discriminator-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • a97790bd7f182See the full diff
    • ○

      added subschema #4 subschema #5 subschema #6 subschema #7 subschema #11 subschema #12 to the data/items/model/id response property anyOf list for the response status 200

      response-property-any-of-added

    • ○

      removed subschema #4 subschema #5 subschema #6 subschema #10 subschema #11 from the data/items/model/id response property anyOf list for the response status 200

      response-property-any-of-removed

  • 5e4a8830793b1See the full diff
    • ○

      added the optional property data/items/model/effort to the response with the 200 status

      response-optional-property-added

    This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 7caa9a75ddbc1See the full diff
    • ○

      added subschema #2 to the data/items/model/id response property anyOf list for the response status 200

      response-property-any-of-added

  • 00259327305f1See the full diff
    • ○

      added subschema #2 to the data/items/model/id response property anyOf list for the response status 200

      response-property-any-of-added

  • 546c704d347b16See the full diff
    • ▲

      response property data/items/tools/items/oneOf[BetaManagedAgentsCustomTool]/input_schema/required list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • ○

      removed BetaManagedAgentsStruct from the data/items/tools/items/oneOf[BetaManagedAgentsCustomTool]/input_schema/properties response property allOf list for the response status 200

      response-property-all-of-removed

    • ○

      added subschema #1 subschema #2 to the data/items/tools/items/oneOf[BetaManagedAgentsCustomTool]/input_schema/properties response property anyOf list for the response status 200

      response-property-any-of-added

    • ○

      the response property data became required for the status 200

      response-property-became-required

    • ○

      the response property data/items/tools/items/oneOf[BetaManagedAgentsCustomTool]/input_schema/type became required for the status 200

      response-property-became-required

    • ○

      the type response property const value object was added for the status 200

      response-property-const-added

    • ○

      removed the object enum value from the data/items/tools/items/oneOf[BetaManagedAgentsCustomTool]/input_schema/type response property for the response status 200

      response-property-enum-value-removed

  • f9d488f9290d1See the full diff
    • ○

      added subschema #2 to the data/items/model/id response property anyOf list for the response status 200

      response-property-any-of-added

  • a4186730f56c1See the full diff
    • ○

      added the required property data/items/multiagent to the response with the 200 status

      response-required-property-added

    This revision also has 22 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog