Agents
Enable/Disable SIP Registration
Toggle an agent’s SIP registration on or off without resending the full configuration
PATCH
Enable or disable an agent’s existing SIP registration by flipping a single
flag. Unlike Set SIP Registration,
this endpoint does not require you to resend
sipDomain, username,
password, or any other field — all stored settings are preserved. Use it to
register or deregister an agent while keeping its SIP credentials on file.
This endpoint moves the registration flag only — the agent’s
status field is
left as it is, so an agent deregistered this way still reads as active. To move
both together, use Update Agent Status.The agent must already have a SIP registration configured. If none exists, this
endpoint returns
404. Use Set SIP Registration
to create the configuration first, or Delete SIP Registration
to remove it entirely.Path Parameters
string
required
The unique identifier of the agent (UUID format)
Request Body
boolean
required
Set to
true to enable (register) the agent, or false to disable it.This is the only accepted field — any additional properties are rejected with
a 400 error. All other SIP settings are left untouched.How It Works
- API validates that
registrationEnabledis a boolean - Loads the existing
sip_registration_datafor the agent (returns404if none is configured) - Updates only the
registrationEnabledflag, preserving every other stored field - Sync service picks up the change via Supabase realtime and registers or deregisters with OpenSIPS accordingly
Disabling a registration keeps the SIP configuration stored, so you can re-enable
it later with a single
PATCH — no need to re-enter credentials. To remove the
configuration completely, use the Delete SIP Registration endpoint.