Skip to main content
DELETE
cURL
Use this when you are finished with an endpoint. To stop deliveries for a while and keep the endpoint, send enabled: false to Update a webhook instead.

Parameters

What deletion changes

Example

Retry with the same key

Send the request again with the same Idempotency-Key and you get the first response back, rather than a 404 from the second delete.

What it does not do

  • Bring the endpoint back. A replacement is a new endpoint, with a new id, a new signing_secret, and its own verification.
  • Keep the delivery log reachable. The rows are retained, but Webhook deliveries answers 404 for a deleted id, so read the log before you delete.
  • Answer 200 twice. Without an Idempotency-Key, a second DELETE on the same id answers 404.

Authorizations

Authorization
string
header
required

Legacy default or named integration API key, or OAuth 2.1 access token, in the Authorization header as Bearer oxi_sk_live_... or Bearer oxi_at_.... Default keys retain full access; integration keys are limited to their approved read, webhooks, export and usage scopes and expire within 90 days. All credentials share the owner's account limits. Data calls require an active Pro subscription and return live data. A 401 carries WWW-Authenticate: Bearer resource_metadata="https://api.0xinsider.com/.well-known/oauth-protected-resource" (RFC 6750 section 3, RFC 9728).

Headers

X-Query-Validation
enum<string>

Opt into strict query-name validation. The default is compatible: unknown names are ignored and reported in X-Query-Ignored. With strict, an unknown name returns 400 bad_request with error.reason unknown_query_parameter before the handler runs, including when its percent escape is incomplete.

Available options:
strict
Idempotency-Key
string

Optional safe-retry key. Reuse the same value only when retrying the exact same mutation request body; a different body returns 422 and an in-flight matching request returns 409.

Required string length: 1 - 255

Path Parameters

id
integer<int64>
required

Webhook endpoint id owned by the authenticated API key user.

Response

Webhook destination

object
string
required
Allowed value: "webhook"
data
object
required
meta
object
required