Create Session

post/v1/sessions?beta=true

Headers

anthropic-versionstring

anthropic-betastring

Request body

environment_idstring required

ID of the environment defining the container configuration for this session.

titlestring nullable

Human-readable session title.

metadataobject

Arbitrary key-value metadata attached to the session. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.

vault_idsstring[]

Vault IDs for stored credentials the agent can use during the session.

Example request

{
  "agent": "agent_011CZkYpogX7uDKUyvBTophP",
  "environment_id": "env_011CZkZ9X2dpNyB7HsEFoRfW",
  "title": "Order #1234 inquiry"
}

Response

Successful response (OK)

type'session' required

idstring required

status'rescheduling' | 'running' | 'idle' | 'terminated' required

SessionStatus enum

created_atstring date-time required

A timestamp in RFC 3339 format

updated_atstring date-time required

A timestamp in RFC 3339 format

environment_idstring required

titlestring nullable required

metadataobject required

vault_idsstring[] required

Vault IDs attached to the session at creation. Empty when no vaults were supplied.

archived_atstring date-time required

A timestamp in RFC 3339 format

deployment_idstring nullable

Deployment ID when the session was created from a deployment reference. Null otherwise.

Example response

{
  "type": "session",
  "id": "sesn_011CZkZAtmR3yMPDzynEDxu7",
  "status": "idle",
  "created_at": "2026-03-15T10:00:00Z",
  "updated_at": "2026-03-15T10:00:00Z",
  "archived_at": null,
  "budget": null,
  "environment_id": "env_011CZkZ9X2dpNyB7HsEFoRfW",
  "title": "Order #1234 inquiry",
  "metadata": {},
  "agent": {
    "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
  },
  "resources": [
    {
      "type": "file",
      "id": "sesrsc_011CZkZBJq5dWxk9fVLNcPht",
      "file_id": "file_011CNha8iCJcU1wXNR6q4V8w",
      "mount_path": "/uploads/receipt.pdf",
      "created_at": "2026-03-15T10:00:00Z",
      "updated_at": "2026-03-15T10:00:00Z"
    },
    {
      "type": "github_repository",
      "id": "sesrsc_011CZkZCKr6eXyl0gWMOdQiu",
      "url": "https://github.com/example-org/example-repo",
      "mount_path": "/workspace/example-repo",
      "checkout": {
        "type": "branch",
        "name": "main"
      },
      "created_at": "2026-03-15T10:00:00Z",
      "updated_at": "2026-03-15T10:00:00Z"
    }
  ],
  "vault_ids": [
    "vlt_011CZkZDLs7fYzm1hXNPeRjv"
  ],
  "usage": {
    "input_tokens": 0,
    "output_tokens": 0,
    "cache_read_input_tokens": 0
  },
  "stats": {
    "duration_seconds": 0,
    "active_seconds": 0
  },
  "outcome_evaluations": [
    {
      "type": "outcome_evaluation",
      "outcome_id": "outc_011CZkZRSw2kEfs6ncTVljxP",
      "description": "Produce a 2-page summary as summary.md",
      "result": "satisfied",
      "iteration": 0,
      "completed_at": "2026-03-15T10:02:31Z",
      "explanation": "All five sections present with inline citations."
    }
  ]
}

Changes

Changed in 16 of the 67 revisions of this API.571291

Aug 19, 20260042750ea1ee834See the full diff
- ▲
  added BetaManagedAgentsBashToolConfig BetaManagedAgentsEditToolConfig BetaManagedAgentsReadToolConfig BetaManagedAgentsWriteToolConfig BetaManagedAgentsGlobToolConfig BetaManagedAgentsGrepToolConfig BetaManagedAgentsWebFetchToolConfig BetaManagedAgentsWebSearchToolConfig to the agent/multiagent/anyOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/oneOf[BetaManagedAgentsSessionThreadAgent]/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401]/configs/items/ response property oneOf list for the response status 200
  response-property-one-of-added
