Rotate (replace) the password for a SIP credential
Generates a fresh random password for the credential. The new plaintext is returned once; the previous password stops working immediately. Caller must have writer access to the workspace.
Authorization
bearerAuth Long-lived ES256 JWT minted from the dashboard (https://app.sautikit.com/developers/api-keys). Signed by the
platform keyring. Carries workspace_id and scopes claims;
revoked via the platform deny-list.
In: header
Path Parameters
Tenant number UUID.
uuidSIP credential UUID.
uuidResponse Body
application/json
application/json
curl -X POST "https://example.com/v1/numbers/497f6eca-6276-4993-bfeb-53cbbbba6f08/sip-credentials/497f6eca-6276-4993-bfeb-53cbbbba6f08/rotate"{ "password": "string", "display_once": true, "rotated_at": "2019-08-24T14:15:22Z"}{ "error": { "code": "validation.bad_request", "message": "string", "request_id": "string", "details": [ "string" ] }}Show an existing credential's password again POST
Returns the credential's password and connection settings again. The registrar owns the secret and returns it on request, so nothing is rotated and a registered device keeps working.
Change a credential's label, caller reference or extension PATCH
Updates a credential without disturbing the device using it — no password change and no dropped registration. A caller-reference change is pushed to the registrar, so it applies to the next outbound call. Omit a field to leave it unchanged; pass an empty string to clear one. Clearing client_id makes calls present the number itself; clearing extension removes the device from internal dialling.