Skip to main content
GET
/
query
/
runs
/
{runId}
Get the status of an agent run
curl --request GET \
  --url https://api.datalinks.com/api/v1/query/runs/{runId} \
  --header 'Authorization: Bearer <token>'
{
  "runId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "agentKind": "auto_rag",
  "question": "<string>",
  "canResume": true,
  "lastNodeId": "<string>",
  "errorMessage": "<string>",
  "result": {}
}

Authorizations

​
Authorization
string
header
required

Use a Bearer token for authentication. Submit the token using the Authorization header: Authorization: Bearer <token>.

Path Parameters

​
runId
string<uuid>
required

Response

Run status

​
runId
string<uuid>
required
​
agentKind
string
required
Example:

"auto_rag"

​
question
string
required

The original prompt that started the conversation.

​
status
enum<string>
required
Available options:
running,
completed,
failed,
expired
​
canResume
boolean
required

True only when the status is running AND the checkpoint blob loads cleanly.

​
lastNodeId
string
​
errorMessage
string
​
result
object

Rendered AutoRag result for completed runs, in the same shape as POST /query/autorag's response body.