---
title: "Retry failed deliveries"
method: POST
path: "/api/v1/manage/forms/{form}/deliveries/retry"
tags: ["Deliveries"]
---

# Retry failed deliveries

`POST /api/v1/manage/forms/{form}/deliveries/retry`

## Request

- Base URL: `https://fillo.so`
- URL: `https://fillo.so/api/v1/manage/forms/{form}/deliveries/retry`
- Auth: HTTP bearer

Repair deliveries that failed or are overdue. Send exactly one target: `responseIds` (repair those responses' newest occurrence), `destinationKey` (one destination's backlog), `deliveryKind` + `deliveryId` (one row), or `all: true` (the form's whole failed backlog). A retry re-sends work that was already meant to go out, so it is routine (Tier A). Scope: responses:manage.

## Path parameters

- `form` string, required

## Request body

- object: Exactly one target. deliveryKind and deliveryId are required together.
  - `responseIds` string[]
  - `destinationKey` string: A `key` from the delivery-health destinations list.
  - `deliveryKind` 'webhook' | 'integration'
  - `deliveryId` string
  - `all` true

## Response `200`

How many deliveries were queued again.

- object
  - `retried` integer, required

## Other responses

- `400`: Invalid request (e.g. a body on a GET/DELETE, or a missing required query parameter).
- `401`: Missing, malformed, unknown, revoked, or expired key.
- `403`: The key is valid but lacks the required scope.
- `404`: No such resource in this project (returned instead of 403 for ids in other projects).
- `413`: The request body exceeded the 16 KiB management cap.
- `429`: Per-key (120/min), per-workspace (240/min), or per-IP (300/min) rate limit exceeded. Retry after the Retry-After header.

---

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