List Sessions

get/v1/sessions?beta=true

Query parameters

limitinteger

Maximum number of results to return.

pagestring

Opaque pagination cursor from a previous response.

include_archivedboolean

When true, includes archived sessions. Default: false (exclude archived).

created_at[gte]string date-time

A timestamp in RFC 3339 format

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

created_at[gt]string date-time

A timestamp in RFC 3339 format

Return sessions created after this time (exclusive).

created_at[lte]string date-time

A timestamp in RFC 3339 format

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

created_at[lt]string date-time

A timestamp in RFC 3339 format

Return sessions created before this time (exclusive).

agent_idstring

Filter sessions created with this agent ID.

agent_versioninteger

Filter by agent version. Only applies when agent_id is also set.

order'asc' | 'desc'

ListOrder enum

Sort direction for results, ordered by created_at. Defaults to desc (newest first).

memory_store_idstring

Filter sessions whose resources contain a memory_store with this memory store ID.

deployment_idstring

Filter sessions created by this deployment ID.

statuses[]BetaManagedAgentsSessionStatus[]

Filter by session status. Repeat the parameter to match any of multiple statuses.

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.

prev_pagestring nullable

Opaque cursor for the previous page. Null when on the first page. Pass as the page parameter to navigate backward.

Example response

{
  "data": [],
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo=",
  "prev_page": "page_MjAyNS0wNS0xM1QwMDowMDowMFo="
}

Changes

Changed in 17 of the 68 revisions of this API.3559

Sep 1, 2026d1d189d791d12See the full diff
- ○
  added subschema #2 to the data/items/agent/model/id response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  added subschema #2 to the data/items/agent/multiagent/anyOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/oneOf[BetaManagedAgentsSessionThreadAgent]/model/id response property anyOf list for the response status 200
  response-property-any-of-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 19, 20260042750ea1ee82See the full diff
- ▲
  added BetaManagedAgentsBashToolConfig BetaManagedAgentsEditToolConfig BetaManagedAgentsReadToolConfig BetaManagedAgentsWriteToolConfig BetaManagedAgentsGlobToolConfig BetaManagedAgentsGrepToolConfig BetaManagedAgentsWebFetchToolConfig BetaManagedAgentsWebSearchToolConfig to the data/items/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 data/items/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 data/items/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 data/items/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 data/items/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 data/items/agent/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401]/configs/items/enabled from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property data/items/agent/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401]/configs/items/name from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property data/items/agent/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401]/configs/items/permission_policy from the response with the 200 status
  response-required-property-removed
- ○
  added discriminator to data/items/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 data/items/agent/tools/items/oneOf[BetaManagedAgentsAgentToolset20260401]/configs/items/ response property for the response status 200
  response-property-discriminator-added
Aug 17, 2026d2b230555b7f1217See the full diff
- ▲
  response property data/items/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 data/items/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 data/items/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 data/items/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 data/items/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 data/items/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 data/items/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 data/items/title 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
- ▲
  response property prev_page list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  the data/items/resources/items/oneOf[BetaManagedAgentsMemoryStoreResource]/instructions response property's maxLength was unset from 4096 for the response status 200
  response-property-max-length-unset
- ▲
  the data/items/resources/items/oneOf[BetaManagedAgentsGitHubRepositoryResource]/checkout response's property type/format changed from object/ to / for status 200
  response-property-type-changed
- ○
  removed BetaManagedAgentsBudget from the data/items/budget response property allOf list for the response status 200
  response-property-all-of-removed
- ○
  removed BetaManagedAgentsMountMode from the data/items/resources/items/oneOf[BetaManagedAgentsMemoryStoreResource]/access response property allOf list for the response status 200
  response-property-all-of-removed
- ○
  removed BetaManagedAgentsServerToolUsage from the data/items/usage/allOf[BetaManagedAgentsSessionUsage]/server_tool_use response property allOf list for the response status 200
  response-property-all-of-removed
- ○
  removed BetaManagedAgentsSessionMultiagent from the data/items/agent/multiagent response property allOf list for the response status 200
  response-property-all-of-removed
- ○
  removed BetaMonetaryAmount from the data/items/usage/allOf[BetaManagedAgentsSessionUsage]/list_cost 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
- ○
  removed BetaTimestamp from the data/items/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 data/items/budget response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  added BetaManagedAgentsMountMode subschema #2 to the data/items/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 data/items/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 data/items/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 data/items/agent/multiagent response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  added BetaMonetaryAmount subschema #2 to the data/items/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 data/items/archived_at response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  added BetaTimestamp subschema #2 to the data/items/outcome_evaluations/items/completed_at response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  removed discriminator from data/items/resources/items/oneOf[BetaManagedAgentsGitHubRepositoryResource]/checkout response property for the response status 200
  response-property-discriminator-removed
- ○
  removed BetaManagedAgentsBranchCheckout BetaManagedAgentsCommitCheckout from the data/items/resources/items/oneOf[BetaManagedAgentsGitHubRepositoryResource]/checkout response property oneOf list for the response status 200
  response-property-one-of-removed
Aug 6, 202693d8fd7d6493126See the full diff
- ▲
  added BetaManagedAgentsSessionThreadAgent BetaManagedAgentsAdvisor to the data/items/agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/ response property oneOf list for the response status 200
  response-property-one-of-added
- ▲
  the data/items/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 data/items/agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/description from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property data/items/agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/id from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property data/items/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 data/items/agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/model from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property data/items/agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/name from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property data/items/agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/skills from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property data/items/agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/system from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property data/items/agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/tools from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property data/items/agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/type from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property data/items/agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/version from the response with the 200 status
  response-required-property-removed
- ○
  added the optional property data/items/agent/model/inference_geo to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/items/usage/allOf[BetaManagedAgentsSessionUsage]/active_seconds to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/items/usage/allOf[BetaManagedAgentsSessionUsage]/list_cost to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/items/usage/allOf[BetaManagedAgentsSessionUsage]/server_tool_use to the response with the 200 status
  response-optional-property-added
- ○
  added discriminator to data/items/agent/multiagent/allOf[BetaManagedAgentsSessionMultiagent]/oneOf[BetaManagedAgentsSessionMultiagentCoordinator]/agents/items/ response property for the response status 200
  response-property-discriminator-added
- ○
  added the required property data/items/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, 2026a97790bd7f184See the full diff
- ○
  added subschema #4 subschema #5 subschema #6 subschema #7 subschema #11 subschema #12 to the data/items/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 data/items/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 data/items/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 data/items/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, 20265e4a8830793b2See the full diff
- ○
  added the optional property data/items/agent/model/effort to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/items/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
Jun 30, 202626335fd8487a1See the full diff
- ○
  added the optional property prev_page to the response with the 200 status
  response-optional-property-added
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 data/items/agent/model/id response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  added subschema #2 to the data/items/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, 20262336fecb081b2See the full diff
- ○
  added the new optional query request parameter deployment_id
  new-optional-request-parameter
- ○
  added the optional property data/items/deployment_id to the response with the 200 status
  response-optional-property-added
Jun 9, 202600259327305f2See the full diff
- ○
  added subschema #2 to the data/items/agent/model/id response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  added subschema #2 to the data/items/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 (17 revisions)