COSS
Webhook endpoints

Delete a webhook endpoint

DELETE
/v1/webhook_endpoints/{id}

Removes the endpoint and its delivery log. Deliveries already queued for it are dropped. To stop deliveries temporarily, set enabled to false instead.

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"

Response Body

The endpoint was deleted.

application/json
  1. response
object*"webhook_endpoint"
Value in"webhook_endpoint"
id*string
deleted*true
Value intrue
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.delete("whep_01k7c8m4q2f3e9v6t5r1n0p8yz");
{  "object": "webhook_endpoint",  "id": "whep_01k7c8m4q2f3e9v6t5r1n0p8yz",  "deleted": true}

Create a webhook endpoint POST

Registers a URL that receives signed event notifications. Webhook endpoints belong to the API key's own environment: a `coss_test_…` key only ever sees sandbox endpoints, and a `coss_live_…` key only production ones. The response carries the signing secret, which is returned only here and when it is rolled: store it, and verify every delivery with it (`verifyWebhook` in the SDK).

Retrieve a delivery GET

One delivery of the endpoint, with every HTTP attempt and the payload as sent.