Skip to main content
PATCH
/
webhooks
/
endpoints
/
{endpoint_id}
Update webhook endpoint
curl --request PATCH \
  --url https://api.wacht.dev/webhooks/endpoints/{endpoint_id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "https://example.com/new-webhook",
  "description": "Updated description",
  "headers": {},
  "max_retries": 5,
  "timeout_seconds": 60,
  "is_active": true,
  "subscriptions": [
    {
      "event_name": "user.created",
      "filter_rules": {
        "user_tier": {
          "equals": "premium"
        }
      }
    }
  ]
}
'
{
  "id": "1234567890123456789",
  "deployment_id": "9876543210987654321",
  "app_name": "my-webhook-app",
  "url": "https://example.com/webhook",
  "description": "Production webhook endpoint",
  "headers": {
    "X-Custom-Header": "custom-value"
  },
  "is_active": true,
  "signing_secret": "<string>",
  "max_retries": 3,
  "timeout_seconds": 30,
  "failure_count": 0,
  "last_failure_at": "2023-11-07T05:31:56Z",
  "auto_disabled": false,
  "auto_disabled_at": "2023-11-07T05:31:56Z",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}

Authorizations

Authorization
string
header
required

API key authentication (format: Bearer {api_key})

Path Parameters

endpoint_id
string
required

Endpoint ID

Body

application/json
url
string<uri>

New endpoint URL

Example:

"https://example.com/new-webhook"

description
string

Endpoint description

Example:

"Updated description"

headers
object

Custom headers

max_retries
integer

Maximum retry attempts

Example:

5

timeout_seconds
integer

Request timeout

Example:

60

is_active
boolean

Whether the endpoint is active

Example:

true

subscriptions
object[]

Event subscriptions

Response

Webhook endpoint updated

id
string

Endpoint ID

Example:

"1234567890123456789"

deployment_id
string

Deployment ID

Example:

"9876543210987654321"

app_name
string

Webhook app name

Example:

"my-webhook-app"

url
string<uri>

Endpoint URL

Example:

"https://example.com/webhook"

description
string | null

Endpoint description

Example:

"Production webhook endpoint"

headers
object

Custom headers

Example:
{ "X-Custom-Header": "custom-value" }
is_active
boolean

Whether the endpoint is active

Example:

true

signing_secret
string | null

Signing secret (only shown on creation)

max_retries
integer

Maximum retry attempts

Example:

3

timeout_seconds
integer

Request timeout in seconds

Example:

30

failure_count
integer

Number of consecutive failures

Example:

0

last_failure_at
string<date-time> | null

Last failure timestamp

auto_disabled
boolean

Whether endpoint was auto-disabled

Example:

false

auto_disabled_at
string<date-time> | null

Auto-disable timestamp

created_at
string<date-time>
Example:

"2024-01-15T10:30:00Z"

updated_at
string<date-time>
Example:

"2024-01-15T10:30:00Z"