v2
List executions
GET
/
executions
Authorization
string
*
Bearer
Authorization
Required
string
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
object
page
object
page
object
first
integer
first
integer
after
string
after
string
last
integer
last
integer
before
string
before
string
filters
object
filters
object
states
array
states
array
function_ids
array
function_ids
array
error_codes
array
error_codes
array
scheduled_at
object
scheduled_at
object
from
string
from
string
to
string
to
string
started_at
object
started_at
object
from
string
from
string
to
string
to
string
executed_by
string
executed_by
string
metadata
array
metadata
array
curl --request GET \
--url https://api.defer.run/public/v2/executions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"page": {
"first": 3
},
"filters": {
"states": [
"started",
"succeed",
"failed"
],
"metadata": [
{
"key": "user-id",
"values": [
"89a7c4d0-edf1-418b-a7d2-aa54d3832cc0",
"dc01b186-dd81-4f52-9795-c7281f9637a4"
]
}
]
}
}'
{
"data": [
{
"id": "AAYR4UFjxiD4cbHIJXSRZbzPVKtxTA",
"state": "started",
"scheduled_at": "2023-11-14T16:16:51.98835+01:00",
"created_at": "2023-11-14T16:16:51.98835+01:00",
"updated_at": "2023-11-14T16:16:55.612705+01:00"
},
{
"id": "AAYR4UFjK-qtSamewR2TMUyhQ1a_oQ",
"state": "succeed",
"scheduled_at": "2023-11-14T16:16:51.98835+01:00",
"created_at": "2023-11-14T16:16:51.987716+01:00",
"updated_at": "2023-11-14T16:16:58.669179+01:00"
},
{
"id": "AAYR4UFhv3cBjWlkZQlIwSlggOhjVQ",
"state": "failed",
"scheduled_at": "2023-11-14T16:16:51.98835+01:00",
"created_at": "2023-11-14T16:16:49.334976+01:00",
"updated_at": "2023-11-14T16:16:49.510079+01:00"
}
],
"page_info": {
"has_next_page": false,
"has_prev_page": true,
"start_cursor": "EeFBY8Yg-HGxyCV0kWW8z1SrcUz8zbvryIeFBg",
"end_cursor": "EeFBYb93AY1pZGUJSMEpYIDoY1WA2_foyIeFBg"
}
}
Authorizations
Authorization
string
headerrequiredBearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/json
page
object
page.first
integer
page.after
string
page.last
integer
page.before
string
filters
object
filters.states
enum<string>[]
Available options:
created
, started
, succeed
, failed
, cancelled
, aborting
, aborted
, discarded
filters.function_ids
string[]
filters.error_codes
string[]
filters.scheduled_at
object
filters.scheduled_at.from
string
filters.scheduled_at.to
string
filters.started_at
object
filters.started_at.from
string
filters.started_at.to
string
filters.executed_by
string
filters.metadata
object[]
filters.metadata.key
string
filters.metadata.values
string[]
Response
200 - application/json
data
object[]
data.id
string
data.state
enum<string>
Available options:
created
, started
, succeed
, failed
, cancelled
, aborting
, aborted
, discarded
data.function_name
string
data.function_id
string
data.scheduled_at
string
data.created_at
string
data.updated_at
string
page_info
object
page_info.has_next_page
boolean
page_info.has_prev_page
boolean
page_info.start_cursor
string
page_info.end_cursor
string
Was this page helpful?
curl --request GET \
--url https://api.defer.run/public/v2/executions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"page": {
"first": 3
},
"filters": {
"states": [
"started",
"succeed",
"failed"
],
"metadata": [
{
"key": "user-id",
"values": [
"89a7c4d0-edf1-418b-a7d2-aa54d3832cc0",
"dc01b186-dd81-4f52-9795-c7281f9637a4"
]
}
]
}
}'
{
"data": [
{
"id": "AAYR4UFjxiD4cbHIJXSRZbzPVKtxTA",
"state": "started",
"scheduled_at": "2023-11-14T16:16:51.98835+01:00",
"created_at": "2023-11-14T16:16:51.98835+01:00",
"updated_at": "2023-11-14T16:16:55.612705+01:00"
},
{
"id": "AAYR4UFjK-qtSamewR2TMUyhQ1a_oQ",
"state": "succeed",
"scheduled_at": "2023-11-14T16:16:51.98835+01:00",
"created_at": "2023-11-14T16:16:51.987716+01:00",
"updated_at": "2023-11-14T16:16:58.669179+01:00"
},
{
"id": "AAYR4UFhv3cBjWlkZQlIwSlggOhjVQ",
"state": "failed",
"scheduled_at": "2023-11-14T16:16:51.98835+01:00",
"created_at": "2023-11-14T16:16:49.334976+01:00",
"updated_at": "2023-11-14T16:16:49.510079+01:00"
}
],
"page_info": {
"has_next_page": false,
"has_prev_page": true,
"start_cursor": "EeFBY8Yg-HGxyCV0kWW8z1SrcUz8zbvryIeFBg",
"end_cursor": "EeFBYb93AY1pZGUJSMEpYIDoY1WA2_foyIeFBg"
}
}