---
title: "Update Device"
method: PUT
path: "/devices/{id}"
tags: ["Devices", "devices"]
---

# Update Device

`PUT /devices/{id}`

## Request

- Base URL: `https://api.fonestorm.com/v2`
- URL: `https://api.fonestorm.com/v2/devices/{id}`
- Auth: API key in header `token`

Update a Device.

## Path parameters

- `id` string, required

## Request body

- object
  - `fonenumber` string: 10-digit Caller ID for device
  - `name` string: Name/Label for device
  - `type` string: Device type
  - `mac_address` string: Macaddress of device. Leave it blank if device type is FracTELfone OR WebRTC Device. Otherwise `REQUIRED`
  - `speed_dial` string: 1 to 6 digit speed dial for device
  - `call_recording` 'default' | 'yes' | 'no' | 'inbound' | 'outbound' | 'ondemand': Call recording setting for device
  - `e911location_id` string: ID of E911Location object
  - `areacode` string: 3-digit local area code for device
  - `ring_simultaneously` string: 10-digit Phone number to ring simultaneously with device
  - `receive_notify` object: Callback URL to notify when a device gets a call.
    - `type` 'None' | 'Callback' | 'Email', required: Notification type.
    - `email` string: Email address. `REQUIRED` if type is `Email`.
    - `method` 'GET' | 'POST' | 'JSON': Callback URL method. `REQUIRED` if type is `Callback`.
    - `url` string: Callback URL. `REQUIRED` if type is `Callback`. See **Notes** for additional information.
    - `url_username` string: Username for HTTP **Basic** authentication scheme
    - `url_password` string: Password for HTTP **Basic** authentication scheme
  - `send_notify` object: Callback URL to notify when a device makes a call.
    - `type` 'None' | 'Callback' | 'Email', required: Notification type.
    - `email` string: Email address. `REQUIRED` if type is `Email`.
    - `method` 'GET' | 'POST' | 'JSON': Callback URL method. `REQUIRED` if type is `Callback`.
    - `url` string: Callback URL. `REQUIRED` if type is `Callback`. See **Notes** for additional information.
    - `url_username` string: Username for HTTP **Basic** authentication scheme
    - `url_password` string: Password for HTTP **Basic** authentication scheme
  - `host_type` 'static' | 'dynamic': Host type for Trunk Device. REQUIRED if Device type is Trunk Device
  - `host_ip` string: Host IP for Trunk Device. REQUIRED if Host type is static
  - `host_port` number: Host Port for Trunk Device. REQUIRED if Host type is static
  - `timeout_service` object: Timeout Service for a Device.
    - `timeout_type` 'None' | 'Forward' | 'Voicemail' | 'Voice2Email': Timeout Service Type
    - `timeout_id` string: Timeout Service ID
    - `timeout_seconds` string: Timeout after specified seconds
    - `voice2email_greeting` string: Greeting for Service Type Voice2Email
  - `busy_service` object: Busy Service for a Device.
    - `busy_type` 'None' | 'Forward': Busy Service Type
    - `busy_id` string: Busy Service ID
  - `directory_settings` object: Directory Settings for a Device.
    - `first_name` string: Directory First Name
    - `last_name` string: Directory Last Name
    - `show` boolean: Show in Directory or not
    - `speed_dial` string: Directory Speed Dial
  - `forwardall_settings` object: ForwardAll Settings for a Device.
    - `phonenumber` string: ForwardAll Phonenumber
    - `start_time` string: ForwardAll Start Time
    - `end_time` string: ForwardAll End Time

## Response `200`

Success

- object
  - `device` Device
    - `username` string: Unique identifier of device (12-digit number).
    - `name` string: Human-readable label used for device.
    - `fonenumber` string: Caller ID assigned to this device.
    - `mac_address` string: Mac address of device (If available).
    - `type` string: Device type
    - `speed_dial` string: 1 to 6 digit device speed dial.
    - `call_recording` string: Call recording setting on device. One of the following - default, yes, no, inbound, outbound, ondemand
    - `e911location_id` string: ID for E911Location setting object.
    - `areacode` string: 3-digit local area code.
    - `ring_simultaneously` string: 10-digit Phone number to ring simultaneously with device
    - `receive_notify` object: Callback URL to notify when a device gets a call.
      - `type` string: Configured notification type.
      - `email` string: Email address if configured for email.
      - `url` string: HTTP URL.
      - `method` string: HTTP URL method.
    - `send_notify` object: Callback URL to notify when a device makes a call.
      - `type` string: Configured notification type.
      - `email` string: Email address if configured for email.
      - `url` string: HTTP URL.
      - `method` string: HTTP URL method.
    - `host_type` string: Host type for Trunk Device. static or dynamic
    - `host_ip` string: IP of the host if host_type is static
    - `host_port` string: Port of the host if host_type is static
    - `timeout_service` object: Timeout Service for a Device.
      - `timeout_type` 'None' | 'Forward' | 'Voicemail' | 'Voice2Email': Timeout Service Type
      - `timeout_id` string: Timeout Service ID
      - `timeout_seconds` string: Timeout after specified seconds
      - `voice2email_greeting` string: Greeting for Service Type Voice2Email
    - `busy_service` object: Busy Service for a Device.
      - `busy_type` 'None' | 'Forward': Busy Service Type
      - `busy_id` string: Busy Service ID
    - `directory_settings` object: Directory Settings for a Device.
      - `first_name` string: Directory First Name
      - `last_name` string: Directory Last Name
      - `show` boolean: Show in Directory or not
      - `speed_dial` string: Directory Speed Dial
    - `forwardall_settings` object: ForwardAll Settings for a Device.
      - `phonenumber` string: ForwardAll Phonenumber
      - `start_time` string: ForwardAll Start Time
      - `end_time` string: ForwardAll End Time

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `default`: Error

---

[API](https://skmtc.dev/fonestorm/apis/fractel-api-2-12-87c-hail.md) · [All operations](https://skmtc.dev/fonestorm/apis/fractel-api-2-12-87c-hail/llms.txt) · [OpenAPI document](https://skmtc.dev/fonestorm/apis/fractel-api-2-12-87c-hail/revisions/9738d9b806d4?raw)