Skip to main content
POST
/
webhooks
/
{webhook_id}
/
disable
Disable webhook
curl --request POST \
  --url https://api.dnsradar.dev/webhooks/{webhook_id}/disable \
  --header 'X-Api-Key: <api-key>'
{
  "id": "whk_abc123...",
  "created": "2023-11-07T05:31:56Z",
  "url": "https://api.server.com/webhook/dnsradar",
  "method": "POST",
  "headers": {
    "Authorization": "Bearer abc123token",
    "X-Custom-Header": "value"
  },
  "secret": "Ultra Secure P@ssw0rd!",
  "is_active": true,
  "last_error": "Timeout connecting to endpoint",
  "last_executed": "2023-11-07T05:31:56Z",
  "groups": [
    "grp_abc123...",
    "grp_def456..."
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developers.dnsradar.dev/llms.txt

Use this file to discover all available pages before exploring further.

Disabling a webhook will stop all notifications from being sent to the specified URL until it is re-enabled.
Can be useful if the endpoint is temporarily unavailable or if you want to pause notifications for any reason.

Authorizations

​
X-Api-Key
string
header
required

API key used to authenticate yourself on DNSRadar. Obtain your API key from your DNSRadar dashboard.

Path Parameters

​
webhook_id
string
required

Response

Webhook disabled

Webhook configuration for event notifications

​
id
string

Webhook identifier with 'whk_' prefix

Example:

"whk_abc123..."

​
created
string<date-time>

Webhook creation datetime in ISO 8601 format

​
url
string<uri>

Webhook endpoint URL

Example:

"https://api.server.com/webhook/dnsradar"

​
method
enum<string>
default:POST

HTTP method to use for the webhook

Available options:
POST,
PUT,
DELETE,
PATCH
​
headers
object

Custom HTTP headers as key-value pairs

Example:
{
  "Authorization": "Bearer abc123token",
  "X-Custom-Header": "value"
}
​
secret
string | null

Secret key used for HMAC-SHA256 signing of webhook requests. The signature is sent in the X-Webhook-Signature header.

Example:

"Ultra Secure P@ssw0rd!"

​
is_active
boolean

Whether webhook is active

​
last_error
string | null

Last error message if any

Example:

"Timeout connecting to endpoint"

​
last_executed
string<date-time> | null

Datetime of last execution in ISO 8601 format

​
groups
string[]

List of group UUIDs associated with this webhook

Group UUID with 'grp_' prefix

Example:
["grp_abc123...", "grp_def456..."]