---
title: "Retry a webhook delivery"
method: POST
path: "/webhooks/deliveries/{delivery_id}/retry"
tags: ["Webhooks"]
---

# Retry a webhook delivery

`POST /webhooks/deliveries/{delivery_id}/retry`

## Request

- Base URL: `https://api.context.dev/v1`
- URL: `https://api.context.dev/v1/webhooks/deliveries/{delivery_id}/retry`
- Auth: HTTP bearer

Resend the original payload using the source’s current URL and secret. Available for 7 days after the event.

## Path parameters

- `delivery_id` string, required: Delivery ID.

## Headers

- `Idempotency-Key` string: Unique key to prevent duplicate retry requests.

## Request body

- object
  - `force` boolean: Resend even if the delivery already succeeded. Defaults to false.
  - `tags` string[]: Labels for filtering usage in the dashboard.

## Response `202`

Retry accepted.

- RetryWebhookDeliveryResponse
  - `id` string, required: Delivery ID.
  - `key_metadata` KeyMetadata: Credits this request used and your remaining balance.
    - `credits_consumed` integer, required: Credits charged for this request.
    - `credits_remaining` integer, required: Credits remaining for your organization.
  - `request_id` string, uuid, required: Unique ID of this request, also in `X-Request-Id`. Include it when contacting support.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `404`: Not found
- `409`: Delivery cannot be retried or the idempotency key conflicts.
- `410`: The seven-day retry window has expired.
- `429`: Rate limit exceeded (600 requests per minute per organization).
- `500`: Webhook service is temporarily unavailable.

## Changes

- **2026-10-21** `61627728926b`: 7 warning
  - added the new `NO_PUBLISHED_MARKDOWN` enum value to the `error_code` response property for the response status `400`
  - added the new `NO_PUBLISHED_MARKDOWN` enum value to the `error_code` response property for the response status `401`
  - added the new `NO_PUBLISHED_MARKDOWN` enum value to the `error_code` response property for the response status `404`
  - added the new `NO_PUBLISHED_MARKDOWN` enum value to the `error_code` response property for the response status `409`
  - …3 more
- **2026-10-19** `4ddcf49b9fe5`: 7 info
  - added the optional property `error_data` to the response with the `400` status
  - added the optional property `error_data` to the response with the `401` status
  - added the optional property `error_data` to the response with the `404` status
  - added the optional property `error_data` to the response with the `409` status
  - …3 more
- **2026-10-16** `2125f3e94e52`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/context/apis/brand-api/changes/webhooks/deliveries/:delivery_id/retry/post.md)

---

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