Add Video Conference Participants

Prev Next
Post
/api/v1/video-conference.add-participants

Adds users as members of the conference. Membership allows a user to join the call, but does not add them to the conference's room, so they might not be able to read the call chat. Use video-conference.info to check chatAccess, and video-conference.share-chat to give members access to the chat.

The response lists the user IDs of the members that were added. Users who are already members, usernames that do not exist, and calls that have ended result in no additions.

You must be a member of the conference or have access to the conference's room or discussion. Requests are limited to 5 per minute per client IP address.

Changelog

Version Description
8.9.0 Added
Header parameters
X-User-Id
stringRequired

The user ID.

ExampleCkCPNctrgCDfmWLqC
X-Auth-Token
stringRequired

The authentication token.

Example1Dd4iN_ClKn5jl-xPC36snQ4s9Zd5GZnXCQuCNSKcVE
Body parameters
Example
{
  "callId": "697887e3c8b0533020781a4a",
  "users": [
    "sam.okafor",
    "lee.chen"
  ],
  "ring": true
}
object
callId
string Required

The video conference call ID.

Example697887e3c8b0533020781a4a
users
Array of string Required

The usernames (not user IDs) of the people to add. Enter between 1 and 10 usernames.

Min items1
Max items10
Example[ "sam.okafor", "lee.chen" ]
string
ring
boolean

Whether to ring the people being added. Defaults to false. Ringing also requires the videoconf-ring-users permission; without it, the users are added without being rung.

Defaultfalse
Responses
200

OK

Success Example
{
  "added": [
    "kP3wQz8LmNvT5rXyB",
    "Hn4tYw9QeVb2LsJxR"
  ],
  "success": true
}
object
added
Array of string

The user IDs of the members that were added.

string
success
boolean
400

Bad Request

Missing Parameter
{
  "success": false,
  "error": "must have required property 'callId' [invalid-params]",
  "errorType": "invalid-params"
}
object
success
boolean
error
string
errorType
string
401

Unauthorized

Authorization Error
{
  "status": "error",
  "message": "You must be logged in to do this."
}
object
status
string
message
string
404

Not Found. The call does not exist, or you are neither a member of the conference nor able to access its room.

Not Found
{
  "success": false,
  "error": "Resource not found"
}
object
success
boolean
error
string