Skip to main content
GET
/
runs
Get runs
curl --request GET \
  --url https://api.edges.run/v1/runs \
  --header 'X-API-Key: <api-key>'
[
  {
    "id": 123,
    "uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "action_id": 123,
    "action_name": "<string>",
    "retry_count": 0,
    "user_uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "workspace_uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "execution_mode": "LIVE",
    "last_error": {
      "label": "<string>",
      "message": "<string>",
      "params": {}
    },
    "parameters": {},
    "callback": {
      "url": "<string>"
    },
    "status": "CREATED",
    "postponed_until": "2023-11-07T05:31:56Z",
    "started_at": "<string>",
    "finished_at": "<string>",
    "synced_at": "<string>",
    "created_at": "<string>",
    "updated_at": "<string>"
  }
]
uid is used for all the endpoints and Run manipulation.The id is an internal identifier returned to smooth and improve speed and accuracy if you have questions about your runs you will want to submit to the team.

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
status
enum<string>[] | null
Minimum length: 1
​
action_name
string[] | null
Minimum length: 1
​
execution_mode
enum<string>[] | null
Minimum length: 1
​
uid
string<uuid>[] | null
Minimum length: 1
​
user_uid
string<uuid>[] | null
Minimum length: 1
​
workspace_uid
string<uuid>[] | null
deprecated

This filter is ignored

Minimum length: 1
​
limit
integer
default:10
Required range: 1 <= x <= 100
​
offset
integer
default:0
Required range: x >= 0
​
sort
string[]

Sort by fields. Prefix with - for descending order. Default is ascending order.

Maximum length: 10

Response

Returns the runs

​
id
integer

Run ID

​
uid
string<uuid>

Run UUID

​
action_id
integer

Action ID

​
action_name
string

Action name

​
retry_count
integer
default:0

Retry count

​
user_uid
string<uuid>

Member/User UUID

​
workspace_uid
string<uuid>

Workspace UUID

​
execution_mode
enum<string> | null

Execution mode

Available options:
LIVE,
ASYNC
​
last_error
object | null

Last error message

​
parameters
object
​
callback
object | null

Callback (only for async runs)

​
status
enum<string> | null

Run status

Available options:
CREATED,
INVALID,
QUEUED,
SCHEDULED,
BLOCKED,
STOPPED,
RUNNING,
FAILED,
PARTIAL_SUCCEEDED,
SUCCEEDED
​
postponed_until
string<date-time> | null

If the run is postponed, this field indicates when it will be retried.

​
started_at
string | null

Started at

​
finished_at
string | null

Finished at

​
synced_at
string | null

Synced at

​
created_at
string

Created at

​
updated_at
string | null

Updated at

⌘I