update conference room main_screen

POST /room/main_screen/update
update conference room main_screen
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

Request body
application/json
  • id

    integer

    required

  • participant_extension

    string

    required

    Extension for conference room. NOTE: It MUST be a non-existent extension.

Sample Request

                      curl -v -X POST http://127.0.0.1:8990/api/conference/room/main_screen/update \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \
                          -d '{
    "id": 1234
}'
                      
                    

Responses

200
update conference room main_screen

Sample Response

                      
                      
                    

Update conference room

POST /room/update
Update conference room
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

Request body
application/json
  • resolution

    string

    required

    The video resolution for video conference room.
  • bitrate

    integer

    required

    The transmission rate for video conference room. Values: 128 ~ 2048 (it MUST be an integer).
  • recording

    boolean

    required

    recording or stop recording .
  • room_pin

    string

    required

    PIN for the conference room.
  • unattended

    boolean

    required

    Cancellation of interactive voice .
  • locked

    boolean

    required

    locked or unlocked .
  • admin_pin

    string

    required

    PIN for admin of the conference room.
  • layout

    integer

    required

    The number of grids allowed for video conference room. Values : 1, 2, 3, 4, 6 or 9.
  • max_participants

    integer

    required

    The maximum number of participants allowed in the room.
  • outbound_caller_id

    string

    required

    outbound_caller_id of conference room.
  • id

    integer

    required

  • framerate

    integer

    required

    The framerate for video conference room.

    minimum: 5

    maximum: 30

  • language

    string

    required

    Language for prompt in the conference room.
  • muted

    boolean

    required

    muted or unmuted .
  • subject

    string

    required

    Subject of conference room.

Sample Request

                      curl -v -X POST http://127.0.0.1:8990/api/conference/room/update \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \
                          -d '{
    "id": 1234
}'
                      
                    

Responses

200
Updated tenant object

Sample Response

                      
                      
                    

Retrieve a collection of conference room participants

GET /room/participants/list
Retrieve a collection of conference room participants
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

  • id

    integer

    required

    The ID of conference room.

Sample Request

                      curl -v -X GET http://127.0.0.1:8990/api/conference/room/participants/list \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \
                      
                    

Responses

200
Successful operation
application/json
  • --

    object

    Show child attributes

Sample Response

                      
{
    "id": 1234
}
                      
                    

update conference room participant

POST /room/participants/update
update conference room participant
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

Request body
application/json
  • id

    integer

    required

  • op

    string

    required

  • participant_extension

    string

    required

    Extension for conference room. NOTE: It MUST be a non-existent extension.

Sample Request

                      curl -v -X POST http://127.0.0.1:8990/api/conference/room/participants/update \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \
                          -d '{
    "id": 1234
}'
                      
                    

Responses

200
update conference room participant

Sample Response

                      
                      
                    

Destroy conference room

POST /room/destroy
Destroy conference room
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

  • id

    integer

    required

    The ID of conference room.

Sample Request

                      curl -v -X POST http://127.0.0.1:8990/api/conference/room/destroy \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \
                      
                    

Responses

400
Invalid username supplied
404
User not found
200
Successful operation

Sample Response

                      
                      
                    

Create conference server

POST /server/create
Create conference server
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

Request body
application/json
  • type

    string

    required

    Every PortSIP PBX has a built-in conference server with type 1 (default); the new added conference server MUST be typed with "EXTERNAL".
  • ipv4

    string

    required

    Host IPV4 address for conference server.
  • port

    integer

    required

    Host port for conference server.
  • max_rooms

    integer

    required

    The maximum number of rooms for conference server.
  • ipv6

    string

    required

    Host IPV6 address for conference server.
  • name

    string

    required

    Name of conference server.
  • max_participants

    integer

    required

    The maximum number of participants for conference server.

Sample Request

                      curl -v -X POST http://127.0.0.1:8990/api/conference/server/create \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \
                          -d '{}'
                      
                    

Responses

200
Created conference server
application/json
  • id

    integer

    The userid of the tenant or admin user. Admin user has access to details for his account and other tenantusers, whilst tenant user has access to his account info only.

Sample Response

                      
{
    "id": 1234
}
                      
                    

Retrieve conference room

GET /room/show
Retrieve conference room
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

  • id

    integer

    required

    The ID of conference room.

Sample Request

                      curl -v -X GET http://127.0.0.1:8990/api/conference/room/show \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \
                      
                    

Responses

200
Successful operation
application/json
  • resolution

    string

    The video resolution for video conference room.
  • bitrate

    integer

    The transmission rate for video conference room. Values: 128 ~ 2048 (it MUST be an integer).
  • room_pin

    string

    PIN for the conference room.
  • unattended

    boolean

    Cancellation of interactive voice .
  • admin_pin

    string

    PIN for admin of the conference room.
  • layout

    integer

    The number of grids allowed for video conference room. Values : 1, 2, 3, 4, 6 or 9.
  • max_participants

    integer

    The maximum number of participants allowed in the room.
  • outbound_caller_id

    string

    outbound_caller_id of conference room.
  • id

    integer

  • mode

    string

    AUDIO for audio conference room; VIDEO for video conference room.
  • framerate

    integer

    The framerate for video conference room.
  • language

    string

    Language for prompt in the conference room.
  • extension_number

    string

    Extension for conference room. NOTE: It MUST be a non-existent extension.
  • subject

    string

    Subject of conference room.

Sample Response

                      
{
    "id": 1234
}
                      
                    

Retrieve conference server

GET /server/show
Retrieve conference server
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

  • id

    integer

    required

    The ID of conference server.

