---
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}`

## Request

- Base URL: `https://platform.ringcentral.com`
- URL: `https://platform.ringcentral.com/restapi/v1.0/account/{accountId}/emergency-address-auto-update/switches/{switchId}`
- 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/emergency-address-auto-update/switches/:switchId/put.ts> (a function with typed inputs; its response is checked against the schema)

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.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)