Skip to main content
GET
/
talk2data
/
chat
/
sessions
/
{session_id}
/
turns
List session turns
curl --request GET \
  --url https://api.example.com/talk2data/chat/sessions/{session_id}/turns \
  --header 'Authorization: Bearer <token>' \
  --header 'x-project-id: <x-project-id>'
{
  "data": [
    {
      "turn_id": "<string>",
      "messages": [
        {
          "message_id": "<string>",
          "turn_id": "<string>",
          "role": "<string>",
          "content": "<string>",
          "message_type": "<string>",
          "task_id": "<string>",
          "created_at": "<string>",
          "generated_artifacts": [
            {
              "resource_uri": "<string>",
              "artifact_type": "<string>",
              "artifact_title": "<string>",
              "artifact_description": "<string>",
              "metadata": {},
              "created_at": ""
            }
          ],
          "context": {}
        }
      ],
      "state": "created",
      "feedback": {
        "rating": "<string>",
        "comment": "<string>",
        "created_at": "<string>",
        "updated_at": "<string>"
      },
      "task_updates": [
        {
          "id": "<string>",
          "turn_id": "<string>",
          "task_id": "<string>",
          "state": "<string>",
          "final": true,
          "message": "<string>",
          "data": {},
          "agent": "<string>",
          "created_at": ""
        }
      ]
    }
  ],
  "pagination": {
    "page": 2,
    "limit": 50,
    "total_items": 1,
    "total_pages": 1,
    "next_page": 123,
    "prev_page": 123
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
x-project-id
string
required

Project identifier

Path Parameters

​
session_id
string
required

Session ID

Query Parameters

​
page
integer
default:1

Page number (starts at 1)

Required range: x >= 1
​
limit
integer
default:50

Turns per page

Required range: 1 <= x <= 100
​
order
string
default:asc

Order turns by first message time: asc (oldest first, default) or desc (newest first).

Pattern: ^(asc|desc)$

Response

Successful Response

Paginated list of turns (GET /api/chat/sessions/{session_id}/turns).

​
data
TurnItemResponse · object[]
required
​
pagination
Pagination · object
required

Pagination metadata for list responses.