---
title: "Queue a failed callback notification for another delivery cycle"
method: POST
path: "/v1/dashboard/callback-deliveries/{deliveryId}/retry"
---

# Queue a failed callback notification for another delivery cycle

`POST /v1/dashboard/callback-deliveries/{deliveryId}/retry`

## Request

- Base URL: `https://actiondock.app`
- URL: `https://actiondock.app/v1/dashboard/callback-deliveries/{deliveryId}/retry`
- Auth: API key in cookie `actiondock_dashboard`

Only the signed-in owner can retry a failed callback notification to the current configured receiver. An enabled callback is required. Retry queues a new bounded delivery cycle; it never reruns the job or changes execution_unknown. Event and delivery IDs stay stable; verify the signature and deduplicate X-ActionDock-Delivery. Delivery is at least once, and polling remains available. Agent API keys and MCP tools cannot retry notifications. Requires the owner session and same-origin Origin header. HTTP 202 confirms durable queueing, not receipt by the receiver. Automatic failure retries stop after eight attempts per cycle; startup recovery may repeat an interrupted attempt. attempts resets to zero while the previous HTTP/error result remains until the next result. The original envelope is sent using the current callback URL and secret. Settings changes do not cancel an already-sent notification.

## Path parameters

- `deliveryId` string, uuid, required

## Headers

- `Origin` string, required

## Response `202`

Notification durably queued; the business job is unchanged

- object
  - `retried` true, required

## Other responses

- `400`: Invalid delivery UUID.
- `401`: A signed-in owner session is required; API keys are not accepted.
- `403`: Missing or cross-origin Origin header.
- `404`: Callback delivery not found in this workspace.
- `409`: callback_retry_unavailable: delivery is not failed, or its callback is missing or disabled. Refresh before deciding whether to retry.

---

[API](https://skmtc.dev/actiondock/apis/actiondock-api.md) · [All operations](https://skmtc.dev/actiondock/apis/actiondock-api/llms.txt) · [OpenAPI document](https://skmtc.dev/actiondock/apis/actiondock-api/revisions/b8a60dcf4926?raw)