Jump to content

TuCloudAPI addphonebook

From Wiki 7Kas
Revision as of 04:37, 2 August 2026 by Maintenance script (talk | contribs) (API docs (generated from func=help) — add #48 adminusers + #52 pbxconfig)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

TuCloudAPI function to manage tucloud (PBX) services. Available to: SuperRoot, Operator, Client.

Description

Create a phonebook. name is required + unique per tenant (-> conflict). color is a hex (#RRGGBB, default #3b82f6), icon a bootstrap-icons name (default bi-journal-bookmark), is_personal 0/1. Requires a non-readonly ukey.

Call

GET  https://tucloudapi.7kas.com:9087/tucloud?func=addphonebook&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.
name string Yes Phonebook name (required, unique per tenant, max 128).
description string No Optional description (max 256).
color string No #3b82f6 Hex color #RRGGBB.
icon string No bi-journal-bookmark Bootstrap-icons name (max 32).
is_personal integer No 0 1 = personal address book, 0 = shared.

Example

https://tucloudapi.7kas.com:9087/tucloud?func=addphonebook&ukey=KEY&pbx=tucall&name=Comercial

Response

{ok, phonebook:{...}} or {ok:false,conflict}.


Back to TuCloudAPI