Users | PortSIP Knowledge Base

List roles

get

List a collection of roles.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

filterstringOptional

Use the filter query parameter to retrieve just a subset of a collection.

searchstringOptional

Use the search query parameter to restrict the results of a request to match a search criterion.

orderbystringOptional

Use the orderby query parameter to specify the sort order of the items returned from server.
The default order is ascending order.

skipinteger · int32Optional

Use the skip query parameter to set the number of items to skip at the start of a collection.

Default: 0

topinteger · int32 · min: 1 · max: 100Optional

Use the top query parameter to specify the page size of the result set.

Default: 100

Responses

200

OK

application/json

4XX

Error

get

/roles

GET /api/roles HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 1,
  "items": [
    {
      "id": null,
      "name": null,
      "protected": false,
      "capabilities": null,
      "description": null
    }
  ]
}

Create a role

post

Create a new role.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

namestring · min: 1 · max: 64Required

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.
OperationsAdmin: the operations administrator.
SiteAdmin: the site administrator.
Dealer: the sales manager has all sold tenant resource permissions.
Admin: 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.

Example: User

capabilitiesstring[]Required

The permission string.

descriptionstring · max: 1024Optional

Role's description.

Responses

201

OK

application/json

4XX

Error

post

/roles

POST /api/roles HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 52

{
  "name": null,
  "capabilities": null,
  "description": null
}

{
  "id": "xxxxxxxx"
}

Get a role

get

Retrieves the settings of a role.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of role.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/roles/{id}

GET /api/roles/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": null,
  "name": null,
  "capabilities": null,
  "protected": false,
  "description": null
}

Update a role

post

Modify the settings of a role.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of role.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

namestring · min: 1 · max: 64Optional

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.
OperationsAdmin: the operations administrator.
SiteAdmin: the site administrator.
Dealer: the sales manager has all sold tenant resource permissions.
Admin: 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.

Example: User

capabilitiesstring[]Optional

The permission string.

descriptionstring · max: 1024Optional

Role's description.

Responses

200

OK

No content

4XX

Error

post

/roles/{id}

POST /api/roles/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 52

{
  "name": null,
  "capabilities": null,
  "description": null
}

No content

Delete a role

post

Delete a certain role.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of role.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

204

No Content

4XX

Error

post

/roles/{id}/destroy

POST /api/roles/{id}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Retrieve current user

get

Retrieve details of current user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

4XX

Error

get

/user

GET /api/user HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": null,
  "name": null,
  "email": null,
  "display_name": null,
  "role": null,
  "role_id": null,
  "role_name": null,
  "enabled": null,
  "mobile_phone": null,
  "work_phone": null,
  "home_phone": null,
  "address": null,
  "department": null,
  "extension_number": null,
  "enable_audio_recording": null,
  "enable_video_recording": null,
  "enable_dnd": null,
  "enable_acb": null,
  "enable_hot_desking": null,
  "anonymous_outbound_calls": null,
  "delivery_outbound_cid": null,
  "sms": null,
  "outbound_caller_ids": null,
  "custom_options": null,
  "office_hours": null,
  "available_office_hours_forward_rule": null,
  "available_non_office_hours_forward_rule": null,
  "available_no_answer_forward_rule": null,
  "busy_office_hours_forward_rule": null,
  "busy_non_office_hours_forward_rule": null,
  "busy_no_answer_forward_rule": null,
  "dnd_office_hours_forward_rule": null,
  "dnd_non_office_hours_forward_rule": null,
  "away_office_hours_forward_rule": null,
  "away_non_office_hours_forward_rule": null,
  "lunch_office_hours_forward_rule": null,
  "lunch_non_office_hours_forward_rule": null,
  "trip_office_hours_forward_rule": null,
  "trip_non_office_hours_forward_rule": null,
  "offline_office_hours_forward_rule": null,
  "offline_non_office_hours_forward_rule": null,
  "custom_forward_rules": null,
  "voicemail_prompt": null,
  "enable_voicemail_pin": null,
  "voicemail_pin": null,
  "enable_voicemail_notify": null,
  "voicemail_play_datetime": null,
  "interface": null,
  "preferred_transport": null,
  "blfs": null,
  "created_at": null,
  "avatar_file_name": null,
  "avatar_file_size": null,
  "avatar_file_url": null,
  "transports": null,
  "profile": null,
  "provider": null,
  "provider_id": null,
  "sync_type": null,
  "enable_uc_app": true,
  "enable_teams_phone_app": true
}

Update current user properties.

post

Update current user properties.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

emailall ofOptional

The email address of user.

string · max: 128Optional

The email address.

Example: [email protected]

display_namestring · max: 1024Optional

The display name of user.

mobile_phonestring · max: 32Optional

The mobile phone number of user.

work_phonestring · max: 32Optional

The office phone number of user.

home_phonestring · max: 32Optional

The home phone number of user.

addressstring · max: 128Optional

The address.

departmentstring · max: 128Optional

The department of user.

enable_audio_recordingbooleanOptional

Records all calls and saves audio recordings on server.

Default: false

enable_video_recordingbooleanOptional

Records all calls and saves video recordings on server.

Default: false

enable_dndbooleanOptional

Enable Do Not Disturb or not.

enable_acbbooleanOptional

Enable Automatic Callback or not.

enable_hot_deskingbooleanOptional

Enable hot desking feature or not.

Default: false

anonymous_outbound_callsbooleanOptional

Always make outbound anonymous calls or not.

Default: false

delivery_outbound_cidbooleanOptional

Always delivery outbound caller ID or not.

Default: true

smsstring · enumOptional

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.

Default: DISABLEPossible values:

custom_optionsstringOptional

Some custom configuration options serialized as json string

voicemail_promptstringOptional

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.

Example: en-US

enable_voicemail_pinbooleanOptional

Whether the PIN is required to access voice mail of extension.

Default: true

voicemail_pinstringOptional

The PIN number for accessing.

enable_voicemail_notifybooleanOptional

Enable voicemail to email notify.

Default: false

voicemail_play_datetimestring · enumOptional

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.

Possible values:

interfacestring · enumOptional

The interface type for QR code or auto provisioning.
Can be neither:

WEB_DOMAIN:
PUBLIC_IPV4:
PUBLIC_IPV6:
PRIVATE_IPV4:
PRIVATE_IPV6:
SBC_DOMAIN:

Possible values:

preferred_transportstring · enumOptional

The transport protocol:
Can be either:

UDP:
TCP:
TLS:

Possible values:

enable_ai_transcriptbooleanOptional

Enable ai transcript or not.

enable_uc_appbooleanOptional

Enable user-agent of app or not.

enable_teams_phone_appbooleanOptional

Enable enable teams phone app or not.

avatar_file_idall ofOptional

The unique ID of the file.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

4XX

Error

post

/user

POST /api/user HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1278

{
  "email": null,
  "display_name": null,
  "mobile_phone": null,
  "work_phone": null,
  "home_phone": null,
  "address": null,
  "department": null,
  "enable_audio_recording": null,
  "enable_video_recording": null,
  "enable_dnd": null,
  "enable_acb": null,
  "enable_hot_desking": null,
  "anonymous_outbound_calls": null,
  "delivery_outbound_cid": null,
  "sms": null,
  "outbound_caller_ids": null,
  "custom_options": null,
  "office_hours": null,
  "available_office_hours_forward_rule": null,
  "available_non_office_hours_forward_rule": null,
  "available_no_answer_forward_rule": null,
  "busy_office_hours_forward_rule": null,
  "busy_non_office_hours_forward_rule": null,
  "busy_no_answer_forward_rule": null,
  "dnd_office_hours_forward_rule": null,
  "dnd_non_office_hours_forward_rule": null,
  "away_office_hours_forward_rule": null,
  "away_non_office_hours_forward_rule": null,
  "lunch_office_hours_forward_rule": null,
  "lunch_non_office_hours_forward_rule": null,
  "trip_office_hours_forward_rule": null,
  "trip_non_office_hours_forward_rule": null,
  "offline_office_hours_forward_rule": null,
  "offline_non_office_hours_forward_rule": null,
  "custom_forward_rules": null,
  "voicemail_prompt": null,
  "enable_voicemail_pin": null,
  "voicemail_pin": null,
  "enable_voicemail_notify": null,
  "voicemail_play_datetime": null,
  "interface": null,
  "preferred_transport": null,
  "blfs": null,
  "avatar_file_id": null
}

No content

Reset current user password

post

Reset current user password.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

old_passwordstringOptional

The password of user.

new_passwordstringOptional

The password of user.

Responses

200

OK

No content

4XX

Error

post

/user/password

POST /api/user/password HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 41

{
  "old_password": null,
  "new_password": null
}

No content

Reset current user extension password

post

Reset current user extension password.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

old_passwordstringOptional

The extension password.

new_passwordstringOptional

The extension password.

Responses

200

OK

No content

4XX

Error

post

/user/extension_password

POST /api/user/extension_password HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 41

{
  "old_password": null,
  "new_password": null
}

No content

Reset current user profile

post

Reset current user profile.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

No content

4XX

Error

post

/user/profile

POST /api/user/profile HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Retrieves current user status

get

Get status of current user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

4XX

Error

get

/user/status

GET /api/user/status HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "ONLINE",
  "presence": null,
  "presence_note": null,
  "registration": null,
  "enable_dnd": null,
  "enable_acb": null
}

Set current extension user presence

post

Set current extension user presence.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

presencestringOptional

The specified presence of the extension.

ONLINE
LUNCH
BUSINESS_TRIP
DO_NOT_DISTURB
AWAY

presence_notestring · max: 128Optional

The presence note.

Responses

200

OK

No content

4XX

Error

post

/user/presence

POST /api/user/presence HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "presence": null,
  "presence_note": null
}

No content

Retrieve current user balance.

get

Retrieve current user's balance.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

4XX

Error

get

/user/balance

GET /api/user/balance HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "balance": 100
}

List current user voicemail greetings

get

Retrieves a collection of greetings for current user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

4XX

Error

get

/user/greetings

GET /api/user/greetings HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": null,
      "enabled": null,
      "file_name": null,
      "file_size": null,
      "file_url": null
    }
  ]
}

Create voicemail greeting for current user

post

Create voicemail greeting for current user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

file_idall ofOptional

The unique ID of the file.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

201

OK

application/json

4XX

Error

post

/user/greetings

POST /api/user/greetings HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "file_id": "xxxxxxxxxxxxxxxxxxxxx"
}

{
  "id": "xxxxxxxx"
}

Enable one of current user's greetings.

post

Set one of current user's greetings to activated state.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of greeting.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

400

Invalid extension number supplied

404

User not found

post

/user/greetings/{id}/enable

POST /api/user/greetings/{id}/enable HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Disable current user greeting

post

Disable current user voicemail greeting by it's unique ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of greeting.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

400

Invalid extension number supplied

404

User not found

post

/user/greetings/{id}/disable

POST /api/user/greetings/{id}/disable HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Delete voicemail greeting

post

Destroy a voicemail greeting from user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of greeting.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

204

No Content

4XX

Error

post

/user/greetings/{id}/destroy

POST /api/user/greetings/{id}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

List current user's IP phones

get

Retrieve a collection of IP Phones for current user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

4XX

Error

get

/user/phones

GET /api/user/phones HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": null,
      "mac": null,
      "filename": null,
      "vendor": null,
      "model": null,
      "fwver": null,
      "password": null,
      "language": null,
      "transfer": null,
      "timezone": null,
      "ringtone": null,
      "queue_ringtone": null,
      "external_ringtone": null,
      "date_format": null,
      "time_format": null,
      "powerled": null,
      "backlight": null,
      "screensaver": null,
      "rps": null,
      "https": null,
      "codecs": null,
      "enable_lldp": null,
      "enable_vlan_wan_port": null,
      "wan_port_id": null,
      "wan_port_priority": null,
      "enable_vlan_pc_port": null,
      "pc_port_id": null,
      "pc_port_priority": null,
      "interface": null,
      "preferred_transport": null,
      "serial_number": null,
      "door_password1": null,
      "door_password2": null,
      "url": null
    }
  ]
}

Assign phone to current user

post

Assign a phone to current user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

macall ofRequired

MAC address of this IP phone.

stringOptional

MAC address.

filenamestringRequired

Template XML file name for phone provisioning.

vendorstringRequired

The phone vendor of IP phone.

modelstringRequired

The name of IP phone model.

passwordstringRequired

Password for accessing the Web interface of phone. The username remains default because most phone manufacturers do not allow modification of the user name. This is supported for some phone model, such as "Snom 300".

languagestring · enumRequired

Language for strings displayed on Phone Display LCD. Supported languages include ENGLISH, CHINESE, DUTCH, FRENCH, GERMAN, GREEK, ITALIAN, JAPANESE, POLISH, RUSSIAN, SPANISH, SWEDISH, UKRAINIAN, and BULGARIAN.

Possible values:

transferstring · enumRequired

The transfer method for auto provision.
Can be either:

BLIND: After the IP phone is configured with the BLF of a certain key, during a call on the IP phone, press the key, and the phone will directly initiate a Blind transfer to the configured number.
ATTENDED: After the IP phone is configured with the BLF of a key, during a call on the IP phone, press the key, and the phone will directly initiate an Attended transfer to the configured number.
NEW_CALL: After the IP phone is configured with the BLF of a certain key, during a call on the IP phone, press the key, and the phone will initiate a new call to the configured number.

Default: BLINDPossible values:

timezonestringRequired

The timezone of phone.

ringtonestringOptional

The ringtone of phone.

queue_ringtonestringOptional

The queue ringtone of phone for queue calls or ring group calls.

external_ringtonestringOptional

The ringtone of phone for external calls.

date_formatstringOptional

The date format of phone.

time_formatstringOptional

