Skip to main content

List session threads

Paginated list of coordinator and child threads for a Forward Session.

Request Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT>

Path Parameters

ParameterTypeRequiredDescription
session_idstringYesSession ID.

Query Parameters

ParameterTypeRequiredDefaultDescription
limitintegerNo20Page size, maximum 100.
orderstringNoascSort direction: asc or desc.
before_idstringNo-Returns records before this Thread ID.
after_idstringNo-Returns records after this Thread ID.
statuses[]stringNo-Status filter that can be passed multiple times.
include_archivedbooleanNofalseWhether to include archived Threads.

Example Request

curl -s -X GET 'https://api.qoder.com.cn/api/v1/forward/sessions/sess_xxx/threads' \
  -H "Authorization: Bearer $QODER_PAT"

Example Response

HTTP 200 OK 
{
  "data": [
    {
      "id": "sthr_xxx",
      "type": "session_thread",
      "session_id": "sess_xxx",
      "template_id": "tmpl_support",
      "name": "",
      "role": "coordinator",
      "status": "idle",
      "stop_reason": {
        "type": "end_turn"
      },
      "created_at": "2026-06-22T10:00:00Z",
      "updated_at": "2026-06-22T10:05:00Z"
    }
  ],
  "first_id": "sthr_xxx",
  "last_id": "sthr_xxx",
  "has_more": false
}

Response Fields

Field

Type

Description

data

array

Thread objects on the current page.

first_id

string|null

ID of the first Thread on the current page.

last_id

string|null

ID of the last Thread on the current page.

has_more

boolean

Whether more records remain.

Errors

HTTPTypeCodeTrigger
400invalid_request_errorinvalid_paginationPagination parameters are invalid.
404not_found_errorsession_not_foundSession does not exist.
401authentication_errorauthentication_requiredPAT is invalid or has expired.

Notes

  • Thread responses do not expose runtime-private agent IDs or raw agent versions.
  • template_id is returned only when Forward can reliably map it.
Overview
Getting Started