- ▲
  added BetaManagedAgentsBashToolConfig BetaManagedAgentsEditToolConfig BetaManagedAgentsReadToolConfig BetaManagedAgentsWriteToolConfig BetaManagedAgentsGlobToolConfig BetaManagedAgentsGrepToolConfig BetaManagedAgentsWebFetchToolConfig BetaManagedAgentsWebSearchToolConfig to the agent/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401]/configs/items/ response property oneOf list for the response status 200
  response-property-one-of-added
- ▲
  removed the required property agent/multiagent/anyOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/oneOf[BetaManagedAgentsSessionThreadAgent]/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401]/configs/items/enabled from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property agent/multiagent/anyOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/oneOf[BetaManagedAgentsSessionThreadAgent]/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401]/configs/items/name from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property agent/multiagent/anyOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/oneOf[BetaManagedAgentsSessionThreadAgent]/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401]/configs/items/permission_policy from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property agent/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401]/configs/items/enabled from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property agent/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401]/configs/items/name from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property agent/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401]/configs/items/permission_policy from the response with the 200 status
  response-required-property-removed
- ●
  removed the request property agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401Params]/configs/items/enabled
  request-property-removed
- ●
  removed the request property agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401Params]/configs/items/name
  request-property-removed
- ●
  removed the request property agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401Params]/configs/items/permission_policy
  request-property-removed
- ○
  added discriminator to agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401Params]/configs/items/ request property
  request-property-discriminator-added
- ○
  added BetaManagedAgentsBashToolConfigParams BetaManagedAgentsEditToolConfigParams BetaManagedAgentsReadToolConfigParams BetaManagedAgentsWriteToolConfigParams BetaManagedAgentsGlobToolConfigParams BetaManagedAgentsGrepToolConfigParams BetaManagedAgentsWebFetchToolConfigParams BetaManagedAgentsWebSearchToolConfigParams to the agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401Params]/configs/items/ request property oneOf list
  request-property-one-of-added
- ○
  added discriminator to agent/multiagent/anyOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/oneOf[BetaManagedAgentsSessionThreadAgent]/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401]/configs/items/ response property for the response status 200
  response-property-discriminator-added
- ○
  added discriminator to agent/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401]/configs/items/ response property for the response status 200
  response-property-discriminator-added
Aug 17, 2026d2b230555b7f31842See the full diff
- ▲
  the request property agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/model/allOf[BetaManagedAgentsModelParams]/oneOf[BetaManagedAgentsModelConfigParams]/effort became not nullable
  request-property-became-not-nullable
- ▲
  the request property agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/model/allOf[BetaManagedAgentsModelParams]/oneOf[BetaManagedAgentsModelConfigParams]/inference_geo became not nullable
  request-property-became-not-nullable
- ▲
  the request property agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/model/allOf[BetaManagedAgentsModelParams]/oneOf[BetaManagedAgentsModelConfigParams]/speed became not nullable
  request-property-became-not-nullable
- ▲
  the request property agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/skills/items/oneOf[BetaManagedAgentsAnthropicSkillParams]/version became not nullable
  request-property-became-not-nullable
- ▲
  the request property agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/skills/items/oneOf[BetaManagedAgentsCustomSkillParams]/version became not nullable
  request-property-became-not-nullable
- ▲
  the request property agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/system became not nullable
  request-property-became-not-nullable
- ▲
  the request property agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401Params]/configs/items/enabled became not nullable
  request-property-became-not-nullable
- ▲
  the request property agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401Params]/configs/items/permission_policy became not nullable
  request-property-became-not-nullable
- ▲
  the request property agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401Params]/default_config became not nullable
  request-property-became-not-nullable
- ▲
  the request property agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/tools/items/oneOf[BetaManagedAgentsMCPToolsetParams]/configs/items/enabled became not nullable
  request-property-became-not-nullable