Sample Request

                      curl -v -X GET http://127.0.0.1:8990/api/conference/server/show \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \
                      
                    

Responses

200
Successful operation
application/json
  • type

    string

    Every PortSIP PBX has a built-in conference server with type 1 (default); the new added conference server MUST be typed with "EXTERNAL".
  • port

    integer

    Host port for conference server.
  • memory_usage

    integer

    The memory_usage for conference server.
  • status

    string

  • name

    string

    Name of conference server.
  • max_participants

    integer

    The maximum number of participants for conference server.
  • participants_count

    integer

    The number of participants for conference server.
  • rooms_count

    integer

    The number of rooms for conference server.
  • max_rooms

    integer

    The maximum number of rooms for conference server.
  • ipv6

    string

    Host IPV6 address for conference server.
  • cpu_usage

    integer

    The cpu_usage for conference server.
  • ipv4

    string

    Host IPV4 address for conference server.

Sample Response

                      
{}
                      
                    

Retrieve a collection of conference servers

GET /server/list
Retrieve a collection of conference servers
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

  • pagination

    integer

    required

    The pagination of paging.
  • pagesize

    integer

    required

    The size of paging.
  • sort_by

    string

    optional

    Values include "DEFAULT" and "Optional". Default value will be used when user does not specify value for this field.

Sample Request

                      curl -v -X GET http://127.0.0.1:8990/api/conference/server/list \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \
                      
                    

Responses

200
Successful operation
application/json
  • pagination

    integer

  • servers

    array

    Show child attributes
  • count

    integer

  • sort_by

    string

  • pagesize

    integer

Sample Response

                      
{
    "pagination": 8,
    "count": 100,
    "sort_by": "DEFAULT",
    "pagesize": 10
}
                      
                    

update conference room chairman

POST /room/chairman/update
update conference room chairman
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

Request body
application/json
  • id

    integer

    required

  • participant_extension

    string

    required

    Extension for conference room. NOTE: It MUST be a non-existent extension.

Sample Request

                      curl -v -X POST http://127.0.0.1:8990/api/conference/room/chairman/update \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \
                          -d '{
    "id": 1234
}'
                      
                    

Responses

200
update conference room chairman

Sample Response

                      
                      
                    

Update conference server

POST /server/update
Update conference server
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

Request body
application/json
  • id

    integer

    required

    The userid of the tenant or admin user. Admin user has access to details for his account and other tenantusers, whilst tenant user has access to his account info only.
  • max_rooms

    integer

    required

    The maximum number of rooms for conference server.
  • max_participants

    integer

    required

    The maximum number of participants for conference server.

Sample Request

                      curl -v -X POST http://127.0.0.1:8990/api/conference/server/update \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \
                          -d '{
    "id": 1234
}'
                      
                    

Responses

200
Successful operation

Sample Response

                      
                      
                    

Create conference room

POST /room/create
Create conference room
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

Request body
application/json
  • resolution

    string

    required

    The video resolution for video conference room.
  • bitrate

    integer

    required

    The transmission rate for video conference room. Values: 128 ~ 2048 (it MUST be an integer).
  • room_pin

    string

    required

    PIN for the conference room.
  • unattended

    boolean

    required

    Cancellation of interactive voice .
  • admin_pin

    string

    required

    PIN for admin of the conference room.
  • layout

    integer

    required

    The number of grids allowed for video conference room. Values : 1, 2, 3, 4, 6 or 9.
  • max_participants

    integer

    required

    The maximum number of participants allowed in the room.
  • outbound_caller_id

    string

    required

    outbound_caller_id of conference room.
  • mode

    string

    required

    AUDIO for audio conference room; VIDEO for video conference room.
  • framerate

    integer

    required

    The framerate for video conference room.

    minimum: 5

    maximum: 30

  • language

    string

    required

    Language for prompt in the conference room.
  • extension_number

    string

    required

    Extension for conference room. NOTE: It MUST be a non-existent extension.
  • subject

    string

    required

    Subject of conference room.

Sample Request

                      curl -v -X POST http://127.0.0.1:8990/api/conference/room/create \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \
                          -d '{}'
                      
                    

Responses

200
Created conference room object
application/json
  • id

    integer

Sample Response

                      
{
    "id": 1234
}
                      
                    

Retrieve a collection of conference rooms

GET /room/list
Retrieve a collection of conference rooms
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

  • pagination

    integer

    required

    The pagination of paging.
  • pagesize

    integer

    required

    The size of paging.
  • sort_by

    string

    optional

    Values include "DEFAULT" and "Optional". Default value will be used when user does not specify value for this field.

Sample Request

                      curl -v -X GET http://127.0.0.1:8990/api/conference/room/list \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \
                      
                    

Responses

200
Successful operation
application/json
  • pagination

    integer

  • rooms

    array

    Show child attributes
  • count

    integer

  • pagesize

    integer

  • sort_by

    string

Sample Response

                      
{
    "pagination": 8,
    "count": 100,
    "sort_by": "DEFAULT",
    "pagesize": 10
}
                      
                    

Destroy conference server

POST /server/destroy
Destroy conference server
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

Request body
application/json
  • id

    integer

    required

    The userid of the tenant or admin user. Admin user has access to details for his account and other tenantusers, whilst tenant user has access to his account info only.

Sample Request

                      curl -v -X POST http://127.0.0.1:8990/api/conference/server/destroy \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \
                          -d '{
    "id": 1234
}'
                      
                    

Responses

400
Invalid server id supplied
404
User not found
200
Successful operation

Sample Response