The time format of phone.

powerledstringOptional

The power led of phone.

backlightstringOptional

The backlight of phone.

screensaverstringOptional

The screensaver of phone.

rpsbooleanOptional

Send to RPS or not.

httpsbooleanOptional

Whether to use https

codecsstring[]Required

The list of currently enabled codec formats.

enable_lldpbooleanOptional

Enable or disable Link Layer Discovery Protocol.

Default: false

enable_vlan_wan_portbooleanOptional

Enable or disable VLAN for WAN Port.

Default: false

wan_port_idinteger · min: 1 · max: 4094Optional

VLAN ID for WAN PORT.

wan_port_priorityinteger · max: 7Optional

VLAN priority for WAN Port.

enable_vlan_pc_portbooleanOptional

Enable or disable VLAN for PC Port.

Default: false

pc_port_idinteger · min: 1 · max: 4094Optional

VLAN ID for PC PORT.

pc_port_priorityinteger · max: 7Optional

VLAN priority for PC Port.

interfacestring · enumRequired

The interface type for QR code or auto provisioning.
Can be neither:

WEB_DOMAIN:
PUBLIC_IPV4:
PUBLIC_IPV6:
PRIVATE_IPV4:
PRIVATE_IPV6:
SBC_DOMAIN:

Possible values:

preferred_transportstring · enumRequired

The transport protocol:
Can be either:

UDP:
TCP:
TLS:

Possible values:

serial_numberstringOptional

The serial number of phone.

door_password1string · min: 1 · max: 8Optional

The primary door password of phone. Only numeric sequences are allowed.

door_password2string · min: 1 · max: 8Optional

The secondary door password of phone. Only numeric sequences are allowed.

Responses

201

Success

application/json

4XX

Error

post

/user/phones

POST /api/user/phones HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 579

{
  "mac": null,
  "filename": null,
  "vendor": null,
  "model": null,
  "password": null,
  "language": null,
  "transfer": null,
  "timezone": null,
  "ringtone": null,
  "queue_ringtone": null,
  "external_ringtone": null,
  "date_format": null,
  "time_format": null,
  "powerled": null,
  "backlight": null,
  "screensaver": null,
  "rps": null,
  "https": null,
  "codecs": null,
  "enable_lldp": null,
  "enable_vlan_wan_port": null,
  "wan_port_id": null,
  "wan_port_priority": null,
  "enable_vlan_pc_port": null,
  "pc_port_id": null,
  "pc_port_priority": null,
  "interface": null,
  "preferred_transport": null,
  "serial_number": null,
  "door_password1": null,
  "door_password2": null
}

{
  "id": "xxxxxxxx"
}

Retrieve current user phone details

get

Retrieve phone details of current user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of phone.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/user/phones/{id}

GET /api/user/phones/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": null,
  "mac": null,
  "filename": null,
  "vendor": null,
  "model": null,
  "password": null,
  "language": null,
  "transfer": null,
  "timezone": null,
  "ringtone": null,
  "queue_ringtone": null,
  "external_ringtone": null,
  "date_format": null,
  "time_format": null,
  "powerled": null,
  "backlight": null,
  "screensaver": null,
  "rps": null,
  "https": null,
  "codecs": null,
  "enable_lldp": null,
  "enable_vlan_wan_port": null,
  "wan_port_id": null,
  "wan_port_priority": null,
  "enable_vlan_pc_port": null,
  "pc_port_id": null,
  "pc_port_priority": null,
  "interface": null,
  "preferred_transport": null,
  "serial_number": null,
  "door_password1": null,
  "door_password2": null,
  "url": null
}

Update a phone of current user

post

Update phone of current user by it's unique ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of phone.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

passwordstringOptional

Password for accessing the Web interface of phone. The username remains default because most phone manufacturers do not allow modification of the user name. This is supported for some phone model, such as "Snom 300".

languagestring · enumOptional

Language for strings displayed on Phone Display LCD. Supported languages include ENGLISH, CHINESE, DUTCH, FRENCH, GERMAN, GREEK, ITALIAN, JAPANESE, POLISH, RUSSIAN, SPANISH, SWEDISH, UKRAINIAN, and BULGARIAN.

Possible values:

transferstring · enumOptional

The transfer method for auto provision.
Can be either:

BLIND: After the IP phone is configured with the BLF of a certain key, during a call on the IP phone, press the key, and the phone will directly initiate a Blind transfer to the configured number.
ATTENDED: After the IP phone is configured with the BLF of a key, during a call on the IP phone, press the key, and the phone will directly initiate an Attended transfer to the configured number.
NEW_CALL: After the IP phone is configured with the BLF of a certain key, during a call on the IP phone, press the key, and the phone will initiate a new call to the configured number.

Default: BLINDPossible values:

timezonestringOptional

The timezone of phone.

ringtonestringOptional

The ringtone of phone.

queue_ringtonestringOptional

The queue ringtone of phone for queue calls or ring group calls.

external_ringtonestringOptional

The ringtone of phone for external calls.

date_formatstringOptional

The date format of phone.

time_formatstringOptional

The time format of phone.

powerledstringOptional

The power led of phone.

backlightstringOptional

The backlight of phone.

screensaverstringOptional

The screensaver of phone.

rpsbooleanOptional

Send to RPS or not.

httpsbooleanOptional

Whether to use https

codecsstring[]Optional

The list of currently enabled codec formats.

enable_lldpbooleanOptional

Enable or disable Link Layer Discovery Protocol.

Default: false

enable_vlan_wan_portbooleanOptional

Enable or disable VLAN for WAN Port.

Default: false

wan_port_idinteger · min: 1 · max: 4094Optional

VLAN ID for WAN PORT.

wan_port_priorityinteger · max: 7Optional

VLAN priority for WAN Port.

enable_vlan_pc_portbooleanOptional

Enable or disable VLAN for PC Port.

Default: false

pc_port_idinteger · min: 1 · max: 4094Optional

VLAN ID for PC PORT.

pc_port_priorityinteger · max: 7Optional

VLAN priority for PC Port.

interfacestring · enumOptional

The interface type for QR code or auto provisioning.
Can be neither:

WEB_DOMAIN:
PUBLIC_IPV4:
PUBLIC_IPV6:
PRIVATE_IPV4:
PRIVATE_IPV6:
SBC_DOMAIN:

Possible values:

preferred_transportstring · enumOptional

The transport protocol:
Can be either:

UDP:
TCP:
TLS:

Possible values:

serial_numberstringOptional

The serial number of phone.

door_password1string · min: 1 · max: 8Optional

The primary door password of phone. Only numeric sequences are allowed.

door_password2string · min: 1 · max: 8Optional

The secondary door password of phone. Only numeric sequences are allowed.

Responses

200

OK

No content

4XX

Error

post

/user/phones/{id}

POST /api/user/phones/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 525

{
  "password": null,
  "language": null,
  "transfer": null,
  "timezone": null,
  "ringtone": null,
  "queue_ringtone": null,
  "external_ringtone": null,
  "date_format": null,
  "time_format": null,
  "powerled": null,
  "backlight": null,
  "screensaver": null,
  "rps": null,
  "https": null,
  "codecs": null,
  "enable_lldp": null,
  "enable_vlan_wan_port": null,
  "wan_port_id": null,
  "wan_port_priority": null,
  "enable_vlan_pc_port": null,
  "pc_port_id": null,
  "pc_port_priority": null,
  "interface": null,
  "preferred_transport": null,
  "serial_number": null,
  "door_password1": null,
  "door_password2": null
}

No content

Remove a phone of current user

post

Remove a phone profile from current user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of phone.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

204

No Content

4XX

Error

post

/user/phones/{id}/destroy

POST /api/user/phones/{id}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

List user call detail records

get

Retrieve a collection of user call detail records.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

4XX

Error

get

/user/cdrs

GET /api/user/cdrs HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 1,
  "items": [
    {
      "id": null,
      "caller": null,
      "caller_domain": null,
      "caller_display_name": null,
      "callee": null,
      "callee_domain": null,
      "callee_display_name": null,
      "started_at": null,
      "rang_at": null,
      "answered_at": null,
      "ended_at": null,
      "call_id": null,
      "direction": null,
      "end_reason": null,
      "reroute_reason": null,
      "status_code": null,
      "destination": null,
      "outbound_caller_id": null,
      "did_cid": null,
      "trunk": null,
      "duration": null,
      "service_number": null,
      "user_data": null
    }
  ]
}

Retrieve user call detail record

get

Retrieve user call detail record.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of CDR.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/user/cdrs/{id}

GET /api/user/cdrs/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "caller": null,
      "caller_domain": null,
      "caller_display_name": null,
      "callee": null,
      "callee_domain": null,
      "callee_display_name": null,
      "started_at": null,
      "rang_at": null,
      "answered_at": null,
      "ended_at": null,
      "call_id": null,
      "direction": null,
      "end_reason": null,
      "reroute_reason": null,
      "status_code": null,
      "destination": null,
      "outbound_caller_id": null,
      "did_cid": null,
      "trunk": null,
      "cost": null,
      "billed_account": null,
      "service_number": null,
      "user_data": null
    }
  ]
}

Create new personal cdr sync token

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

date_fromstring · date_timeOptional

The start time sync token in RFC 3339 format, for example, 2017-07-21T17:32:28Z. The RFC 3339 format is defined by RFC 3339, section 5.6

Example: 2017-07-21T17:32:28Z

Responses

201

Created

application/json

4XX

Error

post

/user/cdrs/sync_tokens

POST /api/user/cdrs/sync_tokens HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "token": "xxxxxxxxxxxxx"
}

List personal cdr changes

post

List personal cdr changes.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

tokenstringRequired

The sync token.
Clients should treat the sync token as an opaque string and should never try to assemble it.
This document imposes no constraints on the format and clients should never impose any.

Example: RQ2dX9ZC7VuWlVpXXvad2dL3lyhjnN-7eOw95wXymoo.

Responses

200

OK

application/json

4XX

Error

post

/user/cdrs/sync_tokens/{token}/diff

POST /api/user/cdrs/sync_tokens/{token}/diff HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "token": "xxxxxxxxxxxxxxxx",
  "items": [
    {
      "id": {
        "change_type": {
          "items": [
            {
              "caller": null,
              "callee": null,
              "started_at": null,
              "answered_at": null,
              "ended_at": null,
              "outbound_caller_id": null,
              "did_cid": null,
              "trunk": null,
              "status_code": null
            }
          ]
        }
      }
    }
  ]
}

List user external messages

get

Retrieve a collection of user external messages.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

4XX

Error

get

/user/external_messages

GET /api/user/external_messages HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 1,
  "items": [
    {
      "id": null,
      "config_id": null,
      "sender": null,
      "sender_name": null,
      "receiver": null,
      "receiver_name": null,
      "channel_name": null,
      "channel_number": null,
      "brand": null,
      "did": null,
      "msg_type": null,
      "direction": null,
      "content": null,
      "reason": null,
      "delivery": null,
      "provider_msg_id": null,
      "created_at": null
    }
  ]
}

Retrieve user external message

get

Retrieve user external message.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of external message.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/user/external_messages/{id}

GET /api/user/external_messages/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": null,
  "config_id": null,
  "sender": null,
  "sender_name": null,
  "receiver": null,
  "receiver_name": null,
  "channel_name": null,
  "channel_number": null,
  "brand": null,
  "did": null,
  "msg_type": null,
  "direction": null,
  "content": null,
  "reason": null,
  "delivery": null,
  "provider_msg_id": null,
  "created_at": null
}

List user call recordings

get

Retrieve a collection of user call recordings.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

filterstringOptional

Use the filter query parameter to retrieve just a subset of a collection.

searchstringOptional

Use the search query parameter to restrict the results of a request to match a search criterion.

orderbystringOptional

Use the orderby query parameter to specify the sort order of the items returned from server.
The default order is ascending order.

skipinteger · int32Optional

Use the skip query parameter to set the number of items to skip at the start of a collection.

Default: 0

topinteger · int32 · min: 1 · max: 100Optional

Use the top query parameter to specify the page size of the result set.

Default: 100

Responses

200

OK

application/json

4XX

Error

get

/user/recordings

GET /api/user/recordings HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 1,
  "items": [
    {
      "id": null,
      "caller": null,
      "callee": null,
      "started_at": null,
      "ended_at": null
    }
  ]
}

Retrieve an user call recording

get

Get details of an user call recording.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRead-onlyRequired

The unique ID of call recording.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/user/recordings/{id}

GET /api/user/recordings/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": "1017775853607587840",
      "caller": "0001",
      "callee": "777",
      "started_at": "2025-09-09T12:37:56.263Z",
      "ended_at": "2025-09-09T12:38:17.573Z",
      "duration": 21,
      "file_name": "1017756506826735616_1017775853607587840_0001_777_09092025_203756.wav",
      "file_size": 341196,
      "file_url": "/api/blobs/iMXGGAns8sMlxoPcLMtmxwAAQD3X3R8O",
      "status": "TRANSCRIPTION_RUNNING",
      "status_description": "good goodgood",
      "sentiment": "SENTIMENT_NEUTRAL"
    },
    {
      "id": "1017775853607587841",
      "caller": "0001",
      "callee": "777",
      "started_at": "2025-09-08T12:37:56.263Z",
      "ended_at": "2025-09-08T12:38:17.573Z",
      "duration": 21,
      "file_name": "1017756506826735616_1017775853607587840_0001_777_09092025_203756.wav",
      "file_size": 3411886,
      "file_url": "/api/blobs/iMXGGAns8sMlxoPcLMtmxwAAQD3X3R8O",
      "status": "TRANSCRIPTION_RUNNING",
      "status_description": "good good good",
      "sentiment": "SENTIMENT_NEUTRAL"
    }
  ]
}

Delete user call recording

