> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getkato.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete a webhook endpoint

> Remove a webhook subscription from the workspace.

Remove a webhook subscription from the workspace.

Use a developer access key. See [authentication, errors, and rate limits](/api-reference/authentication).

Required scopes: `webhooks:write`.

Returns `404` if the endpoint does not exist in this workspace, including after it has already been deleted. This route deletes the subscription, unlike record and task archive operations.

## Parameters

<ParamField path="endpointId" type="string" required>
  ID returned by webhook creation or listing.
</ParamField>

## Response

**200** — Returns the resource under `data`. Example IDs and values are illustrative.

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": {
      "id": "endpoint_example",
      "deleted": true
    }
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash Request theme={null}
  curl --fail-with-body --silent --show-error \
    -X DELETE \
    "https://api.getkato.io/v1/webhooks/$KATO_ENDPOINT_ID" \
    -H "Authorization: Bearer $KATO_API_KEY"
  ```
</RequestExample>

Set path-ID environment variables to values returned by your workspace before running the request.

This request changes workspace data. A timeout does not prove that the write failed; inspect the result before retrying.


## Related topics

- [All endpoints](/api-reference/endpoints.md)
- [List webhook endpoints](/api-reference/webhooks/list.md)
- [Create a webhook endpoint](/api-reference/webhooks/create.md)
- [Set up webhooks](/api-reference/webhooks/setup.md)
- [Authentication and API conventions](/api-reference/authentication.md)