---
title: "Update User Emergency Location"
method: PUT
path: "/restapi/v1.0/account/{accountId}/extension/{extensionId}/emergency-locations/{locationId}"
tags: ["Automatic Location Updates"]
---

# Update User Emergency Location

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

## Request

- Base URL: `https://platform.ringcentral.com`
- URL: `https://platform.ringcentral.com/restapi/v1.0/account/{accountId}/extension/{extensionId}/emergency-locations/{locationId}`
- Auth: OAuth 2
  - Authorization code: `https://platform.ringcentral.com/restapi/oauth/authorize`
  - Token URL: `https://platform.ringcentral.com/restapi/oauth/token`
- TypeScript: <https://skmtc.dev/ringcentral/apis/ringcentral-api/docs/restapi/v1.0/account/:accountId/extension/:extensionId/emergency-locations/:locationId/put.ts> (a function with typed inputs; its response is checked against the schema)

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

## Path parameters

- `accountId` string, required
- `extensionId` string, required
- `locationId` string, required

## Request body

- EmergencyLocationRequestResource
  - `id` string: Internal identifier of an emergency response location
  - `address` union
    - CommonEmergencyLocationAddressInfoDefault
      - `country` string: Country name
      - `countryId` string: Internal identifier of a country
      - `countryIsoCode` string: ISO code of a country
      - `countryName` string: Full name of a country
      - `state` string: State/Province name. Mandatory for the USA, the UK and Canada
      - `stateId` string: Internal identifier of a state
      - `stateIsoCode` string: ISO code of a state
      - `stateName` string: Full name of a state
      - `city` string: City name
      - `street` string: First line address
      - `street2` string: Second line address (apartment, suite, unit, building, floor, etc.)
      - `zip` string: Postal (Zip) code
      - `customerName` string: Customer name
    - CommonEmergencyLocationAddressInfoAu
      - `country` string: Country name
      - `countryId` string: Internal identifier of a country
      - `countryIsoCode` string: ISO code of a country
      - `countryName` string: Full name of a country
      - `state` string: State/Province name. Mandatory for the USA, the UK and Canada
      - `stateId` string: Internal identifier of a state
      - `stateIsoCode` string: ISO code of a state
      - `stateName` string: Full name of a state
      - `city` string: City name
      - `street` string: The name of the street (the field is utilized as 'streetName' field for AU addresses)
      - `companyName` string: Company name
      - `buildingName` string: (Optional) Building name
      - `streetType` string: Street type
      - `buildingNumber` string: Building/street number
      - `street2` string: Second line address (apartment, suite, unit, building, floor, etc.)
      - `zip` string: Postal (Zip) code
      - `customerName` string: Customer name
    - CommonEmergencyLocationAddressInfoFr
      - `country` string: Country name
      - `countryId` string: Internal identifier of a country
      - `countryIsoCode` string: ISO code of a country
      - `countryName` string: Full name of a country
      - `state` string: State/Province name. Mandatory for the USA, the UK and Canada
      - `stateId` string: Internal identifier of a state
      - `stateIsoCode` string: ISO code of a state
      - `stateName` string: Full name of a state
      - `city` string: City name
      - `street` string: The name of the street (The field is utilized as 'streetName' field for FR addresses)
      - `companyName` string: Company name
      - `buildingName` string: (Optional) Building name
      - `buildingNumber` string: Building/street number
      - `street2` string: Second line address (apartment, suite, unit, building, floor, etc.)
      - `zip` string: Postal (Zip) code
      - `customerName` string: Customer name
  - `name` string: Emergency response location name
  - `site` ShortSiteInfo
    - `id` string: Internal identifier of a site extension
    - `name` string: Extension user first name
  - `addressStatus` 'Valid' | 'Invalid': Emergency address status
  - `usageStatus` 'Active' | 'Inactive': Status of an emergency response location usage.
  - `addressFormatId` string: 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
  - `trusted` boolean: If 'true' address validation for non-us addresses is skipped

## Response `200`

OK

- EmergencyLocationResponseResource: Company emergency response location details
  - `id` string: Internal identifier of an emergency response location
  - `address` union
    - CommonEmergencyLocationAddressInfoDefault
      - `country` string: Country name
      - `countryId` string: Internal identifier of a country
      - `countryIsoCode` string: ISO code of a country
      - `countryName` string: Full name of a country
      - `state` string: State/Province name. Mandatory for the USA, the UK and Canada
      - `stateId` string: Internal identifier of a state
      - `stateIsoCode` string: ISO code of a state
      - `stateName` string: Full name of a state
      - `city` string: City name
      - `street` string: First line address
      - `street2` string: Second line address (apartment, suite, unit, building, floor, etc.)
      - `zip` string: Postal (Zip) code
      - `customerName` string: Customer name
    - CommonEmergencyLocationAddressInfoAu
      - `country` string: Country name
      - `countryId` string: Internal identifier of a country
      - `countryIsoCode` string: ISO code of a country
      - `countryName` string: Full name of a country
      - `state` string: State/Province name. Mandatory for the USA, the UK and Canada
      - `stateId` string: Internal identifier of a state
      - `stateIsoCode` string: ISO code of a state
      - `stateName` string: Full name of a state
      - `city` string: City name
      - `street` string: The name of the street (the field is utilized as 'streetName' field for AU addresses)
      - `companyName` string: Company name
      - `buildingName` string: (Optional) Building name
      - `streetType` string: Street type
      - `buildingNumber` string: Building/street number
      - `street2` string: Second line address (apartment, suite, unit, building, floor, etc.)
      - `zip` string: Postal (Zip) code
      - `customerName` string: Customer name
    - CommonEmergencyLocationAddressInfoFr
      - `country` string: Country name
      - `countryId` string: Internal identifier of a country
      - `countryIsoCode` string: ISO code of a country
      - `countryName` string: Full name of a country
      - `state` string: State/Province name. Mandatory for the USA, the UK and Canada
      - `stateId` string: Internal identifier of a state
      - `stateIsoCode` string: ISO code of a state
      - `stateName` string: Full name of a state
      - `city` string: City name
      - `street` string: The name of the street (The field is utilized as 'streetName' field for FR addresses)
      - `companyName` string: Company name
      - `buildingName` string: (Optional) Building name
      - `buildingNumber` string: Building/street number
      - `street2` string: Second line address (apartment, suite, unit, building, floor, etc.)
      - `zip` string: Postal (Zip) code
      - `customerName` string: Customer name
  - `name` string: Emergency response location name
  - `site` ShortSiteInfo
    - `id` string: Internal identifier of a site extension
    - `name` string: Extension user first 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
  - `owners` LocationOwnerInfo[]: List of private location owners
    - `id` string: Internal identifier of a user - private location owner
    - `extensionNumber` string: Extension number of a location number
    - `name` string: Name of a location owner
  - `addressFormatId` string: Address format ID
  - `trusted` boolean: If 'true' address validation for non-us addresses is skipped

---

[API](https://skmtc.dev/ringcentral/apis/ringcentral-api.md) - [All operations](https://skmtc.dev/ringcentral/apis/ringcentral-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ringcentral/apis/ringcentral-api/revisions/8d602198ec97?raw)