post

Delete an user call recording

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRead-onlyRequired

The unique ID of call recording.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

204

No Content

4XX

Error

post

/user/recordings/{id}/destroy

POST /api/user/recordings/{id}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Create AI Transcription

post

Creates an AI transcription record. The source is identified by the res_id and item_type provided in the request body. This endpoint can be called multiple times. If a previous transcription attempt has failed (status indicates failure), calling this endpoint again will retry the transcription process. The response may contain multiple IDs because a single call can include multiple recording files.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

res_idstringRequired

ID from a /voicemails or /recordings item used to create the transcription.

item_typestring · enumRequired

Type of the source item. Allowed values are CALL_RECORD or VOICE_MAIL.

Possible values:

Responses

200

Successfully created

application/json

400

Invalid parameters

500

Internal server error

post

/user/transcription

POST /api/user/transcription HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 63

{
  "res_id": "1017757975109963776",
  "item_type": "CALL_RECORD_ITEM"
}

{
  "ids": [
    "1017758181150949376"
  ]
}

Get AI Transcription Details

get

Retrieve all AI transcription records associated with a specific resource ID (id). The id comes from the id field of an item in either the /recordings or /voicemails list. A single resource may have multiple transcription or analysis results, so the response is returned as an array of transcription detail objects. Only records belonging to the current user are included in the response.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The resource ID from /recordings or /voicemails to retrieve transcription records for.

Responses

200

Transcription details retrieved successfully

application/json

404

Transcription not found

get

/user/transcription/{id}

GET /api/user/transcription/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "1015828562055266304",
    "tenant_id": "1015826085515886592",
    "item_id": "1015826629533896704",
    "file_id": "1015826629588418560",
    "session_id": "1015826576371093504",
    "type": "CALL_RECORD_ITEM",
    "transcription_id": "c40f915e-1fd0-4488-9afa-ad82c456449e",
    "analyze_id": "4968fe37-490f-4e03-b337-562ea5c02e5d",
    "status": "ANALYZE_SUCCEEDED",
    "status_description": "",
    "transcription_display": "{\n  \"transcript\": \"Welcome to the voicemail service. Please enter your password then press #.\",\n  \"audio_segments\": [\n    {\n      \"transcript\": \"Welcome to the voicemail service.\",\n      \"start_time\": 0.52,\n      \"end_time\": 2.44,\n      \"speaker\": \"spk_0\"\n    },\n    {\n      \"transcript\": \"Please enter your password then press #.\",\n      \"start_time\": 3.16,\n      \"end_time\": 5.56,\n      \"speaker\": \"spk_0\"\n    }\n  ]\n}\n",
    "intelligent_summary": "{\n  \"analyze\": [\n    \"Welcome to the voicemail service.\",\n    \"Please enter your password then press #.\"\n  ]\n}\n",
    "sentiment": 2,
    "created_at": "2025-09-04T11:40:02.376779Z",
    "caller": "0001",
    "callee": "777",
    "file_url": "/api/blobs/R1AW1C0XTpzJ5Bdh1jz4mQAAAALw8BgO"
  }
]

Update AI Transcription

post

Update transcription information for a specific transcription record. The id parameter refers to the primary key of the transcription.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The primary key ID of the transcription record to update.

Body

transcription_displaystringOptional

Transcription display content (JSON string).

intelligent_summarystringOptional

Intelligent summary content.

sentimentstring · enumOptional

AI transcription sentiment.

SentimentPositive
SentimentNeutral
SentimentNegative

Possible values:

Responses

200

Transcription updated successfully

No content

post

/user/transcription/{id}

POST /api/user/transcription/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1096

{
  "transcription_display": "{\n  \"transcript\": \"Thanks for calling. If you know the extension of the person you would like to reach, you may dial it at anytime.\",\n  \"audio_segments\": [\n    {\n      \"transcript\": \"Thanks for calling.\",\n      \"start_time\": 0.04,\n      \"end_time\": 1.04,\n      \"speaker\": \"spk_0\"\n    },\n    {\n      \"transcript\": \"If you know the extension of the person you would like to reach, you may dial it at anytime.\",\n      \"start_time\": 1.24,\n      \"end_time\": 5.48,\n      \"speaker\": \"spk_0\"\n    }\n  ]\n}\n",
  "intelligent_summary": "AnalyzeText Result : - {\"transcript\":\"Thanks for calling. - If you know the extension of the person you would like to reach, you may dial it at anytime.\", \"audio_segments\":[\n  {\"transcript\":\"Thanks for calling.\",\"start_time\":0.04,\"end_time\":1.04,\"speaker\":\"spk_0\"},\n  {\"transcript\":\"If you know the extension of the person you would like to reach, you may dial it at anytime.\",\"start_time\":1.24,\"end_time\":5.48,\"speaker\":\"spk_0\"}\n]}\n",
  "sentiment": "SENTIMENT_POSITIVE"
}

200

Transcription updated successfully

No content

List speed dial 8

get

List speed dial 8.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

4XX

Error

get

/user/speed_dial_8

GET /api/user/speed_dial_8 HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": null,
      "code": null,
      "phone_number": null,
      "description": null
    }
  ]
}

Add new speed dial 8

post

Create new speed dial 8.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

codestring · min: 1 · max: 1Required

The speed dial 8 dialing code.
Available code range from 2 to 9.

phone_numberstringRequired

The phone number that you want to call.

descriptionstring · max: 1024Optional

The description of speed dial.

Responses

201

Created

application/json

4XX

Error

post

/user/speed_dial_8

POST /api/user/speed_dial_8 HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 52

{
  "code": null,
  "phone_number": null,
  "description": null
}

{
  "id": "xxxxxxxx"
}

Retrieve details of speed dial 8

get

Retrieve details of speed dial 8 by it's ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of speed dial.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/user/speed_dial_8/{id}

GET /api/user/speed_dial_8/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": null,
  "code": null,
  "phone_number": null,
  "description": null
}

Update speed dial 8

post

Update speed dial 8.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of speed dial.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

codestring · min: 1 · max: 1Optional

The speed dial 8 dialing code.
Available code range from 2 to 9.

phone_numberstringOptional

The phone number that you want to call.

descriptionstring · max: 1024Optional

The description of speed dial.

Responses

200

OK

No content

4XX

Error

post

/user/speed_dial_8/{id}

POST /api/user/speed_dial_8/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 52

{
  "code": null,
  "phone_number": null,
  "description": null
}

No content

Delete speed dial 8

post

Remove speed dial 8 by ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of speed dial.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

204

No Content

4XX

Error

post

/user/speed_dial_8/{id}/destroy

POST /api/user/speed_dial_8/{id}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

List speed dial 100

get

List speed dial 100.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

4XX

Error

get

/user/speed_dial_100

GET /api/user/speed_dial_100 HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": null,
      "code": null,
      "phone_number": null,
      "description": null
    }
  ]
}

Add new speed dial 100

post

Create new speed dial 100.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

codestring · min: 2 · max: 2Required

The speed dial 100 dialing code.
Available code range from 00 to 99.

phone_numberstringRequired

The phone number that you want to call.

descriptionstring · max: 1024Optional

The description of speed dial.

Responses

201

Created

application/json

4XX

Error

post

/user/speed_dial_100

POST /api/user/speed_dial_100 HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 52

{
  "code": null,
  "phone_number": null,
  "description": null
}

{
  "id": "xxxxxxxx"
}

Retrieve details of speed dial 100

get

Retrieve details of speed dial 100 by it's ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of speed dial.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/user/speed_dial_100/{id}

GET /api/user/speed_dial_100/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": null,
  "code": null,
  "phone_number": null,
  "description": null
}

Update speed dial 100

post

Update speed dial 100.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of speed dial.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

codestring · min: 2 · max: 2Optional

The speed dial 100 dialing code.
Available code range from 00 to 99.

phone_numberstringOptional

The phone number that you want to call.

descriptionstring · max: 1024Optional

The description of speed dial.

Responses

200

OK

No content

4XX

Error

post

/user/speed_dial_100/{id}

POST /api/user/speed_dial_100/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 52

{
  "code": null,
  "phone_number": null,
  "description": null
}

No content

Delete speed dial 100

post

Remove speed dial 100 by ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of speed dial.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

204

No Content

4XX

Error

post

/user/speed_dial_100/{id}/destroy

POST /api/user/speed_dial_100/{id}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

List user meetings

get

Retrieve a collection of meetings.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

filterstringOptional

Use the filter query parameter to retrieve just a subset of a collection.

searchstringOptional

Use the search query parameter to restrict the results of a request to match a search criterion.

orderbystringOptional

Use the orderby query parameter to specify the sort order of the items returned from server.
The default order is ascending order.

skipinteger · int32Optional

Use the skip query parameter to set the number of items to skip at the start of a collection.

Default: 0

topinteger · int32 · min: 1 · max: 100Optional

Use the top query parameter to specify the page size of the result set.

Default: 100

Responses

200

OK

application/json

4XX

Error

get

/user/meetings

GET /api/user/meetings HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 1,
  "items": [
    {
      "id": null,
      "extension_number": null,
      "mode": null,
      "control": null,
      "height": null,
      "width": null,
      "bitrate": null,
      "framerate": null,
      "layout": null,
      "subject": null,
      "language": null,
      "capacity": null,
      "admin_pin": null,
      "room_pin": null,
      "enable_recording": null,
      "enable_prompt": null,
      "timezone": null,
      "created_at": null,
      "scheduled_start_at": null,
      "scheduled_end_at": null,
      "internal_invitees": null,
      "external_invitees": null,
      "close_on_nobody": null,
      "outbound_caller_ids": null,
      "ownership": null,
      "custom_options": null
    }
  ]
}

Create a Meeting

post

Create a meeting.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

modestring · enumRequired

The conference room mode.
Can be either:

AUDIO: audio conference room.
VIDEO: video conference room.

Possible values:

controlstring · enumOptional

The conference control type.
Can be either:

FREE: the free mode.
MASTER: the master mode.

Default: FREEPossible values:

heightinteger · int32 · min: 144 · max: 1920Optional

The height for video conference room.
Only valid in VIDEO mode.

Default: 720

widthinteger · int32 · min: 144 · max: 1920Optional

The width for video conference room.
Only valid in VIDEO mode.

Default: 1280

bitrateinteger · int32 · min: 128 · max: 10240Optional

The transmission rate for video conference room.
Only valid in VIDEO mode.

Default: 1024

framerateinteger · min: 5 · max: 30Optional

The framerate for video conference room.
Only valid in VIDEO mode.

Default: 15

layoutstring · enumOptional

The number of grids allowed for video conference room.
Only valid in VIDEO mode.
Can be either:

LAYOUT0:
LAYOUT1:
LAYOUT2:
LAYOUT3:
LAYOUT4:
LAYOUT6:
LAYOUT9:

Default: LAYOUT0Possible values:

subjectstring · min: 1 · max: 64Required

The subject of conference room.

languagestringOptional

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.

Example: en-US

admin_pinstring · min: 3 · max: 6Optional

The PIN for admin of the conference room. Only numeric sequences are allowed.

room_pinstring · min: 3 · max: 6Optional

The PIN for the conference room. Only numeric sequences are allowed.

enable_recordingbooleanOptional

Whether to enable recording when created.

Default: false

enable_promptbooleanOptional

Whether to enable voice menu.

Default: true

timezonestringRequired

The IANA Time Zone names, such as "Asia/Shanghai".

scheduled_start_atall ofOptional

The scheduled start time of meeting.

string · date_timeOptional

The RFC 3339 format is defined by The date_time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

Example: 2017-07-21T17:32:28Z

scheduled_end_atall ofOptional

The scheduled end time of meeting.

string · date_timeOptional

The RFC 3339 format is defined by The date_time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

Example: 2017-07-21T17:32:28Z

external_inviteesstringOptional

The invitees to send invitation emails to.

close_on_nobodybooleanOptional

Whether to close the meeting if the nobody in.

Default: false

custom_optionsstringOptional

Some custom configuration options serialized as json string

Responses

201

Created

application/json

4XX

Error

post

/user/meetings

POST /api/user/meetings HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 398

{
  "mode": null,
  "control": null,
  "height": null,
  "width": null,
  "bitrate": null,
  "framerate": null,
  "layout": null,
  "subject": null,
  "language": null,
  "admin_pin": null,
  "room_pin": null,
  "enable_recording": null,
  "enable_prompt": null,
  "timezone": null,
  "scheduled_start_at": null,
  "scheduled_end_at": null,
  "internal_invitees": null,
  "external_invitees": null,
  "close_on_nobody": null,
  "outbound_caller_ids": null,
  "custom_options": null
}

{
  "id": null,
  "extension_number": null
}

Retrieve a meeting

get

Retrieve a meeting.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of conference room.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/user/meetings/{id}

GET /api/user/meetings/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": null,
  "extension_number": null,
  "mode": null,
  "control": null,
  "height": null,
  "width": null,
  "bitrate": null,
  "framerate": null,
  "layout": null,
  "subject": null,
  "language": null,
  "capacity": null,
  "admin_pin": null,
  "room_pin": null,
  "enable_recording": null,
  "enable_prompt": null,
  "timezone": null,
  "created_at": null,
  "scheduled_start_at": null,
  "scheduled_end_at": null,
  "internal_invitees": null,
  "external_invitees": null,
  "close_on_nobody": null,
  "domain": null,
  "sbc_host": null,
  "sbc_port": null,
  "token": null,
  "outbound_caller_ids": null,
  "ownership": null,
  "custom_options": null
}

Update a meeting

post

Update a meeting

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of conference room.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

controlstring · enumOptional

The conference control type.
Can be either:

FREE: the free mode.
MASTER: the master mode.

Default: FREEPossible values:

heightinteger · int32 · min: 144 · max: 1920Optional

