Skip to main content
GET
Get Run Status
Returns the current state of a workflow run. Use this endpoint to poll for progress after creating a run.

Parameters

string
required
Unique identifier for the workflow run. Returned as run_id when you create a run.
string
required
Bearer token. Format: Bearer slat_<your-token>.

Response

Returns 200 OK with the full run details.
string
required
Unique identifier for the run.
string
required
The workflow that this run belongs to.
string
required
Current status of the run. One of: QUEUED, STARTING, RUNNING, COMPLETED, FAILED, CANCELED.
number
Workspace ID assigned to the run. May be null if the run has not started processing.
string
Internal execution ID. May be null if the run has not started processing.
object
Workflow output data. Available when status is COMPLETED. The structure depends on the workflow.
object
Error details when the run has failed. null if the run has not failed.
string
required
Timestamp when the run was created. ISO 8601 format.
string
required
Timestamp of the last status change. ISO 8601 format.
string
Timestamp when the run reached a terminal status (COMPLETED, FAILED, or CANCELED). null while the run is in progress.
object
Custom metadata attached when the run was created. null if none was provided.

Example

Response (running)

Response (completed)

Response (failed)

Polling strategy

Poll this endpoint at 5–10 second intervals. Check for terminal statuses (COMPLETED, FAILED, CANCELED) to know when the run is done.
Python

Status codes

What’s next