curl --request POST \
--url https://paradigm.lighton.ai/api/v3/threads/{id}/turns \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "What is the capital of France?"
}
'{
"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_sources": [
{}
],
"timings": {}
}
},
"document": {
"id": "<string>"
},
"workspace": {
"id": "<string>",
"name": "<string>",
"type": "shared",
"files_count": 123
},
"tag": {
"id": 123,
"tag": "<string>"
}
}
],
"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
}{
"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_sources": [
{}
],
"timings": {}
}
},
"document": {
"id": "<string>"
},
"workspace": {
"id": "<string>",
"name": "<string>",
"type": "shared",
"files_count": 123
},
"tag": {
"id": 123,
"tag": "<string>"
}
}
],
"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
}{
"detail": "System is under maintenance.",
"error": "service_maintenance",
"mode": "full_shutdown",
"reason": "<string>",
"started_at": "2023-11-07T05:31:56Z",
"endpoint_category_names": [
"<string>"
]
}Threads
Create a conversation turn in a thread
Ask a query to the agent.
Behaviour:
- Returns 200 with the final answer when the task completes quickly within the request.
- Returns 202 Accepted with the current answer payload when processing continues in the background; clients should poll the turn status or subscribe to updates until completion.
- If
stream=true, the endpoint responds with Server-Sent Events (SSE) and streams tokens/events until completion (content-type: text/event-stream). - If
background=true, the endpoint enqueues processing and returns the created answer immediately.
POST
/
api
/
v3
/
threads
/
{id}
/
turns
curl --request POST \
--url https://paradigm.lighton.ai/api/v3/threads/{id}/turns \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "What is the capital of France?"
}
'{
"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_sources": [
{}
],
"timings": {}
}
},
"document": {
"id": "<string>"
},
"workspace": {
"id": "<string>",
"name": "<string>",
"type": "shared",
"files_count": 123
},
"tag": {
"id": 123,
"tag": "<string>"
}
}
],
"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
}{
"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_sources": [
{}
],
"timings": {}
}
},
"document": {
"id": "<string>"
},
"workspace": {
"id": "<string>",
"name": "<string>",
"type": "shared",
"files_count": 123
},
"tag": {
"id": 123,
"tag": "<string>"
}
}
],
"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
}{
"detail": "System is under maintenance.",
"error": "service_maintenance",
"mode": "full_shutdown",
"reason": "<string>",
"started_at": "2023-11-07T05:31:56Z",
"endpoint_category_names": [
"<string>"
]
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Body
application/jsonapplication/x-www-form-urlencodedmultipart/form-data
Maximum string length:
5000Required range:
1 <= x <= 20Deprecated. True expands to every shared workspace where the COMPANY group is a member (at any role). Will be removed in a future API version — pass explicit workspace_ids instead.
Response
Final answer returned synchronously.
running- runningcompleted- completedfailed- failedcancelled- cancelledcancelling- cancelling
Available options:
running, completed, failed, cancelled, cancelling Show child attributes
Show child attributes
Show child attributes
Show child attributes