Skip to main content
GET
/
talk2data
/
chat
/
sessions
/
{session_id}
/
turns
/
{turn_id}
Get turn by ID
curl --request GET \
  --url https://api.example.com/talk2data/chat/sessions/{session_id}/turns/{turn_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'x-project-id: <x-project-id>'
{
  "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": ""
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.emergence.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

turn_id
string
required

Turn ID

Response

Successful Response

One turn with messages and streamed task status history (from task_updates table).

turn_id
string
required
messages
TurnMessageResponse · object[]
required
state
string
default:created
feedback
TurnFeedbackSummary · object

Optional feedback summary attached to a turn.

task_updates
TaskUpdateResponse · object[]