- ▲
  the request property agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/tools/items/oneOf[BetaManagedAgentsMCPToolsetParams]/configs/items/permission_policy became not nullable
  request-property-became-not-nullable
- ▲
  the request property agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/tools/items/oneOf[BetaManagedAgentsMCPToolsetParams]/default_config became not nullable
  request-property-became-not-nullable
- ▲
  the request property initial_events/items/oneOf[BetaManagedAgentsUserDefineOutcomeEventParams]/max_iterations became not nullable
  request-property-became-not-nullable
- ▲
  the request property initial_events/items/oneOf[BetaManagedAgentsUserMessageEventParams]/content/items/oneOf[BetaManagedAgentsDocumentBlock]/context became not nullable
  request-property-became-not-nullable
- ▲
  the request property initial_events/items/oneOf[BetaManagedAgentsUserMessageEventParams]/content/items/oneOf[BetaManagedAgentsDocumentBlock]/title became not nullable
  request-property-became-not-nullable
- ▲
  the request property resources/items/oneOf[BetaManagedAgentsFileResourceParams]/mount_path became not nullable
  request-property-became-not-nullable
- ▲
  the request property resources/items/oneOf[BetaManagedAgentsGitHubRepositoryResourceParams]/checkout became not nullable
  request-property-became-not-nullable
- ▲
  the request property resources/items/oneOf[BetaManagedAgentsGitHubRepositoryResourceParams]/mount_path became not nullable
  request-property-became-not-nullable
- ▲
  the request property resources/items/oneOf[BetaManagedAgentsMemoryStoreResourceParam]/access became not nullable
  request-property-became-not-nullable
- ▲
  the request property resources/items/oneOf[BetaManagedAgentsMemoryStoreResourceParam]/instructions became not nullable
  request-property-became-not-nullable
- ▲
  the request property title became not nullable
  request-property-became-not-nullable
- ▲
  response property agent/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 agent/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 deployment_id 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 outcome_evaluations/items/explanation 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 resources/items/oneOf[BetaManagedAgentsMemoryStoreResource]/instructions 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 resources/items/oneOf[BetaManagedAgentsMemoryStoreResource]/mount_path 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 resources/items/oneOf[BetaManagedAgentsMemoryStoreResource]/name 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 title list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  the resources/items/oneOf[BetaManagedAgentsMemoryStoreResource]/instructions response property's maxLength was unset from 4096 for the response status 200
  response-property-max-length-unset
- ▲
  the resources/items/oneOf[BetaManagedAgentsGitHubRepositoryResource]/checkout response's property type/format changed from object/ to / for status 200
  response-property-type-changed
- ●
  removed BetaManagedAgentsAgentToolsetDefaultConfigParams from the agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401Params]/default_config request property allOf list
  request-property-all-of-removed
- ●
  removed BetaManagedAgentsEffortParams from the agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/model/allOf[BetaManagedAgentsModelParams]/oneOf[BetaManagedAgentsModelConfigParams]/effort request property allOf list
  request-property-all-of-removed
- ●
  removed BetaManagedAgentsMCPToolsetDefaultConfigParams from the agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/tools/items/oneOf[BetaManagedAgentsMCPToolsetParams]/default_config request property allOf list
  request-property-all-of-removed
- ●
  removed BetaManagedAgentsMountMode from the resources/items/oneOf[BetaManagedAgentsMemoryStoreResourceParam]/access request property allOf list
  request-property-all-of-removed
- ●
  removed BetaManagedAgentsPermissionPolicy from the agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401Params]/configs/items/permission_policy request property allOf list
  request-property-all-of-removed
- ●
  removed BetaManagedAgentsPermissionPolicy from the agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/tools/items/oneOf[BetaManagedAgentsMCPToolsetParams]/configs/items/permission_policy request property allOf list
  request-property-all-of-removed
- ●
  removed BetaManagedAgentsRepositoryCheckout from the resources/items/oneOf[BetaManagedAgentsGitHubRepositoryResourceParams]/checkout request property allOf list
  request-property-all-of-removed
