Skip to main content
POST
/
v1
/
runs
/
{run_id}
/
callback-redeliveries
Redeliver callback
curl --request POST \
  --url https://api.runflow.io/v1/runs/{run_id}/callback-redeliveries \
  --header 'Authorization: Bearer <token>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "callback_url": "<string>",
  "payload_bytes": "<string>",
  "payload": {
    "run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "output": {},
    "duration_ms": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "completed_at": "2023-11-07T05:31:56Z",
    "metadata": {}
  },
  "signing_secret_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "is_automatic": true,
  "failure_detail": "<string>",
  "attempt_count": 123,
  "max_attempts": 123,
  "next_attempt_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "attempts": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "delivery_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "attempt_number": 123,
      "status_code": 123,
      "response_body": "<string>",
      "response_time_ms": 123,
      "error_message": "<string>",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
X-Organization-Id
string | null

Path Parameters

​
run_id
string<uuid>
required

Response

Successful Response

Response shape.

​
id
string<uuid> | null
​
run_id
string<uuid> | null
​
callback_url
string | null
​
payload_bytes
string | null
​
payload
CallbackPayload · object

JSON payload delivered to a customer's callback_url when a run reaches a terminal state.

This is the contract between Runflow and the customer's webhook endpoint. It is frozen at delivery time and stored as payload_bytes on the delivery row.

Datetime fields are serialized using .isoformat() (emitting +00:00 for UTC) to preserve byte-equivalence with the pre-contract payload builder, which customers' HMAC signature verification may depend on.

​
signing_secret_id
string<uuid> | null
​
is_automatic
boolean | null
​
status_code
enum<string> | null
Available options:
pending,
queued,
processing,
succeeded,
failed,
failed_non_retryable
​
failure_reason_code
enum<string> | null
Available options:
dns_validation_failed,
max_attempts_exhausted,
client_rejected
​
failure_detail
string | null
​
attempt_count
integer | null
​
max_attempts
integer | null
​
next_attempt_at
string<date-time> | null
​
created_at
string<date-time> | null
​
updated_at
string<date-time> | null
​
completed_at
string<date-time> | null
​
attempts
FullValidator · object[] | null