The height for video conference room.
Only valid in VIDEO mode.

Default: 720

widthinteger · int32 · min: 144 · max: 1920Optional

The width for video conference room.
Only valid in VIDEO mode.

Default: 1280

bitrateinteger · int32 · min: 128 · max: 10240Optional

The transmission rate for video conference room.
Only valid in VIDEO mode.

Default: 1024

framerateinteger · min: 5 · max: 30Optional

The framerate for video conference room.
Only valid in VIDEO mode.

Default: 15

layoutstring · enumOptional

The number of grids allowed for video conference room.
Only valid in VIDEO mode.
Can be either:

LAYOUT0:
LAYOUT1:
LAYOUT2:
LAYOUT3:
LAYOUT4:
LAYOUT6:
LAYOUT9:

Default: LAYOUT0Possible values:

subjectstring · min: 1 · max: 64Optional

The subject of conference room.

languagestringOptional

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.

Example: en-US

capacityinteger · int32 · min: 1 · max: 200Optional

The maximum number of participants allowed in the room.

Default: 9

admin_pinstring · min: 3 · max: 6Optional

The PIN for admin of the conference room. Only numeric sequences are allowed.

room_pinstring · min: 3 · max: 6Optional

The PIN for the conference room. Only numeric sequences are allowed.

enable_recordingbooleanOptional

Whether to enable recording when created.

Default: false

enable_promptbooleanOptional

Whether to enable voice menu.

Default: true

timezonestringOptional

The IANA Time Zone names, such as "Asia/Shanghai".

scheduled_start_atall ofOptional

The scheduled start time of meeting.

string · date_timeOptional

The RFC 3339 format is defined by The date_time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

Example: 2017-07-21T17:32:28Z

scheduled_end_atall ofOptional

The scheduled end time of meeting.

string · date_timeOptional

The RFC 3339 format is defined by The date_time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

Example: 2017-07-21T17:32:28Z

external_inviteesstringOptional

The invitees to send invitation emails to.

close_on_nobodybooleanOptional

Whether to close the meeting if the nobody in.

Default: false

custom_optionsstringOptional

Some custom configuration options serialized as json string

Responses

200

OK

No content

4XX

Error

post

/user/meetings/{id}

POST /api/user/meetings/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 402

{
  "control": null,
  "height": null,
  "width": null,
  "bitrate": null,
  "framerate": null,
  "layout": null,
  "subject": null,
  "language": null,
  "capacity": null,
  "admin_pin": null,
  "room_pin": null,
  "enable_recording": null,
  "enable_prompt": null,
  "timezone": null,
  "scheduled_start_at": null,
  "scheduled_end_at": null,
  "internal_invitees": null,
  "external_invitees": null,
  "close_on_nobody": null,
  "outbound_caller_ids": null,
  "custom_options": null
}

No content

Delete meeting

post

Destroy a conference room

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of conference room.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

204

No Content

400

Invalid username supplied

404

Not found

post

/user/meetings/{id}/destroy

POST /api/user/meetings/{id}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Get meeting status

get

Retrieve meeting status.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of conference room.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/user/meetings/{id}/status

GET /api/user/meetings/{id}/status HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "ONLINE",
  "locked": false,
  "muted": false,
  "recording": false
}

Mute meeting

post

Mute meeting.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of conference room.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

4XX

Error

post

/user/meetings/{id}/mute

POST /api/user/meetings/{id}/mute HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Unmute meeting

post

Unmute meeting by it's unique ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of conference room.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

4XX

Error

post

/user/meetings/{id}/unmute

POST /api/user/meetings/{id}/unmute HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Lock meeting

post

Lock meeting by it's unique ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of conference room.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

4XX

Error

post

/user/meetings/{id}/lock

POST /api/user/meetings/{id}/lock HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Unlock meeting

post

Unlock meeting by it's unique ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of conference room.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

4XX

Error

post

/user/meetings/{id}/unlock

POST /api/user/meetings/{id}/unlock HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Start meeting

post

Start meeting by it's unique ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of conference room.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

4XX

Error

post

/user/meetings/{id}/start

POST /api/user/meetings/{id}/start HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Stop meeting

post

Stop meeting by it's unique ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of conference room.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

4XX

Error

post

/user/meetings/{id}/stop

POST /api/user/meetings/{id}/stop HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Start recording in meeting

post

Start recording in meeting.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of conference room.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

4XX

Error

post

/user/meetings/{id}/start_recording

POST /api/user/meetings/{id}/start_recording HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Stop recording in meeting

post

Stop recording in meeting.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of conference room.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

4XX

Error

post

/user/meetings/{id}/stop_recording

POST /api/user/meetings/{id}/stop_recording HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

List meeting participants

get

Retrieve a collection of meeting participants.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of conference room.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/user/meetings/{id}/participants

GET /api/user/meetings/{id}/participants HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": null,
      "display_name": null,
      "muted": null,
      "chairman": null,
      "position": null
    }
  ]
}

Update meeting participants layout

post

Modify participants layout based on meeting layout.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of conference room.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

Responses

200

OK

No content

4XX

Error

post

/user/meetings/{id}/participants/layout

POST /api/user/meetings/{id}/participants/layout HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "items": [
    "xxx",
    "yyy"
  ]
}

No content

Get meeting participant details

get

Get meeting participant details.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of conference room.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

participant_idall ofRequired

The unique ID of conference room participant.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/user/meetings/{id}/participants/{participant_id}

GET /api/user/meetings/{id}/participants/{participant_id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": null,
  "display_name": null,
  "muted": null,
  "chairman": null,
  "position": null
}

Invite meeting participant

post

Invite an user as meeting participant.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of conference room.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

numberstringOptional

The number of invited participant.

Responses

200

OK

No content

4XX

Error

post

/user/meetings/{id}/participants/invite

POST /api/user/meetings/{id}/participants/invite HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "number": "111-222-33333"
}

No content

Mute meeting participant

post

Mute meeting participant.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of conference room.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

participant_idall ofRequired

The unique ID of conference room participant.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

4XX

Error

post

/user/meetings/{id}/participants/{participant_id}/mute

POST /api/user/meetings/{id}/participants/{participant_id}/mute HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Unmute meeting participant

post

Unmute meeting participant.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of conference room.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

participant_idall ofRequired

The unique ID of conference room participant.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

4XX

Error

post

/user/meetings/{id}/participants/{participant_id}/unmute

POST /api/user/meetings/{id}/participants/{participant_id}/unmute HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Transfer meeting ownership

post

Transfer meeting ownership to another participant.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of conference room.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

participant_idall ofRequired

The unique ID of conference room participant.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

4XX

Error

post

/user/meetings/{id}/participants/{participant_id}/chairman

POST /api/user/meetings/{id}/participants/{participant_id}/chairman HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Set meeting participant position

post

Set meeting participant position.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of conference room.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

participant_idall ofRequired

The unique ID of conference room participant.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

positioninteger · int32 · min: -1 · max: 8Optional

The position of room member.
The member will not be displayed when -1 is specified.

Responses

200

OK

No content

4XX

Error

post

/user/meetings/{id}/participants/{participant_id}/position

POST /api/user/meetings/{id}/participants/{participant_id}/position HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 14

{
  "position": 1
}

No content

Kick out meeting participant

post

Kick out meeting participant.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of conference room.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

participant_idall ofRequired

The unique ID of conference room participant.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

204

No Content

4XX

Error

post

/user/meetings/{id}/participants/{participant_id}/destroy

POST /api/user/meetings/{id}/participants/{participant_id}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

List current user's holidays

get

Retrieve a collection of current user's holidays.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

4XX

Error

get

/user/holidays

GET /api/user/holidays HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 1,
  "items": [
    {
      "id": null,
      "name": null,
      "region": null,
      "consecutive": null,
      "every_year": null,
      "year_start": null,
      "year_end": null,
      "month_start": null,
      "month_end": null,
      "day_start": null,
      "day_end": null,
      "hour_start": null,
      "hour_end": null,
      "minute_start": null,
      "minute_end": null
    }
  ]
}

Create a new holiday for current user

post

Create a new holiday for current user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

namestring · min: 1 · max: 64Required

The name of the holiday.

regionstringRequired

A valid country code based on iso3166-1 alpha-3 standard. see: https://www.iso.org/iso-3166-country-codes.html

consecutivebooleanRequired

Whether the holiday consists of consecutive days.

every_yearbooleanRequired

Does the holiday take effect every year.

year_startintegerOptional

The start year of holiday.

year_endintegerOptional

The end year of holiday.

month_startintegerOptional

The start month of holiday.

month_endintegerOptional

The end month of holiday.

day_startintegerOptional

The start day of holiday.

day_endintegerOptional

The end day of holiday.

hour_startintegerOptional

The start hour of holiday.

hour_endintegerOptional

The end hour of holiday.

minute_startintegerOptional

The start minute of holiday.

minute_endintegerOptional

The end minute of holiday.

Responses

201

Created

application/json

4XX

Error

post

/user/holidays

POST /api/user/holidays HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 238

{
  "name": null,
  "region": null,
  "consecutive": null,
  "every_year": null,
  "year_start": null,
  "year_end": null,
  "month_start": null,
  "month_end": null,
  "day_start": null,
  "day_end": null,
  "hour_start": null,
  "hour_end": null,
  "minute_start": null,
  "minute_end": null
}

{
  "id": "xxxxxxxx"
}

Retrieve a holiday of current user

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRead-onlyRequired

The unique ID of holiday.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/user/holidays/{id}

GET /api/user/holidays/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": null,
  "name": null,
  "region": null,
  "consecutive": null,
  "every_year": null,
  "year_start": null,
  "year_end": null,
  "month_start": null,
  "month_end": null,
  "day_start": null,
  "day_end": null,
  "hour_start": null,
  "hour_end": null,
  "minute_start": null,
  "minute_end": null
}

Update a holiday of current user

post

Update a holiday of current user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRead-onlyRequired

The unique ID of holiday.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

namestring · min: 1 · max: 64Required

The name of the holiday.

regionstringOptional

A valid country code based on iso3166-1 alpha-3 standard. see: https://www.iso.org/iso-3166-country-codes.html

consecutivebooleanRequired

Whether the holiday consists of consecutive days.

every_yearbooleanRequired

Does the holiday take effect every year.

year_startintegerOptional

The start year of holiday.

year_endintegerOptional

The end year of holiday.

month_startintegerOptional

The start month of holiday.

month_endintegerOptional

The end month of holiday.

day_startintegerOptional

The start day of holiday.

day_endintegerOptional

The end day of holiday.

hour_startintegerOptional

The start hour of holiday.

hour_endintegerOptional

The end hour of holiday.

minute_startintegerOptional

The start minute of holiday.

minute_endintegerOptional

The end minute of holiday.

Responses

200

OK

No content

4XX

Error

post

/user/holidays/{id}

POST /api/user/holidays/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 238

{
  "name": null,
  "region": null,
  "consecutive": null,
  "every_year": null,
  "year_start": null,
  "year_end": null,
  "month_start": null,
  "month_end": null,
  "day_start": null,
  "day_end": null,
  "hour_start": null,
  "hour_end": null,
  "minute_start": null,
  "minute_end": null
}

No content

Destroy a holiday of current user

post

Destroy a holiday of current user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRead-onlyRequired

The unique ID of holiday.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

204

No Content

400

Invalid ID supplied.

post

/user/holidays/{id}/destroy

POST /api/user/holidays/{id}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

List current user's global holidays

get

Retrieve a collection of current user's global holidays.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

4XX

Error

get

/user/global_holidays

GET /api/user/global_holidays HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": null,
      "name": null,
      "region": null,
      "consecutive": null,
      "every_year": null,
      "year_start": null,
      "year_end": null,
      "month_start": null,
      "month_end": null,
      "day_start": null,
      "day_end": null,
      "hour_start": null,
      "hour_end": null,
      "minute_start": null,
      "minute_end": null
    }
  ]
}

Update current user's global holidays

post

Update current user's global holidays from tenant holidays.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

Responses

200

OK

No content

4XX

Error

post

/user/global_holidays

POST /api/user/global_holidays HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "items": [
    "xxxxxxxxx",
    "yyyyyyyyy"
  ]
}

No content

List personal contact

get

Retrieve a collection of personal contacts.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

skipinteger · int32Optional

Use the skip query parameter to set the number of items to skip at the start of a collection.

Default: 0

topinteger · int32 · min: 1 · max: 100Optional

Use the top query parameter to specify the page size of the result set.

Default: 100

Responses

200

OK

application/json

4XX

Error

get

/user/contacts

GET /api/user/contacts HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 1,
  "items": [
    {
      "id": null,
      "name": null,
      "email": null,
      "company": null,
      "title": null,
      "business": null,
      "business2": null,
      "mobile_phone": null,
      "mobile_phone2": null,
      "home_phone": null,
      "home_phone2": null,
      "other": null,
      "business_fax": null,
      "home_fax": null,
      "address": null,
      "notes": null,
      "sync_type": null,
      "favorite": null
    }
  ]
}

Add a new personal contact

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

namestring · min: 1 · max: 64Optional

The name of contact.

emailstring · max: 128Optional

The email of contact.

companystring · max: 128Optional

The company name of contact.

titlestring · max: 128Optional

The title of contact.

businessstring · max: 128Optional

The business phone number of contact.

business2string · max: 128Optional

The secondary business phone number of contact.

mobile_phonestring · max: 128Optional

The mobile phone number of contact.

mobile_phone2string · max: 128Optional

The secondary mobile phone number of contact.

home_phonestring · max: 128Optional

The home phone number of contact.

home_phone2string · max: 128Optional

The secondary home phone number of contact.

otherstring · max: 128Optional

The other phone number of contact.

business_faxstring · max: 128Optional