- ●
  removed BetaManagedAgentsSpeed from the agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/model/allOf[BetaManagedAgentsModelParams]/oneOf[BetaManagedAgentsModelConfigParams]/speed request property allOf list
  request-property-all-of-removed
- ○
  added BetaManagedAgentsAgentToolsetDefaultConfigParams subschema #2 to the agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401Params]/default_config request property anyOf list
  request-property-any-of-added
- ○
  added BetaManagedAgentsEffortParams subschema #2 to the agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/model/allOf[BetaManagedAgentsModelParams]/oneOf[BetaManagedAgentsModelConfigParams]/effort request property anyOf list
  request-property-any-of-added
- ○
  added BetaManagedAgentsMCPToolsetDefaultConfigParams subschema #2 to the agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/tools/items/oneOf[BetaManagedAgentsMCPToolsetParams]/default_config request property anyOf list
  request-property-any-of-added
- ○
  added BetaManagedAgentsMountMode subschema #2 to the resources/items/oneOf[BetaManagedAgentsMemoryStoreResourceParam]/access request property anyOf list
  request-property-any-of-added
- ○
  added BetaManagedAgentsPermissionPolicy subschema #2 to the agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401Params]/configs/items/permission_policy request property anyOf list
  request-property-any-of-added
- ○
  added BetaManagedAgentsPermissionPolicy subschema #2 to the agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/tools/items/oneOf[BetaManagedAgentsMCPToolsetParams]/configs/items/permission_policy request property anyOf list
  request-property-any-of-added
- ○
  added BetaManagedAgentsRepositoryCheckout subschema #2 to the resources/items/oneOf[BetaManagedAgentsGitHubRepositoryResourceParams]/checkout request property anyOf list
  request-property-any-of-added
- ○
  added BetaManagedAgentsSpeed subschema #2 to the agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/model/allOf[BetaManagedAgentsModelParams]/oneOf[BetaManagedAgentsModelConfigParams]/speed request property anyOf list
  request-property-any-of-added
- ○
  request property agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/model/allOf[BetaManagedAgentsModelParams]/oneOf[BetaManagedAgentsModelConfigParams]/inference_geo list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  request property agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/skills/items/oneOf[BetaManagedAgentsAnthropicSkillParams]/version list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  request property agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/skills/items/oneOf[BetaManagedAgentsCustomSkillParams]/version list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  request property agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/system list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  request property agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401Params]/configs/items/enabled list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  request property agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/tools/items/oneOf[BetaManagedAgentsMCPToolsetParams]/configs/items/enabled list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  request property initial_events/items/oneOf[BetaManagedAgentsUserDefineOutcomeEventParams]/max_iterations list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  request property initial_events/items/oneOf[BetaManagedAgentsUserMessageEventParams]/content/items/oneOf[BetaManagedAgentsDocumentBlock]/context list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  request property initial_events/items/oneOf[BetaManagedAgentsUserMessageEventParams]/content/items/oneOf[BetaManagedAgentsDocumentBlock]/title list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  request property resources/items/oneOf[BetaManagedAgentsFileResourceParams]/mount_path list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  request property resources/items/oneOf[BetaManagedAgentsGitHubRepositoryResourceParams]/mount_path list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  request property resources/items/oneOf[BetaManagedAgentsMemoryStoreResourceParam]/instructions list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  request property title list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  the agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/skills/items/oneOf[BetaManagedAgentsAnthropicSkillParams]/version request property's minLength was decreased from 1 to 0
  request-property-min-length-decreased
- ○
  the agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/skills/items/oneOf[BetaManagedAgentsCustomSkillParams]/version request property's minLength was decreased from 1 to 0
  request-property-min-length-decreased
- ○
  the resources/items/oneOf[BetaManagedAgentsFileResourceParams]/mount_path request property's minLength was decreased from 1 to 0
  request-property-min-length-decreased
