Skip to main content

InviteesService

A list of all methods in the InviteesService service. Click on the method name to view detailed information about that method.

MethodsDescription
rcw_config_list_inviteesReturns the list of Invitees (co-hosts and panelists in phase 1 and also invited attendees in subsequent phases) of a given Webinar Session. An implicit record created for a Webinar 'Host' is always returned.
rcw_config_update_inviteesAdds, updates and deletes Webinar Session invitees in bulk (co-hosts and panelists in phase 1 and also invited attendees in subsequent phases). The payload may contain multiple added, updated or deleted invitees. For each added record 'role' and either 'firstName'/'lastName'/'email' (for non-authenticated users) or 'linkedUser.*' (for authenticated users) must be specified, but not both. For updated invitees 'id' and 'role' must be specified, 'linkedUser' change is not supported. For deleted invitees only there ids should be specified. The response contains added/updated records (full) and deleted records (ids only). Deleting an invitee for a Session in 'Active' or 'Finished' status is prohibited.
rcw_config_get_inviteeReturns a Session Invitee information by ID
rcw_config_update_inviteeUpdates a Session Invitee. 'role' is required (it can be changed from 'Panelist' to 'CoHost' or vise versa). It is disallowed to update 'linkedUser': it should be done by deleting then adding an invitee. For non-authenticated users 'firstName'/'lastName'/'email' can be specified, but not both. Implicit record created for a Webinar 'Host' cannot be modified. Also it is disallowed to change any other role to 'Host'.
rcw_config_delete_inviteeDeletes a Session Invitee. Implicit record created for a Webinar 'Host' cannot be deleted. Deleting an invitee for a Session in 'Active' or 'Finished' status is prohibited (HTTP 403).

rcw_config_list_invitees

Returns the list of Invitees (co-hosts and panelists in phase 1 and also invited attendees in subsequent phases) of a given Webinar Session. An implicit record created for a Webinar 'Host' is always returned.

  • HTTP Method: GET
  • Endpoint: /webinar/configuration/v1/webinars/{webinarId}/sessions/{sessionId}/invitees

Parameters

NameTypeRequiredDescription
webinar_idstrIdentifier of the Webinar.
session_idstrIdentifier of the Session.
per_pageintThe number of items per page. If provided value in the request is greater than a maximum, the maximum value is applied
page_tokenstrThe token indicating the particular page of the result set to be retrieved. If omitted the first page will be returned.

Return Type

WcsInviteeListResource

Example Usage Code Snippet

from ring_central import RingCentral, Environment

sdk = RingCentral(
access_token="YOUR_ACCESS_TOKEN",
base_url=Environment.DEFAULT.value
)

result = sdk.invitees.rcw_config_list_invitees(
webinar_id="veniam labore adipi",
session_id="Ut",
per_page=100,
page_token="pageToken"
)

print(result)

rcw_config_update_invitees

Adds, updates and deletes Webinar Session invitees in bulk (co-hosts and panelists in phase 1 and also invited attendees in subsequent phases). The payload may contain multiple added, updated or deleted invitees. For each added record 'role' and either 'firstName'/'lastName'/'email' (for non-authenticated users) or 'linkedUser.*' (for authenticated users) must be specified, but not both. For updated invitees 'id' and 'role' must be specified, 'linkedUser' change is not supported. For deleted invitees only there ids should be specified. The response contains added/updated records (full) and deleted records (ids only). Deleting an invitee for a Session in 'Active' or 'Finished' status is prohibited.

  • HTTP Method: PATCH
  • Endpoint: /webinar/configuration/v1/webinars/{webinarId}/sessions/{sessionId}/invitees

Parameters

NameTypeRequiredDescription
request_bodyBulkUpdateInviteesRequestThe request body.
webinar_idstrIdentifier of the Webinar.
session_idstrIdentifier of the Session.

Return Type

BulkUpdateInviteesResponse

Example Usage Code Snippet

from ring_central import RingCentral, Environment
from ring_central.models import BulkUpdateInviteesRequest

sdk = RingCentral(
access_token="YOUR_ACCESS_TOKEN",
base_url=Environment.DEFAULT.value
)

