coss.comdocs

Recover failed deliveries

POST
/v1/webhook_endpoints/{id}/recover

Queues the endpoint's deliveries that failed since since for one more attempt each, oldest first, spread over the next minute, e.g. after fixing a receiver that was down. At most 1000 per call: while has_more is true, call again with the same since. The endpoint must be enabled.

Authorization

bearerAuth
headerAuthorizationBearer <token>

A secret API key from the dashboard: coss_live_… for production environments, coss_test_… for sandbox environments.

Path Parameters

id*string

The webhook endpoint's id.

Header Parameters

Coss-Version?"2026-10-10"

The API version (a date) to use for this request. Defaults to your organization's version, pinned to the latest one when it first used the API and upgraded from the dashboard. The SDK always sends the version it was built for.

Value in"2026-10-10"

Request Body

application/json
  1. body
since*string

Requeue the endpoint's deliveries that failed and were created at or after this time (ISO 8601). Deliveries are kept for 30 days.

Formatdate-time

Response Body

How many deliveries were queued.

application/json
  1. response
object*"webhook_endpoint_recovery"
Value in"webhook_endpoint_recovery"
endpoint_id*string
requeued*integer

How many failed deliveries were queued for one more attempt. Their attempts are spread over the next minute.

has_more*boolean

At most 1,000 are requeued per call; true means call again with the same since.

import { Coss } from "coss";const coss = new Coss({  apiKey: process.env.COSS_API_KEY,  baseUrl: "https://api.coss.com",});const { data, error } = await coss.webhookEndpoints.recover("whep_01k7c8m4q2f3e9v6t5r1n0p8yz", {  since: "2026-01-15T09:00:00.000Z",});
{  "object": "webhook_endpoint_recovery",  "endpoint_id": "whep_01k7c8m4q2f3e9v6t5r1n0p8yz",  "requeued": 12,  "has_more": false}