TuCloudAPI updategroup
TuCloudAPI function to manage tucloud (PBX) services. Available to: SuperRoot, Operator, Client.
Description
Edit a ring group (same fields as addgroup; gr editable, conflict on collision). Members as extension IDs; exten<N>_dial stays trigger-built. 404 if not in the caller's PBX. Requires a non-readonly ukey.
Call
GET https://tucloudapi.7kas.com:9087/tucloud?func=updategroup&ukey=YOUR_KEY
Requires the ukey parameter.
Parameters
| Parameter | Type | Required | Default | Meaning |
|---|---|---|---|---|
pbx |
string | Yes | — | TuCloud PBX NAME (e.g. tucall). The (ukey, pbx) pair is the tenant boundary; the server verifies the ukey owns this PBX. |
id |
integer | Yes | — | Group id (_id). |
name |
string | Yes | — | Display name (required, max 32). |
gr |
integer | No | 0 |
Group number 1-99 (0 = keep current). |
exten1 |
string | No | — | Comma-separated extension _id list for this ring slot (members ring simultaneously; slots ring in order 1..5). Each id is validated in-tenant. |
exten2 |
string | No | — | Ring slot 2 members. |
exten3 |
string | No | — | Ring slot 3 members. |
exten4 |
string | No | — | Ring slot 4 members. |
exten5 |
string | No | — | Ring slot 5 members. |
ringing1 |
integer | No | 0 |
Slot 1 ring seconds. |
ringing2 |
integer | No | 0 |
Slot 2 ring seconds. |
ringing3 |
integer | No | 0 |
Slot 3 ring seconds. |
ringing4 |
integer | No | 0 |
Slot 4 ring seconds. |
ringing5 |
integer | No | 0 |
Slot 5 ring seconds. |
music |
integer | No | 0 |
Music-on-hold id (0 = none). |
tom |
integer | No | 0 |
0 = tone, 1 = music while ringing. |
fwd |
integer | No | 0 |
External forward 0-4. |
fwdnum |
string | No | — | External forward destination. |
fwd_internal |
integer | No | 0 |
Internal forward mode 0-4. |
fwdnum_internal |
string | No | — | Internal forward destination. |
fwd_cli_id |
integer | No | 0 |
Admin: caller-id cli _id (0 = none). |
fwdshowcaller |
integer | No | 1 |
Admin: 1 = preserve CLI, 0 = rewrite. |
Example
https://tucloudapi.7kas.com:9087/tucloud?func=updategroup&ukey=KEY&pbx=tucall&id=927&name=Ventas&exten1=90671
Response
{ok, group:{...}}.
Back to TuCloudAPI