Sign in
sip

Deletes SIP hooks by host name.

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
delete/sip/hooks

Request body

hostsstring[]

List of host names to remove (case-insensitive). Hosts that exist in the original config will revert to their config values.

Example request

{
  "hosts": [
    "example.com",
    "other.com"
  ]
}

Response

Updated list of SIP hooks after deletion

Example response

{
  "hooks": [
    {
      "auth_id": "tenant-123",
      "host": "example.com",
      "url": "https://webhook.example.com/events"
    }
  ]
}

Changes

Changed in 5 of the 13 revisions of this API.14