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

# Delete Webhook

> Permanently delete a webhook. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON request/response, full schema and code examples.

Permanently delete a webhook. All future event deliveries to this endpoint stop immediately.

## Authentication

```bash theme={null}
Authorization: Bearer tuco_sk_xxxxxxxxxxxxx
```

***

## Path parameters

<ParamField path="id" type="string" required>
  Webhook ID.
</ParamField>

***

## Example

```bash theme={null}
curl -X DELETE "https://app.tuco.ai/api/webhooks/680a1b2c3d4e5f6789012345" \
  -H "Authorization: Bearer tuco_sk_xxxxxxxxxxxxx"
```

```json 200 Response theme={null}
{ "success": true }
```

<Tip>
  If you just want to temporarily stop delivery, use [Update Webhook](/api-reference/endpoint/update-webhook) with `isActive: false` instead of deleting.
</Tip>

***

## Errors

| Status | When                                |
| ------ | ----------------------------------- |
| `401`  | Invalid or missing API key          |
| `402`  | Subscription past due               |
| `404`  | Webhook not found in your workspace |