# /webhook

Deactivates a webhook registration.
## Purpose
Sets active=false for the specified webhook. The configuration is preserved and can be re-activated via PUT /webhook.
## Authentication
Requires `x-client-id` and `x-secret-key` headers.
## Notes
- Requires webhook_id as query parameter
- Does NOT permanently delete — sets active=false
- Re-activate with PUT /webhook and {"webhook_id": "xxx", "active": true}

## Common errors
- `400` Missing webhook_id
- `401` Invalid credentials
- `404` Webhook not found
- `500` Internal error

Endpoint: DELETE /webhook
Version: 1.0.0

## Query parameters:

  - `webhook_id` (string, required)
    UUID v4 identifier of the webhook to deactivate.

Error codes: required=400001, type=400002

## Header parameters:

  - `x-client-id` (string, required)
    Unique identifier assigned to the integrating client.

Error codes: required=400001, type=400002, minLength=400003, maxLength=400004

  - `x-secret-key` (string, required)
    Secret authentication key associated with the client.

Error codes: required=400001, type=400002, minLength=400003, maxLength=400004

## Response 200 fields (application/json):

  - `status` (string)
    success

  - `data` (object)
    Deactivated webhook config

  - `data.webhook_id` (string)

  - `data.url` (string)

  - `data.events` (array)

  - `data.branches` (array)

  - `data.active` (boolean)
    Always false after DELETE

  - `data.created_at` (string)

  - `data.updated_at` (string)

## Response 400 fields (application/json):

  - `errors` (array)
    Error catalog for 400 (click to expand)CodeDescription400001webhook_id query parameter is required

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)

## Response 401 fields (application/json):

  - `errors` (array)
    Error catalog for 401 (click to expand)CodeDescription401000Invalid credentials

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)

## Response 404 fields (application/json):

  - `errors` (array)
    Error catalog for 404 (click to expand)CodeDescription404000Webhook not found

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)

## Response 500 fields (application/json):

  - `errors` (array)
    Error catalog for 500 (click to expand)CodeDescription500000Internal server error

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)