request_body = BulkUpdateInviteesRequest(
added_invitees=[
{
"first_name": "John",
"last_name": "Doe",
"email": "[email protected]",
"job_title": "Product Manager",
"linked_user": {
"user_id": "irure ullamco ut nulla officia",
"account_id": "labore aute ipsum",
"domain": "pbx"
},
"role": "Panelist",
"type_": "User",
"send_invite": True
}
],
updated_invitees=[
{
"id_": "78654321",
"first_name": "John",
"last_name": "Doe",
"email": "[email protected]",
"job_title": "Product Manager",
"role": "Panelist",
"type_": "User",
"send_invite": True
}
],
deleted_invitees=[
{
"id_": "78654321"
}
]
)

result = sdk.invitees.rcw_config_update_invitees(
request_body=request_body,
webinar_id="veniam labore adipi",
session_id="Ut"
)

print(result)

rcw_config_get_invitee

Returns a Session Invitee information by ID

  • HTTP Method: GET
  • Endpoint: /webinar/configuration/v1/webinars/{webinarId}/sessions/{sessionId}/invitees/{inviteeId}

Parameters

NameTypeRequiredDescription
webinar_idstrIdentifier of the Webinar.
session_idstrIdentifier of the Session.
invitee_idstrIdentifier of the Session Invitee.

Return Type

InviteeResource

Example Usage Code Snippet

from ring_central import RingCentral, Environment

sdk = RingCentral(
access_token="YOUR_ACCESS_TOKEN",
base_url=Environment.DEFAULT.value
)

result = sdk.invitees.rcw_config_get_invitee(
webinar_id="sed",
session_id="irure e",
invitee_id="ut ut cillu"
)

print(result)

rcw_config_update_invitee

Updates a Session Invitee. 'role' is required (it can be changed from 'Panelist' to 'CoHost' or vise versa). It is disallowed to update 'linkedUser': it should be done by deleting then adding an invitee. For non-authenticated users 'firstName'/'lastName'/'email' can be specified, but not both. Implicit record created for a Webinar 'Host' cannot be modified. Also it is disallowed to change any other role to 'Host'.

  • HTTP Method: PUT
  • Endpoint: /webinar/configuration/v1/webinars/{webinarId}/sessions/{sessionId}/invitees/{inviteeId}

Parameters

NameTypeRequiredDescription
request_bodyUpdateInviteeRequestThe request body.
webinar_idstrIdentifier of the Webinar.
session_idstrIdentifier of the Session.
invitee_idstrIdentifier of the Session Invitee.

Return Type

InviteeResource

Example Usage Code Snippet

from ring_central import RingCentral, Environment
from ring_central.models import UpdateInviteeRequest

sdk = RingCentral(
access_token="YOUR_ACCESS_TOKEN",
base_url=Environment.DEFAULT.value
)

request_body = UpdateInviteeRequest(
first_name="John",
last_name="Doe",
email="[email protected]",
job_title="Product Manager",
role="Panelist",
type_="User",
send_invite=True
)

result = sdk.invitees.rcw_config_update_invitee(
request_body=request_body,
webinar_id="sed",
session_id="irure e",
invitee_id="ut ut cillu"
)

print(result)

rcw_config_delete_invitee

Deletes a Session Invitee. Implicit record created for a Webinar 'Host' cannot be deleted. Deleting an invitee for a Session in 'Active' or 'Finished' status is prohibited (HTTP 403).

  • HTTP Method: DELETE
  • Endpoint: /webinar/configuration/v1/webinars/{webinarId}/sessions/{sessionId}/invitees/{inviteeId}

Parameters

NameTypeRequiredDescription
webinar_idstrIdentifier of the Webinar.
session_idstrIdentifier of the Session.
invitee_idstrIdentifier of the Session Invitee.

Example Usage Code Snippet

from ring_central import RingCentral, Environment

sdk = RingCentral(
access_token="YOUR_ACCESS_TOKEN",
base_url=Environment.DEFAULT.value
)

result = sdk.invitees.rcw_config_delete_invitee(
webinar_id="sed",
session_id="irure e",
invitee_id="ut ut cillu"
)

print(result)

Build Your Own SDKs with  liblab

Build developer friendly SDKs in minutes from your APIs

Start for Free →