Skip to main content
GET
/
public
/
v1
/
task-runs
/
{runId}
Retrieve task run
curl --request GET \
  --url https://api.komos.ai/public/v1/task-runs/{runId} \
  --header 'Authorization: Bearer <token>'
{
  "run": {
    "id": "220a501c-82f4-43e2-8107-3d8e0c0f4c1b",
    "taskId": "79c6b1aa-24d1-45b3-8c94-9a2e2a2f55bc",
    "status": "COMPLETED",
    "triggerType": "api",
    "timestamps": {
      "createdAt": "2025-10-13T15:02:44.812Z",
      "startedAt": "2025-10-13T15:02:47.001Z",
      "finishedAt": "2025-10-13T15:03:28.559Z"
    },
    "progress": {
      "currentStep": 5,
      "stepsTotal": 5
    },
    "inputs": {
      "url": "https://example.com/orders/48190"
    },
    "outputs": {
      "summary": "Completed order checkout scrape"
    },
    "logsUrl": "https://api.komos.ai/public/v1/task-runs/220a501c-82f4-43e2-8107-3d8e0c0f4c1b/logs",
    "error": null,
    "cancelReason": null
  }
}
Poll this endpoint to follow a specific run until it reaches a terminal state (COMPLETED, FAILED, or CANCELLED). Responses include timestamps, inputs, outputs, and (when configured) a logsUrl pointing to the latest execution logs.

​
Request

​
Path parameters

  • runId — UUID for the run to inspect.

​
Example

curl -X GET \
  https://api.komos.ai/public/v1/task-runs/9c77d908-7bf4-4e7f-9a20-2c5e7fdf2e94 \
  -H 'Authorization: Bearer sk_live_example'

​
Responses

  • 200 OK — Returns { "run": Run } with up-to-date status, progress, outputs, and timestamps.
  • 400 Bad Request — Invalid run ID.
  • 401 Unauthorized — Missing or malformed API key.
  • 404 Not Found — The run does not belong to the authenticated organization.
Use the returned status to drive polling back-off and surface completion details.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
runId
string<uuid>
required

UUID of the run to retrieve.

Response

Run details returned.

​
run
object
required