FurniOpsDocs
API referenceWebhooks

Send failed deliveries again

Queues every failed delivery created in the range to be sent again, oldest first, each with a fresh schedule; order per subject is kept. Use it once a receiver is fixed. Events never stored for the endpoint (it was disabled) are not sent: read them from the change feed.

POST/v1/webhook-endpoints/{id}/recover

Queues every failed delivery created in the range to be sent again, oldest first, each with a fresh schedule; order per subject is kept. Use it once a receiver is fixed. Events never stored for the endpoint (it was disabled) are not sent: read them from the change feed.

Authorization

apiKey
AuthorizationBearer <token>

An API key (fo_live_… / fo_test_…) as a bearer token

In: header

Path Parameters

id*string

Webhook endpoint ID

Match^whe_[0-9A-Za-z]{22}$

Header Parameters

FurniOps-Version?string

Dated API version; pinned per organisation on first use and overridable per request

Value in

  • "2026-10-01"
  • "2026-10-04"
FurniOps-Mode?string

The data the request acts on: test is the organisation's sandbox. An OAuth token picks it (live by default); an API key's mode is fixed, and naming the other one is refused

Value in

  • "live"
  • "test"
Idempotency-Key*string

Unique key for this operation, reused on retries (24 h)

Length1 <= length <= 257
FurniOps-Dry-Run?string

Preview the write and change nothing: true answers the would-be response, explain a Preview (application/vnd.furniops.preview+json)

Value in

  • "true"
  • "explain"

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

A time range of failed deliveries to send again

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/v1/webhook-endpoints/string/recover" \  -H "Idempotency-Key: string" \  -H "Content-Type: application/json" \  -d '{    "since": "2019-08-24T14:15:22Z"  }'
{  "object": "webhook_recovery",  "requeued": 0}