ANanthropics

List Events

Changed on
get/v1/sessions/{session_id}/events?beta=true

Request

Path parameters

session_idstring required

Query parameters

limitinteger
pagestring

Opaque pagination cursor from a previous response's next_page.

order'asc' | 'desc'

Sort direction for results, ordered by the event's processed_at. Defaults to asc (chronological).

types[]BetaManagedAgentsSessionEventType[]

Filter by event type. Values match the type field on returned events (for example, user.message or agent.tool_use). Omit to return all event types.

created_at[gte]string date-time

A timestamp in RFC 3339 format

Return events created at or after this time (inclusive). Compared against the event's processed_at value.

created_at[gt]string date-time

A timestamp in RFC 3339 format

Return events created after this time (exclusive). Compared against the event's processed_at value.

created_at[lte]string date-time

A timestamp in RFC 3339 format

Return events created at or before this time (inclusive). Compared against the event's processed_at value.

created_at[lt]string date-time

A timestamp in RFC 3339 format

Return events created before this time (exclusive). Compared against the event's processed_at value.

Headers

anthropic-versionstring

The version of the Claude API you want to use.

Read more about versioning and our version history here.

anthropic-workspace-idstring

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Response

Successful response (OK)

next_pagestring nullable

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

Example response

{
  "data": [
    {
      "type": "user.message",
      "id": "sevt_011CZkZGPp1iBcp4kaQSihUm",
      "content": [
        {
          "type": "text",
          "text": "Where is my order #1234?"
        }
      ],
      "processed_at": "2026-03-15T10:00:00Z"
    },
    {
      "type": "agent.message",
      "id": "sevt_011CZkZHPq1jCdq5mbRTjiVn",
      "content": [
        {
          "type": "text",
          "text": "Let me look up order #1234 for you."
        }
      ],
      "processed_at": "2026-03-15T10:00:00Z"
    }
  ],
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}

Changes

  • d53195e9d075Revision changes
    • info

      added subschema #1 to the //////////// response property anyOf list for the response status

    • info

      added subschema #1 to the //////////////////////////////// response property anyOf list for the response status

    • info

      added subschema #1 to the //////////////////////////////// response property anyOf list for the response status

    • info

      added subschema #1 to the /////////////////////////// response property anyOf list for the response status

  • 037a593978dcRevision changes
    • info

      added the enum value admin-user-sign-out-2026-10-08 to the property items/anyOf[subschema #2]/ of the header request parameter anthropic-beta