All Products
Search

This Product

    Qoder CN Series:List session events

    Document Center

    Qoder CN Series:List session events

    Last Updated:Jul 15, 2026

    List event history for a Forward session.

    Request headers

    Header

    Required

    Description

    Authorization

    Yes

    Bearer <PAT>

    Path parameters

    Parameter

    Type

    Required

    Description

    session_id

    string

    Yes

    Session ID.

    Query parameters

    Parameter

    Type

    Required

    Default

    Description

    limit

    integer

    No

    20

    Items per page. Maximum 100.

    after_id

    string

    No

    -

    Cursor for events after the given Event ID.

    before_id

    string

    No

    -

    Cursor for events before the given Event ID.

    order

    string

    No

    asc

    Sort order: asc or desc.

    type

    string

    No

    -

    Filter by Event type. Comma-separated values are supported.

    types[]

    string

    No

    -

    Array-style Event type filter.

    include_tool_calls

    boolean

    No

    true

    Include tool call events.

    include_thinking

    boolean

    No

    true

    Include thinking events.

    Example request

    curl -s -X GET 'https://api.qoder.com.cn/api/v1/forward/sessions/sess_xxx/events?limit=20&order=asc' \
  -H "Authorization: Bearer $QODER_PAT"

    Example response

    HTTP 200 OK

    {
  "data": [
    {
      "id": "evt_xxx",
      "type": "agent.message",
      "session_id": "sess_xxx",
      "content": [
        {
          "type": "text",
          "text": "Here is the analysis result."
        }
      ],
      "processed_at": "2026-06-22T11:00:03Z"
    }
  ],
  "first_id": "evt_xxx",
  "last_id": "evt_xxx",
  "has_more": false
}

    Response fields

    Field

    Type

    Description

    data

    array

    Event objects on the current page.

    first_id

    string|null

    ID of the first event on this page.

    last_id

    string|null

    ID of the last event on this page.

    has_more

    boolean

    Whether more records remain.

    Event fields

    Field

    Type

    Description

    id

    string

    Event ID.

    type

    string

    Event type.

    session_id

    string

    Session ID.

    processed_at

    string

    Processing timestamp when available.

    content

    array

    Returned for message-like events.

    Errors

    HTTP

    Type

    Code

    Trigger

    400

    invalid_request_error

    invalid_event_cursor

    Cursor does not belong to this Session.

    400

    invalid_request_error

    invalid_pagination

    Pagination parameters are invalid.

    401

    authentication_error

    TOKEN_INVALID

    PAT invalid or expired.

    404

    not_found_error

    session_not_found

    Session does not exist.

    Notes

    • Unknown Event types do not fail the request. They are returned with the minimal envelope when available.

    • Forward filters runtime-private fields such as agent IDs, environment IDs, resources, vaults, worker IDs, traces, and raw/debug/internal payloads.