---
title: "Update Switch"
method: PUT
path: "/restapi/v1.0/account/{accountId}/emergency-address-auto-update/switches/{switchId}"
tags: ["Automatic Location Updates"]
---

# Update Switch

`PUT /restapi/v1.0/account/{accountId}/emergency-address-auto-update/switches/{switchId}`

Updates switch. Partial update is not supported, all switch parameters
should be specified. If null value is received or parameter is missing, its
value is removed.

## Path parameters

- `accountId` string, required
- `switchId` string, required

## Request body

- UpdateSwitchInfo
  - `id` string — Internal identifier of a switch
  - `chassisId` string — Unique identifier of a network switch. The supported formats are: XX:XX:XX:XX:XX:XX (symbols 0-9 and A-F) for MAC address and X.X.X.X for IP address (symbols 0-255)
  - `port` string — Switch entity extension for better diversity. Should be used together with chassisId.
  - `name` string — Name of a network switch
  - `site` SwitchSiteInfo
    - `id` string — Internal identifier of a site. The company identifier value is 'main-site'
    - `name` string — Name of a site
  - `emergencyAddress` union
    - object
      - `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
      - `syncStatus` 'Verified' | 'Updated' | 'Deleted' | 'NotRequired' | 'Unsupported' | 'Failed' — Resulting status of emergency address synchronization. Returned for 'Get Device Info' request if `syncEmergencyAddress` parameter is set to `true`
    - object
      - `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
      - `syncStatus` 'Verified' | 'Updated' | 'Deleted' | 'NotRequired' | 'Unsupported' | 'Failed' — Resulting status of emergency address synchronization. Returned for 'Get Device Info' request if `syncEmergencyAddress` parameter is set to `true`
    - object
      - `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
      - `syncStatus` 'Verified' | 'Updated' | 'Deleted' | 'NotRequired' | 'Unsupported' | 'Failed' — Resulting status of emergency address synchronization. Returned for 'Get Device Info' request if `syncEmergencyAddress` parameter is set to `true`

## Response `200`

Updated switch information

- SwitchInfo
  - `uri` string, uri — Link to the network switch resource
  - `id` string — Internal identifier of a network switch
  - `chassisId` string — Unique identifier of a network switch
  - `port` string — Switch entity extension for better diversity. Should be used together with chassisId.
  - `name` string — Name of a network switch
  - `site` SwitchSiteInfo
    - `id` string — Internal identifier of a site. The company identifier value is 'main-site'
    - `name` string — Name of a site
  - `emergencyAddress` union
    - object
      - `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
      - `syncStatus` 'Verified' | 'Updated' | 'Deleted' | 'NotRequired' | 'Unsupported' | 'Failed' — Resulting status of emergency address synchronization. Returned for 'Get Device Info' request if `syncEmergencyAddress` parameter is set to `true`
    - object
      - `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
      - `syncStatus` 'Verified' | 'Updated' | 'Deleted' | 'NotRequired' | 'Unsupported' | 'Failed' — Resulting status of emergency address synchronization. Returned for 'Get Device Info' request if `syncEmergencyAddress` parameter is set to `true`
    - object
      - `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
      - `syncStatus` 'Verified' | 'Updated' | 'Deleted' | 'NotRequired' | 'Unsupported' | 'Failed' — Resulting status of emergency address synchronization. Returned for 'Get Device Info' request if `syncEmergencyAddress` parameter is set to `true`
  - `emergencyLocation` EmergencyLocationInfo — Emergency response location information
    - `id` string, required — Internal identifier of an emergency response location
    - `name` string — Emergency response location name
    - `addressFormatId` string — Address format ID

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/versions/8d602198ec97/schema)