Users
Was this helpful?
Was this helpful?
List a collection of users.
/users
Use the filter
query parameter to retrieve just a subset of a collection.
Use the search
query parameter to restrict the results of a request to match a search criterion.
Use the orderby
query parameter to specify the sort order of the items returned from server.
The default order is ascending order.
Use the skip
query parameter to set the number of items to skip at the start of a collection.
Use the top
query parameter to specify the page size of the result set.
Create a new user.
/users
The user's account name.
Only letters, numbers, and the following special characters can be added: underscore, dash, single quote, and period (_, -, ', and .).
Username cannot start or end with period (.).
admin
, system
, administrator
, and root
are reserved names for system admin only with case ignored.
The password of user.
The display name of user.
Allows temporarily disabling the extension.
Roles include built-in roles and custom roles.
Built-in roles roles cannot be modified.
Also, the names of built-in roles are reserved words,
custom roles are not allowed to use these names to avoid unnecessary confusion.
Built-in roles include:
SystemAdmin
: the system administrator has almost all permissions.Replicator
: the application permissions collection.Dealer
: the sales manager has all sold tenant resource permissionsAdmin
: the admin has all tenant-wide resource permissions.StandardUser
: the user all user-wide resource permissions.StandardInternationalUser
: the user all user-wide resource permissions with international call permissions.QueueManager
: The call queue manager.User
The mobile phone number of user.
The office phone number of user.
The home phone number of user.
The address.
The department of user.
The extension number.
[0-9]{3,64}
The extension password.
Records all calls and saves audio recordings on server.
Records all calls and saves video recordings on server.
Enable Do Not Disturb
or not.
Enable Automatic Callback
or not.
Enable hot desking feature or not.
Always make outbound anonymous calls or not.
Always delivery outbound caller ID or not.
Some custom configuration options serialized as json string
BCP 47 Language Tags (The Internet Best Current Practices (BCP) for language tags). A language tag is composed of a sequence of one or more subtags such as language, region, variant and script subtags. When a language tag is comprised of more than one subtag, the subtag values are separated by the "-" character. You will most commonly find language tags written with 2 subtags - language and region. For example: en-US.
en-US
Whether the PIN is required to access voice mail of extension.
The PIN number for accessing.
The PIN policies include:
Enable voicemail to email notify.
The preferred configuration for SMS/MMS.
Note: Only users with UserManagement::Users
privilege can change this property.
DISABLE
: Disable user SMS/MMS feature.ALLOW
: Enable user SMS/MMS feature but with outbound caller ID.ALLOW_WITH_SENDER_ID
: Enable user SMS/MMS but with trunk sender ID.DISABLE
, ALLOW
, ALLOW_WITH_SENDER_ID
Announces Date and Time of Message.
DISABLE
: Do not read;12_HOUR_CLOCK
: Read in 12-hour clock;24_HOUR_CLOCK
: Read in 24-hour clock.DISABLE
, 12_HOUR_CLOCK
, 24_HOUR_CLOCK
The interface type for QR code or auto provisioning.
Can be neither:
WEB_DOMAIN
:PUBLIC_IPV4
:PUBLIC_IPV6
:PRIVATE_IPV4
:PRIVATE_IPV6
:SBC_DOMAIN
:WEB_DOMAIN
, PUBLIC_IPV4
, PUBLIC_IPV6
, PRIVATE_IPV4
, PRIVATE_IPV6
, SBC_DOMAIN
The transport protocol:
Can be either:
UDP
:TCP
:TLS
:UDP
, TCP
, TLS
The email address of user.
The email address.
Modify the settings of a user.
/users/{id}
The unique ID of user.
The unique ID of the resource.
The display name of user.
Allows temporarily disabling the extension.
The mobile phone number of user.
The office phone number of user.
The home phone number of user.
The address.
The department of user.
Records all calls and saves audio recordings on server.
Records all calls and saves video recordings on server.
Enable Do Not Disturb
or not.
Enable Automatic Callback
or not.
Enable hot desking feature or not.
Always make outbound anonymous calls or not.
Always delivery outbound caller ID or not.
Some custom configuration options serialized as json string
BCP 47 Language Tags (The Internet Best Current Practices (BCP) for language tags). A language tag is composed of a sequence of one or more subtags such as language, region, variant and script subtags. When a language tag is comprised of more than one subtag, the subtag values are separated by the "-" character. You will most commonly find language tags written with 2 subtags - language and region. For example: en-US.
en-US
Whether the PIN is required to access voice mail of extension.
The PIN number for accessing.
The PIN policies include:
Enable voicemail to email notify.
The preferred configuration for SMS/MMS.
Note: Only users with UserManagement::Users
privilege can change this property.
DISABLE
: Disable user SMS/MMS feature.ALLOW
: Enable user SMS/MMS feature but with outbound caller ID.ALLOW_WITH_SENDER_ID
: Enable user SMS/MMS but with trunk sender ID.DISABLE
, ALLOW
, ALLOW_WITH_SENDER_ID
Announces Date and Time of Message.
DISABLE
: Do not read;12_HOUR_CLOCK
: Read in 12-hour clock;24_HOUR_CLOCK
: Read in 24-hour clock.DISABLE
, 12_HOUR_CLOCK
, 24_HOUR_CLOCK
The interface type for QR code or auto provisioning.
Can be neither:
WEB_DOMAIN
:PUBLIC_IPV4
:PUBLIC_IPV6
:PRIVATE_IPV4
:PRIVATE_IPV6
:SBC_DOMAIN
:WEB_DOMAIN
, PUBLIC_IPV4
, PUBLIC_IPV6
, PRIVATE_IPV4
, PRIVATE_IPV6
, SBC_DOMAIN
The transport protocol:
Can be either:
UDP
:TCP
:TLS
:UDP
, TCP
, TLS
The email address of user.
The email address.
No body