Skip to main content
POST
/
api
/
v1
/
Account
/
{auth_id}
/
Endpoint
/
{endpoint_id}
/
Update an Endpoint
curl --request POST \
  --url https://api.vobiz.ai/api/v1/Account/{auth_id}/Endpoint/{endpoint_id}/ \
  --header 'Content-Type: application/json' \
  --header 'X-Auth-ID: <api-key>' \
  --header 'X-Auth-Token: <api-key>' \
  --data @- <<EOF
{
  "alias": "John's Updated Desktop Phone",
  "password": "NewSecurePassword456!"
}
EOF
"<string>"
POST https://api.vobiz.ai/api/v1/Account/{auth_id}/Endpoint/{endpoint_id}/
Updates an existing endpoint’s configuration. You can change the password, update the alias, or modify the application that handles incoming calls to this endpoint.
Authentication required:
  • X-Auth-ID - Your account Auth ID (e.g., {auth_id})
  • X-Auth-Token - Your account Auth Token
  • Content-Type: application/json
Cannot Update: The following fields are locked after endpoint creation: username, endpoint_id, domain, allow_same_domain, allow_other_domains, allow_phones, allow_apps. To change these values, create a new endpoint and delete the old one.

​
Request Parameters

FieldTypeRequiredDescription
passwordstringNoSIP password (minimum 8 characters). Use this to reset or update the endpoint password.
aliasstringNoFriendly name for the endpoint.
applicationintegerNoApplication ID for call routing. This application will handle incoming calls to the endpoint.
allow_voicebooleanNoAllow voice calls (default: true).
allow_messagebooleanNoAllow messaging (default: true).
allow_videobooleanNoAllow video calls (default: false).
All parameters are optional. You only need to include the fields you want to update. Fields not provided will remain unchanged.
Setting application to a different numeric app_id swaps which application handles this endpoint’s calls. An unknown app_id returns a 400. An endpoint binds to exactly one application at a time.

​
Response

​
Success Response (202 Accepted)

On success, returns HTTP status code 202 Accepted with no response body.
Response - 202 Accepted
HTTP/1.1 202 Accepted

​
Error Response (400 Bad Request)

Response - 400 Bad Request
{
  "error": "invalid request parameters",
  "details": {
    "password": "Password must be at least 8 characters"
  }
}

​
Error Response (404 Not Found)

Response - 404 Not Found
HTTP/1.1 404 Not Found

​
Examples

​
Update Alias

cURL Request
curl -X POST https://api.vobiz.ai/api/v1/Account/{auth_id}/Endpoint/87654321/ \
  -H "X-Auth-ID: YOUR_AUTH_ID" \
  -H "X-Auth-Token: YOUR_AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "alias": "John'\''s Updated Desktop Phone"
  }'

​
Update Password

cURL Request
curl -X POST https://api.vobiz.ai/api/v1/Account/{auth_id}/Endpoint/87654321/ \
  -H "X-Auth-ID: YOUR_AUTH_ID" \
  -H "X-Auth-Token: YOUR_AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "password": "NewSecurePassword456!"
  }'

​
Update Multiple Fields

cURL Request
curl -X POST https://api.vobiz.ai/api/v1/Account/{auth_id}/Endpoint/87654321/ \
  -H "X-Auth-ID: YOUR_AUTH_ID" \
  -H "X-Auth-Token: YOUR_AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "alias": "John'\''s Updated Desktop Phone",
    "password": "NewSecurePassword456!",
    "application": 98765432,
    "allow_voice": true,
    "allow_message": true,
    "allow_video": true
  }'
Common Use Cases:
  • Reset forgotten endpoint passwords
  • Update aliases to reflect role changes
  • Switch applications for different call routing logic
  • Rotate passwords regularly for security
  • Enable or disable video/messaging capabilities
After updating a password, SIP clients using this endpoint must re-register with the new credentials. Plan updates during maintenance windows to minimize disruption.

Authorizations

​
X-Auth-ID
string
header
required

Your Vobiz account Auth ID

​
X-Auth-Token
string
header
required

Your Vobiz account Auth Token

Path Parameters

​
auth_id
string
required

Your account Auth ID

Example:

"MA_XXXXXX"

​
endpoint_id
string
required
Example:

"87654321"

Body

application/json
​
alias
string
required
​
password
string
required

Response

Success

The response is of type string.