v1
latestOpenAPI 3.1.0Apache-2.02026-07-17144068.3 KBsip
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"
}
]
}