API Endpoint

PATCH /management/webhooks/{id}

Update a webhook endpoint name, URL, events, and/or enabled flag.

PATCH /management/webhooks/{id}

Endpoint context

Use these endpoints from internal tooling or your frontend backend to manage slug policy templates, provisioning API keys, and webhook endpoint configuration. Management routes require the management bootstrap key configured via MANAGEMENT_API_KEYS or MANAGEMENT_API_KEY.

  • Requires management API key auth.
  • At least one field must be provided.
  • Events and URL validations match webhook create behavior.
license.generatedlicense.activatedlicense.deactivatedlicense.validatedlicense.validation_failedlicense.revoked
bash
curl -sS -X PATCH http://localhost:8080/management/webhooks/1 \
  -H "Authorization: Bearer management_key_dev_123456" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": false,
    "events": ["license.revoked"]
  }'

Request body

json
{
  "enabled": false,
  "events": ["license.revoked"]
}

Response body

json
{
  "id": 1,
  "name": "audit-sync",
  "url": "https://example.com/hooks/license",
  "events": ["license.revoked"],
  "enabled": false,
  "created_at": "2026-04-21T12:00:00Z",
  "updated_at": "2026-04-21T12:30:00Z"
}

Response field types

updated_at

string

RFC3339 update timestamp.

Error codes

400

Invalid id, invalid patch body, invalid URL, or unsupported event values.

401

Missing or invalid management API key.

404

Webhook endpoint not found.

500

Unexpected server or storage error.

Back to API overview