Skip to main content
GET
/
api
/
agents
/
{agentId}
/
run-async
/
{runId}
/
status
cURL
curl -X GET "https://app.cotool.ai/api/agents/:agentId/run-async/:runId/status" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
{
  "status": "running",
  "statusMessage": "<string>"
}

Authorizations

​
Authorization
string
header
required

API Key authentication for programmatic access. Include your API key in the Authorization header as: Bearer your_api_key_here

Path Parameters

​
agentId
string<uuid>
required

Unique identifier of the agent

​
runId
string<uuid>
required

Unique identifier of the asynchronous run to check status for

Response

200 - application/json

Successful response

Status information for asynchronous agent run

​
status
enum<string>
required

Chat execution status

Available options:
running,
waiting,
done,
error,
interrupted
​
statusMessage
string

Additional status context, typically error messages