The business fax of contact.

home_faxstring · max: 128Optional

The home fax of contact.

addressstring · max: 128Optional

The address.

notesstring · max: 1024Optional

The notes of contact.

Responses

201

Created contact

application/json

4XX

Error

post

/user/contacts

POST /api/user/contacts HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 242

{
  "name": null,
  "email": null,
  "company": null,
  "title": null,
  "business": null,
  "business2": null,
  "mobile_phone": null,
  "mobile_phone2": null,
  "home_phone": null,
  "home_phone2": null,
  "other": null,
  "business_fax": null,
  "home_fax": null,
  "address": null,
  "notes": null
}

{
  "id": "xxxxxxxx"
}

Retrieve personal contact details

get

Retrieves details of a personal contact.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of contact.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/user/contacts/{id}

GET /api/user/contacts/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": null,
  "name": null,
  "email": null,
  "company": null,
  "title": null,
  "business": null,
  "business2": null,
  "mobile_phone": null,
  "mobile_phone2": null,
  "home_phone": null,
  "home_phone2": null,
  "other": null,
  "business_fax": null,
  "home_fax": null,
  "address": null,
  "notes": null,
  "sync_type": null,
  "favorite": null
}

Update a personal contact

post

Update a personal contact.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of contact.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

namestring · min: 1 · max: 64Optional

The name of contact.

emailstring · max: 128Optional

The email of contact.

companystring · max: 128Optional

The company name of contact.

titlestring · max: 128Optional

The title of contact.

businessstring · max: 128Optional

The business phone number of contact.

business2string · max: 128Optional

The secondary business phone number of contact.

mobile_phonestring · max: 128Optional

The mobile phone number of contact.

mobile_phone2string · max: 128Optional

The secondary mobile phone number of contact.

home_phonestring · max: 128Optional

The home phone number of contact.

home_phone2string · max: 128Optional

The secondary home phone number of contact.

otherstring · max: 128Optional

The other phone number of contact.

business_faxstring · max: 128Optional

The business fax of contact.

home_faxstring · max: 128Optional

The home fax of contact.

addressstring · max: 128Optional

The address.

notesstring · max: 1024Optional

The notes of contact.

Responses

200

OK

No content

4XX

Error

post

/user/contacts/{id}

POST /api/user/contacts/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 242

{
  "name": null,
  "email": null,
  "company": null,
  "title": null,
  "business": null,
  "business2": null,
  "mobile_phone": null,
  "mobile_phone2": null,
  "home_phone": null,
  "home_phone2": null,
  "other": null,
  "business_fax": null,
  "home_fax": null,
  "address": null,
  "notes": null
}

No content

Favorite a personal contact

post

Favorite a personal contact.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of contact.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

4XX

Error

post

/user/contacts/{id}/favorite

POST /api/user/contacts/{id}/favorite HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Unfavorite a personal contact

post

Favorite a personal contact.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of contact.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

4XX

Error

post

/user/contacts/{id}/unfavorite

POST /api/user/contacts/{id}/unfavorite HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Delete a personal contact

post

Delete a personal contact by it's unique id.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of contact.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

204

No Content

4XX

Error

post

/user/contacts/{id}/destroy

POST /api/user/contacts/{id}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Create new personal contact sync token

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

201

Created

application/json

4XX

Error

post

/user/contacts/sync_tokens

POST /api/user/contacts/sync_tokens HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "token": "xxxxxxxxxxxxxxxx"
}

List personal contact changes

post

List personal contact changes.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

tokenstringRequired

The sync token.
Clients should treat the sync token as an opaque string and should never try to assemble it.
This document imposes no constraints on the format and clients should never impose any.

Example: RQ2dX9ZC7VuWlVpXXvad2dL3lyhjnN-7eOw95wXymoo.

Responses

200

OK

application/json

4XX

Error

post

/user/contacts/sync_tokens/{token}/diff

POST /api/user/contacts/sync_tokens/{token}/diff HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "token": "xxxxxxxxxxxxxxx",
  "items": [
    {
      "id": null,
      "name": null,
      "email": null,
      "company": null,
      "title": null,
      "business": null,
      "business2": null,
      "mobile_phone": null,
      "mobile_phone2": null,
      "home_phone": null,
      "home_phone2": null,
      "other": null,
      "business_fax": null,
      "home_fax": null,
      "address": null,
      "notes": null,
      "favorite": null,
      "change_type": null
    }
  ]
}

Favorite a business contact

post

Favorite a business contact.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of contact.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

4XX

Error

post

/user/business_contacts/{id}/favorite

POST /api/user/business_contacts/{id}/favorite HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Unfavorite a business contact

post

Favorite a business contact.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of contact.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

4XX

Error

post

/user/business_contacts/{id}/unfavorite

POST /api/user/business_contacts/{id}/unfavorite HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Create a business contact sync token

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

201

Created

application/json

4XX

Error

post

/user/business_contacts/sync_tokens

POST /api/user/business_contacts/sync_tokens HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "token": "xxxxxxxxxxxxxxxxx"
}

List business contact changes

post

List business contact changes.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

tokenstringRequired

The sync token.
Clients should treat the sync token as an opaque string and should never try to assemble it.
This document imposes no constraints on the format and clients should never impose any.

Example: RQ2dX9ZC7VuWlVpXXvad2dL3lyhjnN-7eOw95wXymoo.

Responses

200

OK

application/json

4XX

Error

post

/user/business_contacts/sync_tokens/{token}/diff

POST /api/user/business_contacts/sync_tokens/{token}/diff HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "token": "xxxxxxxxxxxxxxxxxx",
  "items": [
    {
      "id": null,
      "name": null,
      "email": null,
      "company": null,
      "title": null,
      "business": null,
      "business2": null,
      "mobile_phone": null,
      "mobile_phone2": null,
      "home_phone": null,
      "home_phone2": null,
      "other": null,
      "business_fax": null,
      "home_fax": null,
      "address": null,
      "notes": null,
      "favorite": null,
      "change_type": null
    }
  ]
}

Favorite an extension contact

post

Favorite an extension contact.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of contact.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

4XX

Error

post

/user/extension_contacts/{id}/favorite

POST /api/user/extension_contacts/{id}/favorite HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Unfavorite an extension contact

post

Favorite an extension contact.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of contact.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

4XX

Error

post

/user/extension_contacts/{id}/unfavorite

POST /api/user/extension_contacts/{id}/unfavorite HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Create a extension contact sync token

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

201

Created

application/json

4XX

Error

post

/user/extension_contacts/sync_tokens

POST /api/user/extension_contacts/sync_tokens HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "token": "xxxxxxxxxxxxxxx"
}

List extension contact changes

post

List extension contact changes.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

tokenstringRequired

The sync token.
Clients should treat the sync token as an opaque string and should never try to assemble it.
This document imposes no constraints on the format and clients should never impose any.

Example: RQ2dX9ZC7VuWlVpXXvad2dL3lyhjnN-7eOw95wXymoo.

Responses

200

OK

application/json

4XX

Error

post

/user/extension_contacts/sync_tokens/{token}/diff

POST /api/user/extension_contacts/sync_tokens/{token}/diff HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "token": "xxxxxxxxxxxxxxxx",
  "items": [
    {
      "id": null,
      "display_name": null,
      "email": null,
      "mobile_phone": null,
      "work_phone": null,
      "home_phone": null,
      "address": null,
      "department": null,
      "avatar_file_url": null,
      "extension_number": null,
      "favorite": null,
      "change_type": null
    }
  ]
}

Favorite a CRM contact

post

Favorite a CRM contact.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of contact.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

4XX

Error

post

/user/crm_contacts/{id}/favorite

POST /api/user/crm_contacts/{id}/favorite HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Unfavorite a CRM contact

post

Favorite a CRM contact.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of contact.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

4XX

Error

post

/user/crm_contacts/{id}/unfavorite

POST /api/user/crm_contacts/{id}/unfavorite HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Create a CRM contact sync token

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

201

Created

application/json

4XX

Error

post

/user/crm_contacts/sync_tokens

POST /api/user/crm_contacts/sync_tokens HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "token": "xxxxxxxxxxxxxxxxx"
}

List CRM contact changes

post

List CRM contact changes.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

tokenstringRequired

The sync token.
Clients should treat the sync token as an opaque string and should never try to assemble it.
This document imposes no constraints on the format and clients should never impose any.

Example: RQ2dX9ZC7VuWlVpXXvad2dL3lyhjnN-7eOw95wXymoo.

Responses

200

OK

application/json

4XX

Error

post

/user/crm_contacts/sync_tokens/{token}/diff

POST /api/user/crm_contacts/sync_tokens/{token}/diff HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "token": "xxxxxxxxxxxxxxxxxx",
  "items": [
    {
      "id": null,
      "first_name": null,
      "last_name": null,
      "email": null,
      "company": null,
      "title": null,
      "business": null,
      "business2": null,
      "mobile_phone": null,
      "mobile_phone2": null,
      "home_phone": null,
      "home_phone2": null,
      "other": null,
      "business_fax": null,
      "home_fax": null,
      "address": null,
      "notes": null,
      "favorite": null,
      "type": "Contact",
      "url": null,
      "change_type": null
    }
  ]
}

Retrieve the call queues which current user belongs

get

Retrieve the call queues which current user belongs.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

4XX

Error

get

/user/call_queues

GET /api/user/call_queues HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": null,
      "name": null,
      "extension_number": null
    }
  ]
}

Retrieve call queue agent

get

Retrieve information of call queue agent.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of call queue.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/user/call_queues/{id}/agent

GET /api/user/call_queues/{id}/agent HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "extension_number": null,
  "display_name": null,
  "skill_level": null,
  "status": null
}

Set call queue agent status

post

Set call queue agent status.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of call queue.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

statusstring · enumOptional

Change call queue agent status to one of the following:

READY:
NOT_READY:
WRAP_UP:
LOGGED_IN:
LOGGED_OUT:

Example: READYPossible values:

reasonstringOptional

The reason for changing a call queue agent's status.
Standard presets include:

NOT_RAEDY
LUNCH
BUSINESS_TRIP
DO_NOT_DISTURB
AWAY
You can also provide a custom string for a custom reason.
Note: This field is only effective when setting status to NOT_READY.
For other statuses, this field will be ignored.
The reason field is optional and can be left empty.

Example: NOT_RAEDY

Responses

200

OK

No content

4XX

Error

post

/user/call_queues/{id}/agent

POST /api/user/call_queues/{id}/agent HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 42

{
  "status": "NOT_READY",
  "reason": "At lunch"
}

No content

Retrieve a collection of outbound caller ids

get

Retrieve a collection of outbound caller ids.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

4XX

Error

get

/user/outbound_caller_ids

GET /api/user/outbound_caller_ids HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "provider_id": null,
      "caller_id": null,
      "description": null
    }
  ]
}

Retrieve the ring groups which current user belongs

get

Retrieve the ring groups which current user belongs.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

4XX

Error

get

/user/ring_groups

GET /api/user/ring_groups HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": null,
      "name": null,
      "extension_number": null
    }
  ]
}

List call sessions

get

Retrieve a collection current user call sessions.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

4XX

Error

get

/user/sessions

GET /api/user/sessions HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 1,
  "items": [
    {
      "id": null,
      "calls": [
        {
          "caller": null,
          "caller_display_name": null,
          "callee": null,
          "trunk": null,
          "started_at": null,
          "talking_time": null
        }
      ]
    }
  ]
}

List users

get

List a collection of users.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

filterstringOptional

Use the filter query parameter to retrieve just a subset of a collection.

searchstringOptional

Use the search query parameter to restrict the results of a request to match a search criterion.

orderbystringOptional

Use the orderby query parameter to specify the sort order of the items returned from server.
The default order is ascending order.

skipinteger · int32Optional

Use the skip query parameter to set the number of items to skip at the start of a collection.

Default: 0

topinteger · int32 · min: 1 · max: 100Optional

Use the top query parameter to specify the page size of the result set.

Default: 100

Responses

200

OK

application/json

4XX

Error

get

/users

GET /api/users HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 1,
  "items": [
    {
      "id": null,
      "name": null,
      "enabled": null,
      "email": null,
      "display_name": null,
      "role_id": null,
      "role_name": null,
      "mobile_phone": null,
      "work_phone": null,
      "home_phone": null,
      "address": null,
      "department": null,
      "extension_number": null,
      "created_at": null,
      "avatar_file_name": null,
      "avatar_file_size": null,
      "avatar_file_url": null,
      "provider": null,
      "provider_id": null,
      "sync_type": null
    }
  ]
}

Create a user

post

Create a new user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

namestring · min: 1 · max: 64Required

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.

passwordstringRequired

The password of user.

emailall ofRequired

The email address of user.

string · max: 128Optional

The email address.

Example: [email protected]

display_namestring · max: 1024Required

The display name of user.

enabledbooleanOptional

Allows temporarily disabling the extension.

Default: true

rolestring · min: 1 · max: 64Required

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.
OperationsAdmin: the operations administrator.
SiteAdmin: the site administrator.
Dealer: the sales manager has all sold tenant resource permissions.
Admin: 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.

Example: User

mobile_phonestring · max: 32Optional

The mobile phone number of user.

work_phonestring · max: 32Optional

The office phone number of user.

home_phonestring · max: 32Optional

The home phone number of user.

addressstring · max: 128Optional

The address.

departmentstring · max: 128Optional

The department of user.

extension_numberstring · min: 3 · max: 64Required

The extension number.

Pattern: [0-9]{3,64}

extension_passwordstringRequired

The extension password.

enable_audio_recordingbooleanOptional

Records all calls and saves audio recordings on server.

Default: false

enable_video_recordingbooleanOptional

Records all calls and saves video recordings on server.

Default: false

enable_dndbooleanOptional

