Skip to main content
GET
/
runs
List runs
curl --request GET \
  --url https://api.cloudcruise.com/runs \
  --header 'cc-key: <api-key>'
[
  {
    "session_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "status": "execution.success",
    "created_at": "2026-02-15T10:00:00Z",
    "workflow_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "workspace_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "execution_start": "2026-02-15T10:00:01Z",
    "execution_end": "2026-02-15T10:00:30Z",
    "dry_run": false
  }
]

Authorizations

​
cc-key
string
header
required

API key-based authentication. Provide your CloudCruise API key in the cc-key header.

Query Parameters

​
start_time
string<date-time>

ISO 8601 timestamp for the earliest run creation time to include. Cannot be older than 31 days. Defaults to 24 hours ago if not provided.

Example:

"2026-02-14T00:00:00Z"

​
workflow_id
string<uuid>

Filter runs by workflow ID

​
status
enum<string>

Filter runs by execution status

Available options:
execution.queued,
execution.start,
execution.failed,
execution.success,
execution.paused,
execution.stopped,
execution.requeued
​
credential_id
string

Filter runs by vault credential (permissioned_user_id)

​
limit
integer
default:1000

Maximum number of runs to retrieve

Required range: 1 <= x <= 10000

Response

Filtered runs successfully retrieved

​
session_id
string<uuid>
required

Unique identifier for the run session

Example:

"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

​
status
enum<string>
required

Current execution status of the run

Available options:
execution.queued,
execution.start,
execution.failed,
execution.success,
execution.paused,
execution.stopped,
execution.requeued
Example:

"execution.success"

​
created_at
string<date-time> | null

When the run was created

Example:

"2026-02-15T10:00:00Z"

​
workflow_id
string<uuid> | null

Identifier for the workflow that was executed

Example:

"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

​
workspace_id
string<uuid> | null

Identifier for the workspace the run belongs to

Example:

"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

​
execution_start
string<date-time> | null

When execution began

Example:

"2026-02-15T10:00:01Z"

​
execution_end
string<date-time> | null

When execution completed

Example:

"2026-02-15T10:00:30Z"

​
dry_run
boolean | null

Whether this was a dry run

Example:

false