Jump to content

TuCloudAPI setprofileapps

From Wiki 7Kas
Revision as of 05:36, 2 August 2026 by Maintenance script (talk | contribs) (API docs (generated from func=help) — add #50 security profiles/ACL)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

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

Description

Bulk-save a profile's permission matrix in one call (the primary matrix write). matrix = a JSON array of {app_name, access, insert, delete, update, export, print} (flags 0/1). app_type-irrelevant privileges are normalised to 0 server-side; unknown app_names are ignored. Send via POST body for the full grid. not_found if the profile is not in this PBX. Requires a non-readonly ukey.

Call

GET  https://tucloudapi.7kas.com:9087/tucloud?func=setprofileapps&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 and scopes every profile to it.
group integer Yes Profile id (_id).
matrix string Yes JSON array of per-app permission rows (see description).

Example

https://tucloudapi.7kas.com:9087/tucloud?func=setprofileapps&ukey=KEY&pbx=tucall&group=1  (matrix in POST body)

Response

{ok, apps:[...]} or {ok:false,code:not_found|invalid_param}.


Back to TuCloudAPI