Skip to content
Safety RadarSafety RadarSafety Radar Docs

List workflow runs

GET
/workflows/{workflowId}/runs
curl --request GET \
  --url 'https://safe-api.safetyradar.com/v2/workflows/550e8400-e29b-41d4-a716-446655440001/runs?status=completed&page=1&limit=50' \
  --header 'Authorization: Bearer <token>' \
  --header 'x-team: my-team-slug'

List all runs for a specific workflow. Supports filtering by status.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
workflowId
required

Workflow ID (UUID)

string format: uuid
Example
550e8400-e29b-41d4-a716-446655440001

Workflow ID (UUID)

Query Parameters

Section titled “Query Parameters”
status

Filter by run status (pending, running, completed, failed)

string
Example
completed

Filter by run status (pending, running, completed, failed)

page

Page number (default: 1)

integer
default: 1
Example
1

Page number (default: 1)

limit

Results per page (default: 50, max: 1000)

integer
default: 50 <= 1000
Example
50

Results per page (default: 50, max: 1000)

Header Parameters

Section titled “Header Parameters”
x-team

Deprecated — accepted but ignored; the v2 API is org-scoped.

string
Example
my-team-slug

Deprecated — accepted but ignored; the v2 API is org-scoped.

Responses

Section titled “Responses”

200

Section titled “200”

List of workflow runs

Media typeapplication/json
object
data
required
Array<object>
object
id
required
string format: uuid
flowId
required
string format: uuid
flowVersion
required
integer
>= -2147483648 <= 2147483647
flowRunType
required
string
Allowed values: draft live
createdById
required
string format: uuid
nullable
status
required
string
Allowed values: pending running completed failed
context
required
Any of:
string
startedAt
required
string
nullable
completedAt
required
string
nullable
error
required
string
nullable
createdAt
required
string
updatedAt
required
string
createdBy
required
object
id
required
string format: uuid
fullName
required
string
nullable
email
required
string
flow
required
object
id
required
string format: uuid
name
required
string
version
required
number
flowType
required
string
deletedAt
required
string
nullable
meta
required
object
pagination
required
object
page
required
number
limit
required
number
total
required
number
totalPages
required
number
hasNext
required
boolean
hasPrev
required
boolean
Example
{
  "data": [
    {
      "flowRunType": "draft",
      "status": "pending"
    }
  ]
}

401

Section titled “401”

Unauthorized

Media typeapplication/json
object
code
required
string
message
required
string
details
object
key
additional properties
nullable
Examplegenerated
{
  "code": "example",
  "message": "example",
  "details": {
    "additionalProperty": "example"
  }
}

404

Section titled “404”

Workflow not found

Media typeapplication/json
object
code
required
string
message
required
string
details
object
key
additional properties
nullable
Examplegenerated
{
  "code": "example",
  "message": "example",
  "details": {
    "additionalProperty": "example"
  }
}