Enable Do Not Disturb or not.

enable_acbbooleanOptional

Enable Automatic Callback or not.

enable_hot_deskingbooleanOptional

Enable hot desking feature or not.

Default: false

anonymous_outbound_callsbooleanOptional

Always make outbound anonymous calls or not.

Default: false

smsstring · enumOptional

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.

Default: DISABLEPossible values:

delivery_outbound_cidbooleanOptional

Always delivery outbound caller ID or not.

Default: true

custom_optionsstringOptional

Some custom configuration options serialized as json string

voicemail_promptstringOptional

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.

Example: en-US

enable_voicemail_pinbooleanOptional

Whether the PIN is required to access voice mail of extension.

Default: true

voicemail_pinstringRequired

The PIN number for accessing.

enable_voicemail_notifybooleanOptional

Enable voicemail to email notify.

Default: false

voicemail_play_datetimestring · enumOptional

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.

Possible values:

interfacestring · enumOptional

The interface type for QR code or auto provisioning.
Can be neither:

WEB_DOMAIN:
PUBLIC_IPV4:
PUBLIC_IPV6:
PRIVATE_IPV4:
PRIVATE_IPV6:
SBC_DOMAIN:

Possible values:

preferred_transportstring · enumOptional

The transport protocol:
Can be either:

UDP:
TCP:
TLS:

Possible values:

enable_ai_transcriptbooleanOptional

Enable ai transcript or not.

enable_uc_appbooleanOptional

Enable user-agent of app or not.

enable_teams_phone_appbooleanOptional

Enable enable teams phone app or not.

Responses

201

Created

application/json

4XX

Error

post

/users

POST /api/users HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1952

{
  "name": null,
  "password": null,
  "email": null,
  "display_name": null,
  "enabled": null,
  "role": null,
  "mobile_phone": null,
  "work_phone": null,
  "home_phone": null,
  "address": null,
  "department": null,
  "extension_number": null,
  "extension_password": null,
  "enable_audio_recording": null,
  "enable_video_recording": null,
  "enable_dnd": null,
  "enable_acb": null,
  "enable_hot_desking": null,
  "anonymous_outbound_calls": null,
  "sms": null,
  "delivery_outbound_cid": null,
  "outbound_caller_ids": null,
  "custom_options": null,
  "office_hours": null,
  "available_office_hours_forward_rule": null,
  "available_non_office_hours_forward_rule": null,
  "available_no_answer_forward_rule": null,
  "busy_office_hours_forward_rule": null,
  "busy_non_office_hours_forward_rule": null,
  "busy_no_answer_forward_rule": null,
  "dnd_office_hours_forward_rule": null,
  "dnd_non_office_hours_forward_rule": null,
  "away_office_hours_forward_rule": null,
  "away_non_office_hours_forward_rule": null,
  "lunch_office_hours_forward_rule": null,
  "lunch_non_office_hours_forward_rule": null,
  "trip_office_hours_forward_rule": null,
  "trip_non_office_hours_forward_rule": null,
  "offline_office_hours_forward_rule": null,
  "offline_non_office_hours_forward_rule": null,
  "custom_forward_rules": null,
  "voicemail_prompt": null,
  "enable_voicemail_pin": null,
  "voicemail_pin": null,
  "enable_voicemail_notify": null,
  "voicemail_play_datetime": null,
  "interface": null,
  "preferred_transport": null,
  "blfs": null,
  "phones": [
    {
      "mac": null,
      "filename": null,
      "vendor": null,
      "model": null,
      "password": null,
      "language": null,
      "transfer": null,
      "timezone": null,
      "ringtone": null,
      "queue_ringtone": null,
      "external_ringtone": null,
      "date_format": null,
      "time_format": null,
      "powerled": null,
      "backlight": null,
      "screensaver": null,
      "rps": null,
      "https": null,
      "codecs": null,
      "enable_lldp": null,
      "enable_vlan_wan_port": null,
      "wan_port_id": null,
      "wan_port_priority": null,
      "enable_vlan_pc_port": null,
      "pc_port_id": null,
      "pc_port_priority": null,
      "interface": null,
      "preferred_transport": null,
      "serial_number": null,
      "door_password1": null,
      "door_password2": null
    }
  ]
}

{
  "id": "xxxxxxxx"
}

Bulk create users

post

Bulk create users.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

Responses

200

Created

application/json

4XX

Error

post

/users/create_many

POST /api/users/create_many HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1964

{
  "items": [
    {
      "name": null,
      "password": null,
      "email": null,
      "display_name": null,
      "enabled": null,
      "role": null,
      "mobile_phone": null,
      "work_phone": null,
      "home_phone": null,
      "address": null,
      "department": null,
      "extension_number": null,
      "extension_password": null,
      "enable_audio_recording": null,
      "enable_video_recording": null,
      "enable_dnd": null,
      "enable_acb": null,
      "enable_hot_desking": null,
      "anonymous_outbound_calls": null,
      "sms": null,
      "delivery_outbound_cid": null,
      "outbound_caller_ids": null,
      "custom_options": null,
      "office_hours": null,
      "available_office_hours_forward_rule": null,
      "available_non_office_hours_forward_rule": null,
      "available_no_answer_forward_rule": null,
      "busy_office_hours_forward_rule": null,
      "busy_non_office_hours_forward_rule": null,
      "busy_no_answer_forward_rule": null,
      "dnd_office_hours_forward_rule": null,
      "dnd_non_office_hours_forward_rule": null,
      "away_office_hours_forward_rule": null,
      "away_non_office_hours_forward_rule": null,
      "lunch_office_hours_forward_rule": null,
      "lunch_non_office_hours_forward_rule": null,
      "trip_office_hours_forward_rule": null,
      "trip_non_office_hours_forward_rule": null,
      "offline_office_hours_forward_rule": null,
      "offline_non_office_hours_forward_rule": null,
      "custom_forward_rules": null,
      "voicemail_prompt": null,
      "enable_voicemail_pin": null,
      "voicemail_pin": null,
      "enable_voicemail_notify": null,
      "voicemail_play_datetime": null,
      "interface": null,
      "preferred_transport": null,
      "blfs": null,
      "phones": [
        {
          "mac": null,
          "filename": null,
          "vendor": null,
          "model": null,
          "password": null,
          "language": null,
          "transfer": null,
          "timezone": null,
          "ringtone": null,
          "queue_ringtone": null,
          "external_ringtone": null,
          "date_format": null,
          "time_format": null,
          "powerled": null,
          "backlight": null,
          "screensaver": null,
          "rps": null,
          "https": null,
          "codecs": null,
          "enable_lldp": null,
          "enable_vlan_wan_port": null,
          "wan_port_id": null,
          "wan_port_priority": null,
          "enable_vlan_pc_port": null,
          "pc_port_id": null,
          "pc_port_priority": null,
          "interface": null,
          "preferred_transport": null,
          "serial_number": null,
          "door_password1": null,
          "door_password2": null
        }
      ]
    }
  ]
}

{
  "items": [
    "xxx",
    "yyy"
  ]
}

Reset all user profiles

post

Reset the active user profile with the specified ID, or reset all active user profiles when id is not specified.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

idall ofOptional

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

4XX

Error

post

/users/profile

POST /api/users/profile HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Bulk retrieve user current status

post

Bulk retrieve users status.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

Responses

200

OK

application/json

4XX

Error

post

/users/status/get_many

POST /api/users/status/get_many HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "items": [
    "xxx",
    "yyy"
  ]
}

{
  "items": [
    {
      "status": null,
      "presence": null,
      "presence_note": null,
      "registration": null,
      "enable_dnd": null,
      "enable_acb": null
    }
  ]
}

Retrieve a user

get

Retrieves the settings of a user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/users/{id}

GET /api/users/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": null,
  "name": null,
  "email": null,
  "display_name": null,
  "role": null,
  "enabled": null,
  "mobile_phone": null,
  "work_phone": null,
  "home_phone": null,
  "address": null,
  "department": null,
  "extension_number": null,
  "enable_audio_recording": null,
  "enable_video_recording": null,
  "enable_dnd": null,
  "enable_acb": null,
  "enable_hot_desking": null,
  "anonymous_outbound_calls": null,
  "delivery_outbound_cid": null,
  "sms": null,
  "outbound_caller_ids": null,
  "custom_options": null,
  "office_hours": null,
  "available_office_hours_forward_rule": null,
  "available_non_office_hours_forward_rule": null,
  "available_no_answer_forward_rule": null,
  "busy_office_hours_forward_rule": null,
  "busy_non_office_hours_forward_rule": null,
  "busy_no_answer_forward_rule": null,
  "dnd_office_hours_forward_rule": null,
  "dnd_non_office_hours_forward_rule": null,
  "away_office_hours_forward_rule": null,
  "away_non_office_hours_forward_rule": null,
  "lunch_office_hours_forward_rule": null,
  "lunch_non_office_hours_forward_rule": null,
  "trip_office_hours_forward_rule": null,
  "trip_non_office_hours_forward_rule": null,
  "offline_office_hours_forward_rule": null,
  "offline_non_office_hours_forward_rule": null,
  "custom_forward_rules": null,
  "voicemail_prompt": null,
  "enable_voicemail_pin": null,
  "voicemail_pin": null,
  "enable_voicemail_notify": null,
  "voicemail_play_datetime": null,
  "interface": null,
  "preferred_transport": null,
  "blfs": null,
  "profile": null,
  "created_at": null,
  "avatar_file_name": null,
  "avatar_file_size": null,
  "avatar_file_url": null,
  "provider": null,
  "provider_id": null,
  "sync_type": null
}

Update a user

post

Modify the settings of a user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

emailall ofOptional

The email address of user.

string · max: 128Optional

The email address.

Example: [email protected]

display_namestring · max: 1024Optional

The display name of user.

enabledbooleanOptional

Allows temporarily disabling the extension.

Default: true

mobile_phonestring · max: 32Optional

The mobile phone number of user.

work_phonestring · max: 32Optional

The office phone number of user.

home_phonestring · max: 32Optional

The home phone number of user.

addressstring · max: 128Optional

The address.

departmentstring · max: 128Optional

The department of user.

enable_audio_recordingbooleanOptional

Records all calls and saves audio recordings on server.

Default: false

enable_video_recordingbooleanOptional

Records all calls and saves video recordings on server.

Default: false

enable_dndbooleanOptional

Enable Do Not Disturb or not.

enable_acbbooleanOptional

Enable Automatic Callback or not.

enable_hot_deskingbooleanOptional

Enable hot desking feature or not.

Default: false

anonymous_outbound_callsbooleanOptional

Always make outbound anonymous calls or not.

Default: false

delivery_outbound_cidbooleanOptional

Always delivery outbound caller ID or not.

Default: true

smsstring · enumOptional

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.

Default: DISABLEPossible values:

custom_optionsstringOptional

Some custom configuration options serialized as json string

voicemail_promptstringOptional

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.

Example: en-US

enable_voicemail_pinbooleanOptional

Whether the PIN is required to access voice mail of extension.

Default: true

voicemail_pinstringOptional

The PIN number for accessing.

enable_voicemail_notifybooleanOptional

Enable voicemail to email notify.

Default: false

voicemail_play_datetimestring · enumOptional

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.

Possible values:

interfacestring · enumOptional

The interface type for QR code or auto provisioning.
Can be neither:

WEB_DOMAIN:
PUBLIC_IPV4:
PUBLIC_IPV6:
PRIVATE_IPV4:
PRIVATE_IPV6:
SBC_DOMAIN:

Possible values:

preferred_transportstring · enumOptional

The transport protocol:
Can be either:

UDP:
TCP:
TLS:

Possible values:

enable_ai_transcriptbooleanOptional

Enable ai transcript or not.

enable_uc_appbooleanOptional

Enable user-agent of app or not.

enable_teams_phone_appbooleanOptional

Enable enable teams phone app or not.

Responses

200

OK

No content

4XX

Error

post

/users/{id}

POST /api/users/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1271

{
  "email": null,
  "display_name": null,
  "enabled": null,
  "mobile_phone": null,
  "work_phone": null,
  "home_phone": null,
  "address": null,
  "department": null,
  "enable_audio_recording": null,
  "enable_video_recording": null,
  "enable_dnd": null,
  "enable_acb": null,
  "enable_hot_desking": null,
  "anonymous_outbound_calls": null,
  "delivery_outbound_cid": null,
  "sms": null,
  "outbound_caller_ids": null,
  "custom_options": null,
  "office_hours": null,
  "available_office_hours_forward_rule": null,
  "available_non_office_hours_forward_rule": null,
  "available_no_answer_forward_rule": null,
  "busy_office_hours_forward_rule": null,
  "busy_non_office_hours_forward_rule": null,
  "busy_no_answer_forward_rule": null,
  "dnd_office_hours_forward_rule": null,
  "dnd_non_office_hours_forward_rule": null,
  "away_office_hours_forward_rule": null,
  "away_non_office_hours_forward_rule": null,
  "lunch_office_hours_forward_rule": null,
  "lunch_non_office_hours_forward_rule": null,
  "trip_office_hours_forward_rule": null,
  "trip_non_office_hours_forward_rule": null,
  "offline_office_hours_forward_rule": null,
  "offline_non_office_hours_forward_rule": null,
  "custom_forward_rules": null,
  "voicemail_prompt": null,
  "enable_voicemail_pin": null,
  "voicemail_pin": null,
  "enable_voicemail_notify": null,
  "voicemail_play_datetime": null,
  "interface": null,
  "preferred_transport": null,
  "blfs": null
}

No content

Reset user password

post

Reset user password.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

passwordstringOptional

The password of user.

Responses

200

OK

No content

4XX

Error

post

/users/{id}/password

POST /api/users/{id}/password HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "password": null
}

No content

