Delete a webhook subscription
Deletes one of your subscriptions and stops its deliveries. An id that is not yours is a **404**, not a 403: a 403 would confirm that it exists.
DELETE /webhooks/{id} is not available from a browser. Call it from your server.
Deletes one of your subscriptions and stops its deliveries. An id that is not yours is a 404, not a 403: a 403 would confirm that it exists.
ApiKeyAuthorizationBearer <rar_live_*>Send Authorization: Bearer rar_live_..., or use rar_test_... for a test key. Both lanes currently read the same catalogue. Without a key you stay in the anonymous lane: 30 requests/minute and 1,000/day, against 60/minute per key and 2,000/day per organization with one on the Free plan. Sending a key that is malformed, revoked or unknown is a 401; sending none is not.
id*stringOpaque id of a subscription, as returned by POST /v1/webhooks.
length <= 255Deleted. No body.
curl -X DELETE 'https://api.rarity.dev/v1/webhooks/whe_9tGqZ1rXbY2mKp0V' \ -A 'my-app/1.0 (you@example.com)'Register a webhook subscription POST
Registers an endpoint and returns its signing secret, **once**. Store the secret from this response. No endpoint returns it again. The URL must be an absolute `https` URL on a public host. Registration rejects private, loopback and link-local addresses with `invalid_webhook_url`. The webhook backend separately checks the resolved address at delivery time. Registration performs its own check so an invalid endpoint returns a readable 400 instead of silently receiving no deliveries.
List your webhook subscriptions GET
Returns the key's account subscriptions from oldest to newest. Subscriptions belong to the account rather than an individual key, so the list remains unchanged during the seven-day rotation period when two keys are live.