---
title: "Deletes SIP hooks by host name."
method: DELETE
path: "/sip/hooks"
tags: ["sip"]
---

# Deletes SIP hooks by host name.

`DELETE /sip/hooks`

Removes the specified hosts from the cache. Hosts defined in the application
configuration cannot be removed. If a host exists in the original server
configuration, it will revert to its config value after deletion of a
cached override. Hosts that only exist in cache will be completely removed.

The changes take effect immediately and persist across server restarts.

# Request Body
Array of host names to remove (case-insensitive).

# Returns
* `200 OK` - Updated list of SIP hooks after deletion
* `400 Bad Request` - If the hosts array is empty
* `500 Internal Server Error` - If writing the cache fails

## Request body

- DeleteSipHooksRequest — Request body for deleting SIP hooks. Contains a list of host names to remove from the SIP hooks cache.
  - `hosts` string[] — List of host names to remove (case-insensitive). Hosts that exist in the original config will revert to their config values.

## Response `200`

Updated list of SIP hooks after deletion

- SipHooksResponse — Response body for SIP hooks operations.
  - `hooks` SipHookEntry[], required — List of all configured SIP hooks
    - `auth_id` string, required — Tenant identifier for this hook (written to LiveKit room metadata). Required when AUTH_REQUIRED=true; may be empty when AUTH_REQUIRED=false. When empty, room metadata updates are skipped.
    - `host` string, required — Host pattern for matching SIP domains (case-insensitive)
    - `url` string, required — HTTPS URL to forward webhook events to

## Other responses

- `400` — Validation error
- `405` — Host defined in application config cannot be modified
- `500` — Failed to write hooks cache

## Changes

- **2026-02-08** `0df166d28191` — 1 info
  - the endpoint scheme security `auth` was added to the API
- **2026-01-07** `3a996c4eb1fc` — 1 info
  - added the required property `hooks/items/auth_id` to the response with the `200` status
- **2025-12-01** `c88500f43862` — 1 info
  - added the non-success response with the status `405`
- **2025-11-27** `3eb53903c710` — 1 info
  - endpoint added
- **2025-11-12** `d85b83f25aea` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/saynaai/apis/sayna-api/changes/sip/hooks/delete.md)

---

[API](https://skmtc.dev/saynaai/apis/sayna-api.md) · [All operations](https://skmtc.dev/saynaai/apis/sayna-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/saynaai/sayna-api/revisions/395ce7e35139/schema)