- ○
  the resources/items/oneOf[BetaManagedAgentsGitHubRepositoryResourceParams]/mount_path request property's minLength was decreased from 1 to 0
  request-property-min-length-decreased
- ○
  removed BetaManagedAgentsBudget from the budget response property allOf list for the response status 200
  response-property-all-of-removed
- ○
  removed BetaManagedAgentsMountMode from the resources/items/oneOf[BetaManagedAgentsMemoryStoreResource]/access response property allOf list for the response status 200
  response-property-all-of-removed
- ○
  removed BetaManagedAgentsServerToolUsage from the usage/allOf[BetaManagedAgentsSessionUsage]/server_tool_use response property allOf list for the response status 200
  response-property-all-of-removed
- ○
  removed BetaManagedAgentsSessionMultiagent from the agent/multiagent response property allOf list for the response status 200
  response-property-all-of-removed
- ○
  removed BetaMonetaryAmount from the usage/allOf[BetaManagedAgentsSessionUsage]/list_cost response property allOf list for the response status 200
  response-property-all-of-removed
- ○
  removed BetaTimestamp from the archived_at response property allOf list for the response status 200
  response-property-all-of-removed
- ○
  removed BetaTimestamp from the outcome_evaluations/items/completed_at response property allOf list for the response status 200
  response-property-all-of-removed
- ○
  added BetaManagedAgentsBudget subschema #2 to the budget response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  added BetaManagedAgentsMountMode subschema #2 to the resources/items/oneOf[BetaManagedAgentsMemoryStoreResource]/access response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  added BetaManagedAgentsRepositoryCheckout subschema #2 to the resources/items/oneOf[BetaManagedAgentsGitHubRepositoryResource]/checkout response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  added BetaManagedAgentsServerToolUsage subschema #2 to the usage/allOf[BetaManagedAgentsSessionUsage]/server_tool_use response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  added BetaManagedAgentsSessionMultiagent subschema #2 to the agent/multiagent response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  added BetaMonetaryAmount subschema #2 to the usage/allOf[BetaManagedAgentsSessionUsage]/list_cost response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  added BetaTimestamp subschema #2 to the archived_at response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  added BetaTimestamp subschema #2 to the outcome_evaluations/items/completed_at response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  removed discriminator from resources/items/oneOf[BetaManagedAgentsGitHubRepositoryResource]/checkout response property for the response status 200
  response-property-discriminator-removed
- ○
  removed BetaManagedAgentsBranchCheckout BetaManagedAgentsCommitCheckout from the resources/items/oneOf[BetaManagedAgentsGitHubRepositoryResource]/checkout response property oneOf list for the response status 200
  response-property-one-of-removed
Aug 6, 202693d8fd7d64931210See the full diff
- ▲
  added BetaManagedAgentsSessionThreadAgent BetaManagedAgentsAdvisor to the agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/ response property oneOf list for the response status 200
  response-property-one-of-added
- ▲
  the agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/ response's property type/format changed from object/ to / for status 200
  response-property-type-changed
- ▲
  removed the required property agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/description from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/id from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/mcp_servers from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/model from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/name from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/skills from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/system from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/tools from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/type from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/version from the response with the 200 status
  response-required-property-removed
- ○
  added the new optional request property agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/model/allOf[BetaManagedAgentsModelParams]/oneOf[BetaManagedAgentsModelConfigParams]/inference_geo
  new-optional-request-property
- ○
  added the new optional request property budget
  new-optional-request-property
- ○
  added redacted discriminator mapping keys to the initial_events/items/oneOf[BetaManagedAgentsUserMessageEventParams]/content/items/ request property
  request-property-discriminator-mapping-added
- ○
  added BetaManagedAgentsRedactedBlock to the initial_events/items/oneOf[BetaManagedAgentsUserMessageEventParams]/content/items/ request property oneOf list
  request-property-one-of-added
