v1

latestOpenAPI 3.0.3RingCentral API License Agreement2026-08-064871,2921.5 MB
Automatic Location Updates

Update User Emergency Location

Updates a personal emergency response location by the current user or admin.

put/restapi/v1.0/account/{accountId}/extension/{extensionId}/emergency-locations/{locationId}

Path parameters

accountIdstring required

Internal identifier of the RingCentral account (can be set to "~" to indicate that the account associated with current authorization session should be used)

extensionIdstring required

Internal identifier of the RingCentral extension/user (can be set to "~" to indicate that the extension associated with current authorization session should be used)

locationIdstring required

Internal identifier of an emergency response location

Request body

idstring

Internal identifier of an emergency response location

namestring

Emergency response location name

addressStatus'Valid' | 'Invalid'

Emergency address status

usageStatus'Active' | 'Inactive'

Status of an emergency response location usage.

addressFormatIdstring

Address format ID

visibility'Public'

Visibility of an emergency response location. If Private is set, then a location is visible only for restricted number of users, specified in owners array

trustedboolean

If 'true' address validation for non-us addresses is skipped

Response

OK

idstring

Internal identifier of an emergency response location

namestring

Emergency response location name

addressStatus'Valid' | 'Invalid' | 'Provisioning'

Emergency address status

usageStatus'Active' | 'Inactive'

Status of emergency response location usage.

syncStatus'Verified' | 'Updated' | 'Deleted' | 'ActivationProcess' | 'NotRequired' | 'Unsupported' | 'Failed'

Resulting status of emergency address synchronization. Returned if syncEmergencyAddress parameter is set to true

addressType'LocationWithElins' | 'LocationWithEndpoint'
visibility'Private' | 'Public'

Visibility of an emergency response location. If Private is set, then location is visible only for the restricted number of users, specified in owners array

addressFormatIdstring

Address format ID

trustedboolean

If 'true' address validation for non-us addresses is skipped