Reset user extension password

post

Reset user extension password.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

passwordstringOptional

The extension password.

Responses

200

OK

No content

4XX

Error

post

/users/{id}/extension_password

POST /api/users/{id}/extension_password HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "password": null
}

No content

Change user role

post

Change user role.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

rolestring · min: 1 · max: 64Optional

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.
OperationsAdmin: the operations administrator.
SiteAdmin: the site administrator.
Dealer: the sales manager has all sold tenant resource permissions.
Admin: 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.

Example: User

Responses

200

OK

No content

4XX

Error

post

/users/{id}/role

POST /api/users/{id}/role HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 13

{
  "role": null
}

No content

Reset user profile

post

Reset user profile.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

4XX

Error

post

/users/{id}/profile

POST /api/users/{id}/profile HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Bind user to ms365 account

post

Bind user to ms365 account.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

idstringOptional

The OID or Principal Name of Microsoft 365 user.

Responses

200

OK

No content

4XX

Error

post

/users/{id}/ms365_binding

POST /api/users/{id}/ms365_binding HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "id": "2f3863dc-021b-41e6-ad55-2a36044336b0"
}

No content

Unbind user from ms365 account

post

Unbind user from ms365 account.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

204

No Content

4XX

Error

post

/users/{id}/ms365_binding/destroy

POST /api/users/{id}/ms365_binding/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Delete a user

post

Delete a certain user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

204

No Content

4XX

Error

post

/users/{id}/destroy

POST /api/users/{id}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Retrieves user current status

get

Retrieves current status of given user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/users/{id}/status

GET /api/users/{id}/status HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": null,
  "presence": null,
  "presence_note": null,
  "registration": null,
  "enable_dnd": null,
  "enable_acb": null
}

Delete user registration

post

Delete user registration.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

instance_idstringRequired

The instance ID of registration.

Responses

204

No Content

4XX

Error

post

/users/{id}/status/{instance_id}/destroy_status

POST /api/users/{id}/status/{instance_id}/destroy_status HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Retrieve balance

get

Retrieve extension's balance by it's unique ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/users/{id}/balance

GET /api/users/{id}/balance HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "balance": 100
}

Update balance

post

Update extension's balance

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

balancenumber · doubleOptional

User balance. Precision is five digits.

Responses

200

OK

No content

4XX

Error

post

/users/{id}/balance

POST /api/users/{id}/balance HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "balance": 100
}

No content

List voicemail greetings

get

Retrieves a collection of greetings available to certain user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/users/{id}/greetings

GET /api/users/{id}/greetings HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": null,
      "enabled": null,
      "file_name": null,
      "file_size": null,
      "file_url": null
    }
  ]
}

Create voicemail greeting

post

Create a voicemail greeting for user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

file_idall ofOptional

The unique ID of the file.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

201

OK

application/json

4XX

Error

post

/users/{id}/greetings

POST /api/users/{id}/greetings HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "file_id": "xxxxxxxxxxxx"
}

{
  "id": "xxxxxxxx"
}

Enable greeting

post

Set a voicemail greeting activated.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

greeting_idall ofRequired

The unique ID of greeting.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

400

Invalid extension number supplied

404

User not found

post

/users/{id}/greetings/{greeting_id}/enable

POST /api/users/{id}/greetings/{greeting_id}/enable HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Disable greeting

post

Disable user voicemail greeting.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

greeting_idall ofRequired

The unique ID of greeting.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

No content

400

Invalid extension number supplied

404

User not found

post

/users/{id}/greetings/{greeting_id}/disable

POST /api/users/{id}/greetings/{greeting_id}/disable HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Delete voicemail greeting

post

Destroy a voicemail greeting from user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

greeting_idall ofRequired

The unique ID of greeting.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

204

No Content

4XX

Error

post

/users/{id}/greetings/{greeting_id}/destroy

POST /api/users/{id}/greetings/{greeting_id}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

List user's IP phones

get

Retrieve a collection of IP Phones.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/users/{id}/phones

GET /api/users/{id}/phones HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": null,
      "mac": null,
      "filename": null,
      "vendor": null,
      "model": null,
      "password": null,
      "language": null,
      "transfer": null,
      "timezone": null,
      "ringtone": null,
      "queue_ringtone": null,
      "external_ringtone": null,
      "date_format": null,
      "time_format": null,
      "powerled": null,
      "backlight": null,
      "screensaver": null,
      "rps": null,
      "https": null,
      "codecs": null,
      "enable_lldp": null,
      "enable_vlan_wan_port": null,
      "wan_port_id": null,
      "wan_port_priority": null,
      "enable_vlan_pc_port": null,
      "pc_port_id": null,
      "pc_port_priority": null,
      "interface": null,
      "preferred_transport": null,
      "serial_number": null,
      "door_password1": null,
      "door_password2": null,
      "url": null
    }
  ]
}

Assign phone to user

post

Assign a phone to user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

macall ofRequired

MAC address of this IP phone.

stringOptional

MAC address.

filenamestringRequired

Template XML file name for phone provisioning.

vendorstringRequired

The phone vendor of IP phone.

modelstringRequired

The name of IP phone model.

passwordstringRequired

Password for accessing the Web interface of phone. The username remains default because most phone manufacturers do not allow modification of the user name. This is supported for some phone model, such as "Snom 300".

languagestring · enumRequired

Language for strings displayed on Phone Display LCD. Supported languages include ENGLISH, CHINESE, DUTCH, FRENCH, GERMAN, GREEK, ITALIAN, JAPANESE, POLISH, RUSSIAN, SPANISH, SWEDISH, UKRAINIAN, and BULGARIAN.

Possible values:

transferstring · enumRequired

The transfer method for auto provision.
Can be either:

BLIND: After the IP phone is configured with the BLF of a certain key, during a call on the IP phone, press the key, and the phone will directly initiate a Blind transfer to the configured number.
ATTENDED: After the IP phone is configured with the BLF of a key, during a call on the IP phone, press the key, and the phone will directly initiate an Attended transfer to the configured number.
NEW_CALL: After the IP phone is configured with the BLF of a certain key, during a call on the IP phone, press the key, and the phone will initiate a new call to the configured number.

Default: BLINDPossible values:

timezonestringRequired

The timezone of phone.

ringtonestringOptional

The ringtone of phone.

queue_ringtonestringOptional

The queue ringtone of phone for queue calls or ring group calls.

external_ringtonestringOptional

The ringtone of phone for external calls.

date_formatstringOptional

The date format of phone.

time_formatstringOptional

The time format of phone.

powerledstringOptional

The power led of phone.

backlightstringOptional

The backlight of phone.

screensaverstringOptional

The screensaver of phone.

rpsbooleanOptional

Send to RPS or not.

httpsbooleanOptional

Whether to use https

codecsstring[]Required

The list of currently enabled codec formats.

all_codecsstring[]Required

The list of all supported codec formats.

enable_lldpbooleanOptional

Enable or disable Link Layer Discovery Protocol.

Default: false

enable_vlan_wan_portbooleanOptional

Enable or disable VLAN for WAN Port.

Default: false

wan_port_idinteger · min: 1 · max: 4094Optional

VLAN ID for WAN PORT.

wan_port_priorityinteger · max: 7Optional

VLAN priority for WAN Port.

enable_vlan_pc_portbooleanOptional

Enable or disable VLAN for PC Port.

Default: false

pc_port_idinteger · min: 1 · max: 4094Optional

VLAN ID for PC PORT.

pc_port_priorityinteger · max: 7Optional

VLAN priority for PC Port.

interfacestring · enumRequired

The interface type for QR code or auto provisioning.
Can be neither:

WEB_DOMAIN:
PUBLIC_IPV4:
PUBLIC_IPV6:
PRIVATE_IPV4:
PRIVATE_IPV6:
SBC_DOMAIN:

Possible values:

preferred_transportstring · enumRequired

The transport protocol:
Can be either:

UDP:
TCP:
TLS:

Possible values:

serial_numberstringOptional

The serial number of phone.

door_password1string · min: 1 · max: 8Optional

The primary door password of phone. Only numeric sequences are allowed.

door_password2string · min: 1 · max: 8Optional

The secondary door password of phone. Only numeric sequences are allowed.

Responses

201

Success

application/json

4XX

Error

post

/users/{id}/phones

POST /api/users/{id}/phones HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 579

{
  "mac": null,
  "filename": null,
  "vendor": null,
  "model": null,
  "password": null,
  "language": null,
  "transfer": null,
  "timezone": null,
  "ringtone": null,
  "queue_ringtone": null,
  "external_ringtone": null,
  "date_format": null,
  "time_format": null,
  "powerled": null,
  "backlight": null,
  "screensaver": null,
  "rps": null,
  "https": null,
  "codecs": null,
  "enable_lldp": null,
  "enable_vlan_wan_port": null,
  "wan_port_id": null,
  "wan_port_priority": null,
  "enable_vlan_pc_port": null,
  "pc_port_id": null,
  "pc_port_priority": null,
  "interface": null,
  "preferred_transport": null,
  "serial_number": null,
  "door_password1": null,
  "door_password2": null
}

{
  "id": "xxxxxxxx"
}

Retrieve user phone details

get

Retrieve phone details of user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

phone_idall ofRequired

The unique ID of phone.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/users/{id}/phones/{phone_id}

GET /api/users/{id}/phones/{phone_id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": null,
  "mac": null,
  "filename": null,
  "vendor": null,
  "model": null,
  "password": null,
  "language": null,
  "transfer": null,
  "timezone": null,
  "ringtone": null,
  "queue_ringtone": null,
  "external_ringtone": null,
  "date_format": null,
  "time_format": null,
  "powerled": null,
  "backlight": null,
  "screensaver": null,
  "rps": null,
  "https": null,
  "codecs": null,
  "enable_lldp": null,
  "enable_vlan_wan_port": null,
  "wan_port_id": null,
  "wan_port_priority": null,
  "enable_vlan_pc_port": null,
  "pc_port_id": null,
  "pc_port_priority": null,
  "interface": null,
  "preferred_transport": null,
  "serial_number": null,
  "door_password1": null,
  "door_password2": null,
  "url": null
}

Update a phone of user

post

Update phone of user by it's unique ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

phone_idall ofRequired

The unique ID of phone.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

passwordstringOptional

Password for accessing the Web interface of phone. The username remains default because most phone manufacturers do not allow modification of the user name. This is supported for some phone model, such as "Snom 300".

languagestring · enumOptional

Language for strings displayed on Phone Display LCD. Supported languages include ENGLISH, CHINESE, DUTCH, FRENCH, GERMAN, GREEK, ITALIAN, JAPANESE, POLISH, RUSSIAN, SPANISH, SWEDISH, UKRAINIAN, and BULGARIAN.

Possible values:

transferstring · enumOptional

The transfer method for auto provision.
Can be either:

BLIND: After the IP phone is configured with the BLF of a certain key, during a call on the IP phone, press the key, and the phone will directly initiate a Blind transfer to the configured number.
ATTENDED: After the IP phone is configured with the BLF of a key, during a call on the IP phone, press the key, and the phone will directly initiate an Attended transfer to the configured number.
NEW_CALL: After the IP phone is configured with the BLF of a certain key, during a call on the IP phone, press the key, and the phone will initiate a new call to the configured number.

Default: BLINDPossible values:

timezonestringOptional

The timezone of phone.

ringtonestringOptional

The ringtone of phone.

queue_ringtonestringOptional

The queue ringtone of phone for queue calls or ring group calls.

external_ringtonestringOptional

The ringtone of phone for external calls.

date_formatstringOptional

The date format of phone.

time_formatstringOptional

The time format of phone.

powerledstringOptional

The power led of phone.

backlightstringOptional

The backlight of phone.

screensaverstringOptional

The screensaver of phone.

rpsbooleanOptional

Send to RPS or not.

httpsbooleanOptional

Whether to use https

codecsstring[]Optional

The list of currently enabled codec formats.

enable_lldpbooleanOptional

Enable or disable Link Layer Discovery Protocol.

Default: false

enable_vlan_wan_portbooleanOptional

Enable or disable VLAN for WAN Port.

Default: false

wan_port_idinteger · min: 1 · max: 4094Optional

VLAN ID for WAN PORT.

wan_port_priorityinteger · max: 7Optional

VLAN priority for WAN Port.

enable_vlan_pc_portbooleanOptional

Enable or disable VLAN for PC Port.

Default: false

pc_port_idinteger · min: 1 · max: 4094Optional

VLAN ID for PC PORT.

pc_port_priorityinteger · max: 7Optional

VLAN priority for PC Port.

interfacestring · enumOptional

The interface type for QR code or auto provisioning.
Can be neither:

WEB_DOMAIN:
PUBLIC_IPV4:
PUBLIC_IPV6:
PRIVATE_IPV4:
PRIVATE_IPV6:
SBC_DOMAIN:

Possible values:

preferred_transportstring · enumOptional

The transport protocol:
Can be either:

UDP:
TCP:
TLS:

Possible values:

serial_numberstringOptional

The serial number of phone.

door_password1string · min: 1 · max: 8Optional

The primary door password of phone. Only numeric sequences are allowed.

door_password2string · min: 1 · max: 8Optional

The secondary door password of phone. Only numeric sequences are allowed.

Responses

200

OK

No content

4XX

Error

post

/users/{id}/phones/{phone_id}

