AI agents: install the Runflow skill before integrating, or jump to For agents.
curl --request POST \
--url https://api.runflow.io/v1/batches/{batch_id}/callback-redeliveries \
--header 'Authorization: Bearer <token>'{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"batch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"callback_url": "<string>",
"payload_bytes": "<string>",
"payload": {
"event": "batch.succeeded",
"batch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "succeeded",
"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,
"status_code": "<string>",
"failure_reason_code": "<string>",
"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"
}
]
}Create a manual callback redelivery for a batch.
Guards: batch is in a terminal state; batch has a callback_url.
The uq_batch_callback_deliveries_batch_inflight partial unique
index is the source of truth on concurrent-redelivery prevention —
the IntegrityError on flush is turned into a
422 validation_error with error_type="conflict".
curl --request POST \
--url https://api.runflow.io/v1/batches/{batch_id}/callback-redeliveries \
--header 'Authorization: Bearer <token>'{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"batch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"callback_url": "<string>",
"payload_bytes": "<string>",
"payload": {
"event": "batch.succeeded",
"batch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "succeeded",
"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,
"status_code": "<string>",
"failure_reason_code": "<string>",
"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"
}
]
}Documentation Index
Fetch the complete documentation index at: https://docs.runflow.io/llms.txt
Use this file to discover all available pages before exploring further.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Successful Response
Response shape.
JSON payload delivered to a customer's callback_url when a batch reaches a terminal state.
Frozen at delivery time and stored as payload_bytes on the delivery row.
Datetimes serialize via .isoformat() (+00:00 not Z) to preserve
byte-equivalence for HMAC verification on the customer side.
Show child attributes
Show child attributes