Functions

Create a durable function run

Create an idempotent delayed/reliable request for a deployed function. When due, the function receives X-Run402-Trigger: function_run and a typed JSON envelope. Temporary concurrency occupancy waits automatically without consuming execution attempts; lifecycle and exhausted-quota gates remain blocked.

post/functions/v1/{name}/runs

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/functions/v1/{name}/runs
  • Auth: HTTP bearer

Path parameters

namestring required

Headers

Idempotency-Keystring

Optional mirror of body.idempotency_key.

X-Run402-Parent-Run-Idstring
X-Run402-Parent-Attempt-Idstring

Request body

event_typestring required
payloadobject
idempotency_keystring

Stable idempotency key. May be mirrored by the Idempotency-Key header.

run_atstring date-time

Absolute execution time. Mutually exclusive with delay_seconds.

delay_secondsnumber

Relative execution delay in seconds. Mutually exclusive with run_at.

expires_atstring date-time

Optional deadline after which an unstarted run expires.

Example request

{
  "event_type": "reminder.send",
  "retry": {
    "preset": "standard"
  }
}

Response

Function run

run_idstring required
function_namestring required
event_typestring required
status'scheduled' | 'queued' | 'running' | 'retrying' | 'blocked' | 'succeeded' | 'failed' | 'cancelled' | 'expired' required
terminalboolean required
generationinteger required
run_atstring date-time required
expires_atstring date-time
sourceobject required
created_atstring date-time required
updated_atstring date-time required
completed_atstring date-time
deduplicatedboolean
next_actionsobject[] required

Changes

No recorded changes to this operation across all 1 revision of this API.