- ○
  added the optional property agent/model/inference_geo to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property usage/allOf[BetaManagedAgentsSessionUsage]/active_seconds to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property usage/allOf[BetaManagedAgentsSessionUsage]/list_cost to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property usage/allOf[BetaManagedAgentsSessionUsage]/server_tool_use to the response with the 200 status
  response-optional-property-added
- ○
  added discriminator to agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/ response property for the response status 200
  response-property-discriminator-added
- ○
  added the required property budget to the response with the 200 status
  response-required-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 24, 2026a97790bd7f1826See the full diff
- ▲
  removed subschema #4 subschema #5 subschema #6 subschema #10 subschema #11 from the agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/model/allOf[BetaManagedAgentsModelParams]/oneOf[BetaManagedAgentsModelConfigParams]/id request property anyOf list
  request-property-any-of-removed
- ▲
  removed subschema #4 subschema #5 subschema #6 subschema #10 subschema #11 from the agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/model/allOf[BetaManagedAgentsModelParams]/oneOf[subschema #1: BetaManagedAgentsModel]/allOf[subschema #1: BetaManagedAgentsModel]/ request property anyOf list
  request-property-any-of-removed
- ○
  added subschema #4 subschema #5 subschema #6 subschema #7 subschema #11 subschema #12 to the agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/model/allOf[BetaManagedAgentsModelParams]/oneOf[BetaManagedAgentsModelConfigParams]/id request property anyOf list
  request-property-any-of-added
- ○
  added subschema #4 subschema #5 subschema #6 subschema #7 subschema #11 subschema #12 to the agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/model/allOf[BetaManagedAgentsModelParams]/oneOf[subschema #1: BetaManagedAgentsModel]/allOf[subschema #1: BetaManagedAgentsModel]/ request property anyOf list
  request-property-any-of-added
- ○
  added subschema #4 subschema #5 subschema #6 subschema #7 subschema #11 subschema #12 to the agent/model/id response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  added subschema #4 subschema #5 subschema #6 subschema #7 subschema #11 subschema #12 to the agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/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 agent/model/id response property anyOf list for the response status 200
  response-property-any-of-removed
- ○
  removed subschema #4 subschema #5 subschema #6 subschema #10 subschema #11 from the agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/model/id response property anyOf list for the response status 200
  response-property-any-of-removed
Jul 22, 20265e4a8830793b4See the full diff
- ○
  added the new optional request property agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/model/allOf[BetaManagedAgentsModelParams]/oneOf[BetaManagedAgentsModelConfigParams]/effort
  new-optional-request-property
- ○
  added the new optional request property initial_events
  new-optional-request-property
- ○
  added the optional property agent/model/effort to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/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
Jul 2, 2026ec00b28b50c21See the full diff
- ○
  the agent/allOf[BetaManagedAgentsCreateSessionAgentUnionParams]/oneOf[subschema #2]/oneOf[BetaManagedAgentsAgentWithOverridesParams]/tools/items/oneOf[BetaManagedAgentsCustomToolParams]/description request property's maxLength was increased from 1024 to 4096
  request-property-max-length-increased
Jun 30, 202626335fd8487a11See the full diff
- ▲
  added BetaManagedAgentsCreateSessionAgentUnionParams to the agent request property allOf list
  request-property-all-of-added
- ●
  removed BetaManagedAgentsAgentUnionParams from the agent request property allOf list
  request-property-all-of-removed
This revision also has 20 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 30, 20267caa9a75ddbc2See the full diff
- ○
  added subschema #2 to the agent/model/id response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  added subschema #2 to the agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/model/id response property anyOf list for the response status 200
  response-property-any-of-added
Jun 9, 20262336fecb081b1See the full diff
- ○
  added the optional property deployment_id to the response with the 200 status
  response-optional-property-added
Jun 9, 202600259327305f2See the full diff
- ○
  added subschema #2 to the agent/model/id response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  added subschema #2 to the agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/model/id response property anyOf list for the response status 200
  response-property-any-of-added

Full history (16 revisions)