v1

latestOpenAPI 3.1.0Apache-2.02026-07-17144068.3 KB
sip

Updates SIP hooks.

Adds or replaces SIP hooks in the cache. Hooks with matching hosts (case-insensitive) will be replaced. Hosts defined in the application configuration cannot be modified. The changes take effect immediately and persist across server restarts.

Note: Secrets are NOT stored in the cache. Runtime-added hooks will use the global hook_secret from the server configuration.

Request Body

Array of hook entries with host and url fields.

Returns

  • 200 OK - Updated list of SIP hooks
  • 400 Bad Request - If validation fails (e.g., duplicate hosts)
  • 500 Internal Server Error - If writing the cache fails
post/sip/hooks

Request body

Example request

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

Response

Updated list of SIP hooks

Example response

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