Skip to main content
GET
/
api
/
v3
/
threads
/
{id}
/
turns
List conversation turns in a thread
curl --request GET \
  --url https://paradigm.lighton.ai/api/v3/threads/{id}/turns \
  --header 'Authorization: Bearer <token>'
{
  "count": 123,
  "next": "<string>",
  "previous": "<string>",
  "results": [
    {
      "id": "<string>",
      "thread": "<string>",
      "status": "running",
      "messages": [
        {
          "id": "<string>",
          "role": "user",
          "parts": [
            {
              "type": "text",
              "text": "<string>",
              "reasoning": "<string>",
              "tool_call": {
                "id": "<string>",
                "tool": {
                  "id": "<string>",
                  "name": "<string>",
                  "type": "native",
                  "object": "tool",
                  "mcp_server_name": "<string>",
                  "require_document": true,
                  "accepted_file_types": [
                    "<string>"
                  ]
                },
                "created_at": "2023-11-07T05:31:56Z",
                "updated_at": "2023-11-07T05:31:56Z",
                "object": "tool_call",
                "tool_args": {},
                "steps": [
                  {
                    "status": "<string>",
                    "created_at": "2023-11-07T05:31:56Z",
                    "progress_report": {
                      "progress_percentage": 123,
                      "current_progress_text": "<string>",
                      "time_remaining_estimate": 123,
                      "metadata": {}
                    }
                  }
                ],
                "result": {
                  "text": "<string>",
                  "file_artifacts": [
                    {}
                  ],
                  "web_sources": [
                    {}
                  ],
                  "chunk_sources": [
                    {}
                  ]
                }
              },
              "document": {
                "id": "<string>"
              },
              "workspace": {
                "id": "<string>",
                "name": "<string>",
                "type": "company",
                "files_count": 123
              }
            }
          ],
          "created_at": "2023-11-07T05:31:56Z",
          "object": "message",
          "force_tool": {
            "id": "<string>",
            "name": "<string>",
            "type": "native",
            "object": "tool",
            "mcp_server_name": "<string>",
            "require_document": true,
            "accepted_file_types": [
              "<string>"
            ]
          },
          "immediate_final_answer": true
        }
      ],
      "created_at": "2023-11-07T05:31:56Z",
      "object": "turn",
      "error": {
        "code": "<string>",
        "message": "<string>"
      },
      "liked": true
    }
  ]
}

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Query Parameters

ending_before
string

ID to end pagination before

Minimum string length: 1
limit
integer
default:10
Required range: 1 <= x <= 100
starting_after
string

ID to start pagination after

Minimum string length: 1

Response

200 - application/json
count
integer | null
required
next
string | null
required
previous
string | null
required
results
object[]
required