Jump to content

TuCloudAPI getadminusers: Difference between revisions

From Wiki 7Kas
API docs (generated from func=help) — #48 rescoped to per-PBX
TuCloudAPI reference: pbx param help -> FuturePBX (API surface unchanged)
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
''TuCloudAPI function to manage tucloud (PBX) services. Available to: '''SuperRoot, Operator, Client'''.''
''TuCloudAPI function to manage FuturePBX (the cloud PBX). Available to: '''SuperRoot, Operator, Client'''.''


== Description ==
== Description ==
Line 12: Line 12:
! Parameter !! Type !! Required !! Default !! Meaning
! Parameter !! Type !! Required !! Default !! Meaning
|-
|-
| <code>pbx</code> || 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 admin user to it.
| <code>pbx</code> || string || Yes || — || FuturePBX NAME (e.g. tucall). The (ukey, pbx) pair is the tenant boundary; the server verifies the ukey owns this PBX and scopes every admin user to it.
|-
|-
| <code>q</code> || string || No || — || Optional search over login/name/email (contains).
| <code>q</code> || string || No || — || Optional search over login/name/email (contains).

Latest revision as of 14:31, 3 August 2026

TuCloudAPI function to manage FuturePBX (the cloud PBX). Available to: SuperRoot, Operator, Client.

Description

List this PBX's portal admin users (tucloud_sec_users). Strictly scoped to the (ukey, pbx) PBX. Passwords / 2FA secrets are never returned.

Call

GET  https://tucloudapi.7kas.com:9087/tucloud?func=getadminusers&ukey=YOUR_KEY

Requires the ukey parameter.

Parameters

Parameter Type Required Default Meaning
pbx string Yes FuturePBX NAME (e.g. tucall). The (ukey, pbx) pair is the tenant boundary; the server verifies the ukey owns this PBX and scopes every admin user to it.
q string No Optional search over login/name/email (contains).

Example

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

Response

{ok, rows:[{_id,login,name,email,active,priv_admin,role,tucloudpbx_id,root}]}.


Back to TuCloudAPI