POST /api/users/{id}/phones/{phone_id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 525

{
  "password": null,
  "language": null,
  "transfer": null,
  "timezone": null,
  "ringtone": null,
  "queue_ringtone": null,
  "external_ringtone": null,
  "date_format": null,
  "time_format": null,
  "powerled": null,
  "backlight": null,
  "screensaver": null,
  "rps": null,
  "https": null,
  "codecs": null,
  "enable_lldp": null,
  "enable_vlan_wan_port": null,
  "wan_port_id": null,
  "wan_port_priority": null,
  "enable_vlan_pc_port": null,
  "pc_port_id": null,
  "pc_port_priority": null,
  "interface": null,
  "preferred_transport": null,
  "serial_number": null,
  "door_password1": null,
  "door_password2": null
}

No content

Remove a user phone

post

Unassign a phone from extension.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

phone_idall ofRequired

The unique ID of phone.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

204

No Content

4XX

Error

post

/users/{id}/phones/{phone_id}/destroy

POST /api/users/{id}/phones/{phone_id}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

List user's holidays

get

Retrieve a collection of user's holidays.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/users/{id}/holidays

GET /api/users/{id}/holidays HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 1,
  "items": [
    {
      "id": null,
      "name": null,
      "region": null,
      "consecutive": null,
      "every_year": null,
      "year_start": null,
      "year_end": null,
      "month_start": null,
      "month_end": null,
      "day_start": null,
      "day_end": null,
      "hour_start": null,
      "hour_end": null,
      "minute_start": null,
      "minute_end": null
    }
  ]
}

Create a new holiday for user

post

Create a new holiday for a user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

namestring · min: 1 · max: 64Required

The name of the holiday.

regionstringRequired

A valid country code based on iso3166-1 alpha-3 standard. see: https://www.iso.org/iso-3166-country-codes.html

consecutivebooleanRequired

Whether the holiday consists of consecutive days.

every_yearbooleanRequired

Does the holiday take effect every year.

year_startintegerOptional

The start year of holiday.

year_endintegerOptional

The end year of holiday.

month_startintegerOptional

The start month of holiday.

month_endintegerOptional

The end month of holiday.

day_startintegerOptional

The start day of holiday.

day_endintegerOptional

The end day of holiday.

hour_startintegerOptional

The start hour of holiday.

hour_endintegerOptional

The end hour of holiday.

minute_startintegerOptional

The start minute of holiday.

minute_endintegerOptional

The end minute of holiday.

Responses

201

Created

application/json

4XX

Error

post

/users/{id}/holidays

POST /api/users/{id}/holidays HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 238

{
  "name": null,
  "region": null,
  "consecutive": null,
  "every_year": null,
  "year_start": null,
  "year_end": null,
  "month_start": null,
  "month_end": null,
  "day_start": null,
  "day_end": null,
  "hour_start": null,
  "hour_end": null,
  "minute_start": null,
  "minute_end": null
}

{
  "id": "xxxxxxxx"
}

Retrieve a holiday of a user

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRead-onlyRequired

The unique ID of holiday.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

holiday_idall ofRead-onlyRequired

The unique ID of holiday.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/users/{id}/holidays/{holiday_id}

GET /api/users/{id}/holidays/{holiday_id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": null,
  "name": null,
  "region": null,
  "consecutive": null,
  "every_year": null,
  "year_start": null,
  "year_end": null,
  "month_start": null,
  "month_end": null,
  "day_start": null,
  "day_end": null,
  "hour_start": null,
  "hour_end": null,
  "minute_start": null,
  "minute_end": null
}

Update a holiday for a user

post

Update a holiday that already exists.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRead-onlyRequired

The unique ID of holiday.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

holiday_idall ofRead-onlyRequired

The unique ID of holiday.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

namestring · min: 1 · max: 64Required

The name of the holiday.

regionstringOptional

A valid country code based on iso3166-1 alpha-3 standard. see: https://www.iso.org/iso-3166-country-codes.html

consecutivebooleanRequired

Whether the holiday consists of consecutive days.

every_yearbooleanRequired

Does the holiday take effect every year.

year_startintegerOptional

The start year of holiday.

year_endintegerOptional

The end year of holiday.

month_startintegerOptional

The start month of holiday.

month_endintegerOptional

The end month of holiday.

day_startintegerOptional

The start day of holiday.

day_endintegerOptional

The end day of holiday.

hour_startintegerOptional

The start hour of holiday.

hour_endintegerOptional

The end hour of holiday.

minute_startintegerOptional

The start minute of holiday.

minute_endintegerOptional

The end minute of holiday.

Responses

200

OK

No content

4XX

Error

post

/users/{id}/holidays/{holiday_id}

POST /api/users/{id}/holidays/{holiday_id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 238

{
  "name": null,
  "region": null,
  "consecutive": null,
  "every_year": null,
  "year_start": null,
  "year_end": null,
  "month_start": null,
  "month_end": null,
  "day_start": null,
  "day_end": null,
  "hour_start": null,
  "hour_end": null,
  "minute_start": null,
  "minute_end": null
}

No content

Destroy a holiday of user

post

Destroy a holiday of user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRead-onlyRequired

The unique ID of holiday.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

holiday_idall ofRead-onlyRequired

The unique ID of holiday.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

204

No Content

400

Invalid ID supplied.

post

/users/{id}/holidays/{holiday_id}/destroy

POST /api/users/{id}/holidays/{holiday_id}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

List user's global holidays

get

Retrieve a collection of global holidays.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/users/{id}/global_holidays

GET /api/users/{id}/global_holidays HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": null,
      "name": null,
      "region": null,
      "consecutive": null,
      "every_year": null,
      "year_start": null,
      "year_end": null,
      "month_start": null,
      "month_end": null,
      "day_start": null,
      "day_end": null,
      "hour_start": null,
      "hour_end": null,
      "minute_start": null,
      "minute_end": null
    }
  ]
}

Update user's global holidays

post

Update global holidays from tenant holidays.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

Responses

200

OK

No content

4XX

Error

post

/users/{id}/global_holidays

POST /api/users/{id}/global_holidays HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "items": [
    "xxx",
    "yyy"
  ]
}

No content

Retrieve the call queues which the user belongs

get

Retrieve the call queues which the user belongs.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/users/{id}/call_queues

GET /api/users/{id}/call_queues HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": null,
      "name": null,
      "extension_number": null
    }
  ]
}

Retrieve call queue agent

get

Retrieve information of call queue agent.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

queue_idall ofRequired

The unique ID of call queue.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/users/{id}/call_queues/{queue_id}/agent

GET /api/users/{id}/call_queues/{queue_id}/agent HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "extension_number": null,
  "display_name": null,
  "skill_level": null,
  "status": null
}

Set call queue agent status

post

Set call queue agent status.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

queue_idall ofRequired

The unique ID of call queue.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

statusstring · enumOptional

Change call queue agent status to one of the following:

READY:
NOT_READY:
WRAP_UP:
LOGGED_IN:
LOGGED_OUT:

Example: READYPossible values:

Responses

200

OK

No content

4XX

Error

post

/users/{id}/call_queues/{queue_id}/agent

POST /api/users/{id}/call_queues/{queue_id}/agent HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "status": "READY"
}

No content

List speed dial 8

get

List speed dial 8.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/users/{id}/speed_dial_8

GET /api/users/{id}/speed_dial_8 HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": null,
      "code": null,
      "phone_number": null,
      "description": null
    }
  ]
}

Add new speed dial 8

post

Create new speed dial 8.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

codestring · min: 1 · max: 1Required

The speed dial 8 dialing code.
Available code range from 2 to 9.

phone_numberstringRequired

The phone number that you want to call.

descriptionstring · max: 1024Optional

The description of speed dial.

Responses

201

Created

application/json

4XX

Error

post

/users/{id}/speed_dial_8

POST /api/users/{id}/speed_dial_8 HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 52

{
  "code": null,
  "phone_number": null,
  "description": null
}

{
  "id": "xxxxxxxx"
}

Retrieve details of speed dial 8

get

Retrieve details of speed dial 8 by it's ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

dial_idall ofRequired

The unique ID of speed dial.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/users/{id}/speed_dial_8/{dial_id}

GET /api/users/{id}/speed_dial_8/{dial_id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": null,
  "code": null,
  "phone_number": null,
  "description": null
}

Update speed dial 8

post

Update speed dial 8.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

dial_idall ofRequired

The unique ID of speed dial.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

codestring · min: 1 · max: 1Optional

The speed dial 8 dialing code.
Available code range from 2 to 9.

phone_numberstringOptional

The phone number that you want to call.

descriptionstring · max: 1024Optional

The description of speed dial.

Responses

200

OK

No content

4XX

Error

post

/users/{id}/speed_dial_8/{dial_id}

POST /api/users/{id}/speed_dial_8/{dial_id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 52

{
  "code": null,
  "phone_number": null,
  "description": null
}

No content

Delete speed dial 8

post

Remove speed dial 8 by ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

dial_idall ofRequired

The unique ID of speed dial.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

204

No Content

4XX

Error

post

/users/{id}/speed_dial_8/{dial_id}/destroy

POST /api/users/{id}/speed_dial_8/{dial_id}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

List speed dial 100

get

List speed dial 100.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/users/{id}/speed_dial_100

GET /api/users/{id}/speed_dial_100 HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": null,
      "code": null,
      "phone_number": null,
      "description": null
    }
  ]
}

Add new speed dial 100

post

Create new speed dial 100.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

codestring · min: 2 · max: 2Required

The speed dial 100 dialing code.
Available code range from 00 to 99.

phone_numberstringRequired

The phone number that you want to call.

descriptionstring · max: 1024Optional

The description of speed dial.

Responses

201

Created

application/json

4XX

Error

post

/users/{id}/speed_dial_100

POST /api/users/{id}/speed_dial_100 HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 52

{
  "code": null,
  "phone_number": null,
  "description": null
}

{
  "id": "xxxxxxxx"
}

Retrieve details of speed dial 100

get

Retrieve details of speed dial 100 by it's ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

dial_idall ofRequired

The unique ID of speed dial.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/users/{id}/speed_dial_100/{dial_id}

GET /api/users/{id}/speed_dial_100/{dial_id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": null,
  "code": null,
  "phone_number": null,
  "description": null
}

Update speed dial 100

post

Update speed dial 100.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

dial_idall ofRequired

The unique ID of speed dial.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

codestring · min: 2 · max: 2Optional

The speed dial 100 dialing code.
Available code range from 00 to 99.

phone_numberstringOptional

The phone number that you want to call.

descriptionstring · max: 1024Optional

The description of speed dial.

Responses

200

OK

No content

4XX

Error

post

/users/{id}/speed_dial_100/{dial_id}

POST /api/users/{id}/speed_dial_100/{dial_id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 52

{
  "code": null,
  "phone_number": null,
  "description": null
}

No content

Delete speed dial 100

post

Remove speed dial 100 by ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

dial_idall ofRequired

The unique ID of speed dial.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

204

No Content

4XX

Error

post

/users/{id}/speed_dial_100/{dial_id}/destroy

POST /api/users/{id}/speed_dial_100/{dial_id}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

List user groups

get

Get a collection of user groups.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

filterstringOptional

Use the filter query parameter to retrieve just a subset of a collection.

searchstringOptional

Use the search query parameter to restrict the results of a request to match a search criterion.

orderbystringOptional

Use the orderby query parameter to specify the sort order of the items returned from server.
The default order is ascending order.

skipinteger · int32Optional

Use the skip query parameter to set the number of items to skip at the start of a collection.

Default: 0

topinteger · int32 · min: 1 · max: 100Optional

Use the top query parameter to specify the page size of the result set.

Default: 100

Responses

200

OK

application/json

4XX

Error

get

/groups

GET /api/groups HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 1,
  "items": [
    {
      "id": null,
      "name": null,
      "description": null
    }
  ]
}

Create an user group

post

Create a new user group.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

namestring · min: 1 · max: 64Optional

The name of user group.

descriptionstring · max: 1024Optional

The description of user group.

Responses

201

Created user group

application/json

4XX

Error

post

/groups

POST /api/groups HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "name": null,
  "outbound_caller_ids": null,
  "description": null
}

{
  "id": "xxxxxxxx"
}

Retrieve an user group

get

Retrieves the properties of an user group.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user group.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/groups/{id}

GET /api/groups/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": null,
  "name": null,
  "outbound_caller_ids": null,
  "description": null
}

Update an user group.

post

Update an user group

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user group.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

namestring · min: 1 · max: 64Optional

The name of user group.

descriptionstring · max: 1024Optional

The description of user group.

Responses

200

OK

No content

4XX

Error

post

/groups/{id}

POST /api/groups/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "name": null,
  "outbound_caller_ids": null,
  "description": null
}

No content

Delete an user group

post

Delete a certain user group.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user group.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

204

No Content

400

Invalid user number supplied

404

User not found

post

/groups/{id}/destroy

POST /api/groups/{id}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

List user group members

get

Retrieve a collection of user group members.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user group.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/groups/{id}/members

GET /api/groups/{id}/members HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": null,
      "name": null,
      "display_name": null,
      "extension_number": null
    }
  ]
}

Check user group member

get

Check if extension is in user group.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user group.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

extension_numberstring · min: 3 · max: 64Required

The extension number.

Pattern: [0-9]{3,64}

Responses

200

OK

application/json

404

Not Found

get

/groups/{id}/members/{extension_number}

GET /api/groups/{id}/members/{extension_number} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": null,
  "name": null,
  "display_name": null,
  "extension_number": null
}

Add user group member

post

Add user member into group.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user group.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

extension_numberstring · min: 3 · max: 64Required

The extension number.

Pattern: [0-9]{3,64}

Responses

200

OK

No content

4XX

Error

post

/groups/{id}/members/{extension_number}

POST /api/groups/{id}/members/{extension_number} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Delete group member

post

Delete an user group member.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idall ofRequired

The unique ID of user group.

stringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

extension_numberstring · min: 3 · max: 64Required

The extension number.

Pattern: [0-9]{3,64}

Responses

204

No Content

4XX

Error

post

/groups/{id}/members/{extension_number}/destroy

POST /api/groups/{id}/members/{extension_number}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content