/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog
API Reference Replay Webhook Delivery

Replay Webhook Delivery

Send a past outbound webhook delivery again, as a new delivery.

POST/v1/projects/{projectId}/webhook-deliveries/{deliveryId}/replayTry it
Session token

Sends a past delivery's event again — for example once you have fixed the endpoint that rejected it. The replay is a new delivery, linked to the original by replayOf; the original is left as it was.

Note

Requires the admin or owner role, the same as test-firing an endpoint. A member gets 403 forbidden ("Only workspace admins can manage webhook endpoints.") with details.requiredRole: "admin". Needs a session JWT — an API key gets 401.

Any plan. Needs the Webhooks add-on enabled; otherwise 403 addon_disabled.

Path Parameters

NameDescription
projectId:stringpathRequired
The project ID.
deliveryId:stringpathRequired
The delivery to replay, from GET /webhook-deliveries. It can itself be a replay.

No request body.

What is sent

•
The stored payload as the same event, in a fresh envelope with the current timestamp.
•
To the endpoint's current URL, signed with its current secret — after a secret rotation, verify with the new one.
•
With the usual URL checks and retries. The request waits for the outcome, so with retries it can take up to about 18 seconds.
Warning

The stored payload is the redacted one. Any field whose name looks like a secret (token, password, api_key, …) arrives as "[redacted]" in a replay, not with its original value — see What a delivery stores.

Response — 200 OK

The new delivery, as delivery (not wrapped in data):

200 means the replay was attempted, not that it succeeded: check success, statusCode and error. A replay that fails again is recorded like any other failed delivery, and you can replay it in turn.

Error Responses

401 Unauthorized

Missing, invalid or expired session JWT, or an API key.

403 Forbidden

•
forbidden — you are a member, not an admin or owner (details.requiredRole: "admin"), or not a member of the organization at all.
•
addon_disabled — the Webhooks add-on is not enabled for this project.

404 Not Found

not_found — the project does not exist, there is no such delivery in this project (including an ID that is not a UUID), or its endpoint has since been deleted.

409 Conflict

The delivery cannot be replayed as things stand:

error.codeMeaningWhat to do
payload_unavailableNo payload was stored — the delivery predates stored payloads, or its payload was over 64 KiBNothing to replay; trigger the event again instead
endpoint_inactiveThe endpoint is paused (active: false)Turn it back on with PATCH /webhook-endpoints/{endpointId} and { "active": true }, then replay
json
{
"error": {
"code": "endpoint_inactive",
"message": "The endpoint is paused; turn it on to replay deliveries",
"details": { "traceId": "6f1c2a9e-3b7d-4c11-9a0e-2d5f8b4c7e10" }
}
}
Was this page helpful? Yes No
Request
cURLJavaScriptPythonGoRubyPHPJavaC#cURL
curl -X POST https://api.syntext.dev/v1/projects/3f2a9c1e-8b4d-4e7a-9c21-5d6e7f8a9b0c/webhook-deliveries/9d4e2b7a-6c1f-4a3e-8b5d-0f2a7c9e1b34/replay \
-H "Authorization: Bearer $SYNTEXT_JWT"
Responseapplication/json
200OK
{
"delivery": {
"id": "e3b9a1c7-2d4f-4a6e-9c8b-7f0d1a2e3b45",
"endpointId": "2c7f1e9a-4b3d-4e8f-9a6c-1d0e5b7a3f28",
"event": "build.failed",
"statusCode": 200,
"success": true,
"durationMs": 211,
"error": null,
"replayOf": "9d4e2b7a-6c1f-4a3e-8b5d-0f2a7c9e1b34",
"createdAt": "2026-11-08T11:02:40.000Z"
}
}
Product
Resources
Company
© 2026 SyntextBuilt with Syntext