Skip to main content
GET
Retrieve task run
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

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