---
title: "Update RingGroup"
method: PUT
path: "/ringgroups/{id}"
tags: ["RingGroups", "ringgroups"]
---

# Update RingGroup

`PUT /ringgroups/{id}`

## Request

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

Update a RingGroup.

## Path parameters

- `id` string, required

## Request body

- object
  - `label` string: Name/Label for RingGroup
  - `destinations` object[]
    - `destination_type` 'Device' | 'SpeedDial', required: Destination type for RingGroup
    - `destination` string: Destination id for RingGroup
  - `greeting` string: Greeting text or soundfile
  - `ring_strategy` 'Simultaneous' | 'Sequential' | 'Random' | 'LongestIdle': Ring strategy for RingGroup
  - `max_ring_time` integer: Maximum ring time in seconds
  - `ring_timeout` integer: Ring timeout in seconds
  - `ring_busy_destinations` boolean: Ring busy destinations or not
  - `failover_type` 'Hangup' | 'Busy' | 'Reject' | 'Forward' | 'SpeedDial' | 'Announcement' | 'Conference' | 'Device' | 'DigitQuery' | 'IVRMenu' | 'RingGroup' | 'Scheduler' | 'Voicemail' | 'Directory' | 'PageGroup' | 'RingAllPhones' | 'SIPURI' | 'Queue' | 'WebHook' | 'WebRequest' | 'FoneStormConnector': RingGroup Failover Type.
  - `failover` string: Failover ID.

## Response `200`

Success

- object
  - `ringgroup` RingGroup
    - `id` string: RingGroup ID.
    - `label` string: Name/Label for RingGroup.
    - `destinations` object[]
      - `destination_type` 'Device' | 'SpeedDial': Destination type for RingGroup
      - `destination` string: Destination id for RingGroup
    - `greeting` string: Greeting SoundFile or Greeting Text for RingGroup
    - `ring_strategy` 'Simultaneous' | 'Sequential' | 'Random' | 'LongestIdle': RingGroup strategy
    - `max_ring_time` integer: Maximum ring time in seconds
    - `ring_timeout` integer: Ring timeout in seconds
    - `ring_busy_destinations` boolean: Ring busy destinations or not
    - `failover_type` 'SpeedDial' | 'Device' | 'Phonenumber' | 'RingGroup' | 'Conference' | 'DigitQuery' | 'IVRMenu' | 'Scheduler' | 'Voicemail' | 'WebHook' | 'WebRequest' | 'FoneStormConnector' | 'Hangup' | 'Busy' | 'Reject': RingGroup Failover Type.
    - `failover` string: Failover ID.

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