v2
Enqueue an execution
v2
Enqueue an execution
PUT
/
executions
Authorization
string
*
Bearer
Authorization
Required
string
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
object
*
function_name
string
*
function_name
Required
string
function_arguments
array
function_arguments
array
schedule_for
string
schedule_for
string
discard_after
string
discard_after
string
metadata
object
metadata
object
curl --request PUT \
--url https://api.defer.run/public/v2/executions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"function_name": "createUser",
"function_arguments": [
{
"name": "John Doe",
"company": "ACME"
},
false
],
"metadata": [
{
"user-id": "ab4d517f-64cb-48b2-aaaa-3ba3bec2e437"
}
]
}'
{
"data": {
"id": "AAYR1m5T-trJR95j1BaiC_36IdTTLw",
"state": "created",
"function_name": "helloWorld",
"function_id": "AAcRmz6-ICPpFZv5oK7_9vkIfDPssA",
"scheduled_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
}
Authorizations
Authorization
string
headerrequiredBearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/json
function_name
string
requiredfunction_arguments
string[]
schedule_for
string
discard_after
string
metadata
object
Response
201 - 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
Was this page helpful?
curl --request PUT \
--url https://api.defer.run/public/v2/executions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"function_name": "createUser",
"function_arguments": [
{
"name": "John Doe",
"company": "ACME"
},
false
],
"metadata": [
{
"user-id": "ab4d517f-64cb-48b2-aaaa-3ba3bec2e437"
}
]
}'
{
"data": {
"id": "AAYR1m5T-trJR95j1BaiC_36IdTTLw",
"state": "created",
"function_name": "helloWorld",
"function_id": "AAcRmz6-ICPpFZv5oK7_9vkIfDPssA",
"scheduled_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
}