curl --request POST \
--url https://api.citadel.example/api/v1/webhook_deliveries/{id}/retry \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.citadel.example/api/v1/webhook_deliveries/{id}/retry', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.citadel.example/api/v1/webhook_deliveries/{id}/retry"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.citadel.example/api/v1/webhook_deliveries/{id}/retry"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "0199a3c5-0000-7000-8000-000000000001",
"type": "operation.confirmed",
"resource": {
"type": "operation",
"id": "0199a3c4-8a00-7c22-8d3e-4f5a6b7c8d9e"
},
"data": {
"operation_id": "0199a3c4-8a00-7c22-8d3e-4f5a6b7c8d9e",
"kind": "transfer",
"status": "confirmed",
"chain_ref": "9f1c2e…"
},
"endpoint": {
"id": "0199a2f0-1b00-7a11-8c22-3d4e5f6a7b8c",
"url": "https://merchant.example/hooks/citadel"
},
"status": "pending",
"attempts": 0,
"next_attempt_at": "2026-10-09T08:00:00Z",
"delivered_at": null,
"last_response_code": null,
"last_error": null,
"created_at": "2026-10-08T12:30:00Z"
}Retry a failed delivery
Sends one failed delivery again. It goes back in line with the whole retry schedule ahead
of it, first attempt now, and the answer is the delivery as it now stands: pending, no
attempts yet. Same id, same payload: your endpoint deduplicates it like any retry.
Only a failed delivery: a pending one is already on its way, a delivered one arrived —
both answer 409 delivery_not_failed. A delivery whose endpoint is paused or disabled
answers 409 endpoint_disabled: resume the endpoint first (PATCH /webhook_endpoints/{id}
with state: active).
Needs the webhooks.write scope. A key limited to vaults is refused with
403 vault_limited.
curl --request POST \
--url https://api.citadel.example/api/v1/webhook_deliveries/{id}/retry \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.citadel.example/api/v1/webhook_deliveries/{id}/retry', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.citadel.example/api/v1/webhook_deliveries/{id}/retry"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.citadel.example/api/v1/webhook_deliveries/{id}/retry"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "0199a3c5-0000-7000-8000-000000000001",
"type": "operation.confirmed",
"resource": {
"type": "operation",
"id": "0199a3c4-8a00-7c22-8d3e-4f5a6b7c8d9e"
},
"data": {
"operation_id": "0199a3c4-8a00-7c22-8d3e-4f5a6b7c8d9e",
"kind": "transfer",
"status": "confirmed",
"chain_ref": "9f1c2e…"
},
"endpoint": {
"id": "0199a2f0-1b00-7a11-8c22-3d4e5f6a7b8c",
"url": "https://merchant.example/hooks/citadel"
},
"status": "pending",
"attempts": 0,
"next_attempt_at": "2026-10-09T08:00:00Z",
"delivered_at": null,
"last_response_code": null,
"last_error": null,
"created_at": "2026-10-08T12:30:00Z"
}Authorizations
An API key minted in the console (ctd_…). Authenticates; never authorizes funds. A key
carries scopes (read, wallets.write, transactions.write, events.write,
webhooks.write, policy.write) and may be limited to vaults, to IP addresses, and in
lifetime — see Authentication.
Path Parameters
The delivery id — id in the webhook body and in X-Citadel-Delivery.
Response
Back in line; the first attempt is queued.
The delivery id — id in the webhook body and X-Citadel-Delivery. Stable across retries.
The event type.
What the event is about, as in the webhook body.
Show child attributes
Show child attributes
The event's data, as the endpoint receives it.
Show child attributes
Show child attributes
pending while attempts remain; delivered once the endpoint answered 2xx; failed
when every attempt failed, or the endpoint was disabled with the delivery in flight.
pending, delivered, failed Attempts made since the delivery was recorded, or since its last retry.
When the next attempt goes out; null unless pending.
The endpoint's HTTP status on the last attempt; null when it did not answer or nothing was tried yet.
Why the last attempt failed. Human-readable; not stable.
When Citadel recorded the event for this endpoint. from and to filter on it.