wxc_sdk.as_api module

class wxc_sdk.as_api.AsAccessCodesApi(*, session: AsRestSession, selector: ApiSelector = ApiSelector.person)[source]

Bases: AsPersonSettingsApiChild

API for outgoing permission access codes: locations, persons, workspaces, virtual lines

feature = 'outgoingPermission/accessCodes'
async read(entity_id: str, org_id: str | None = None) AuthCodes[source]

Retrieve Access codes.

Access codes are used to bypass permissions.

This API requires a full or read-only administrator auth token with a scope of spark-admin:workspaces_read or a user auth token with spark:workspaces_read scope can be used to read entity settings.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • org_id (str) – ID of the organization within which the entity resides. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

Returns:

authorization codes

Return type:

AuthCodes

async modify(entity_id: str, use_custom_access_codes: bool | None = None, delete_codes: list[str | AuthCode] | None = None, org_id: str | None = None)[source]

Modify Access Codes

Access codes are used to bypass permissions.

This API requires a full or user administrator or location administrator auth token with the spark-admin:telephony_config_write scope.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • use_custom_access_codes (bool) – When true, use custom settings for the access codes category of outgoing call permissions.

  • delete_codes (list[str]) – Indicates access codes to delete.

  • org_id (str) – ID of the organization in which the entity resides. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access the API.

Return type:

None

async create(entity_id: str, code: str, description: str, org_id: str | None = None)[source]

Create new Access codes.

Access codes are used to bypass permissions.

This API requires a full or user administrator auth token with the spark-admin:workspaces_write scope or a user auth token with spark:workspaces_write scope can be used to update workspace settings.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • code (str) – Indicates an access code.

  • description (str) – Indicates the description of the access code.

  • org_id (str) – ID of the organization within which the entity resides. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

async delete(entity_id: str, org_id: str | None = None)[source]

Delete Access Code

Deletes all Access codes for the given entity.

Access codes are used to bypass permissions.

This API requires a full or user administrator or location administrator auth token with the spark-admin:workspaces_write scope or a user auth token with spark:workspaces_write scope can be used to update entity settings.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • org_id (str) – ID of the organization within which the entity resides. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access the API.

Return type:

None

base = ''
class wxc_sdk.as_api.AsAdminAuditEventsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Admin Audit Events

Admin Audit Events are available to full administrators for certain events performed in Webex Control Hub.

Administrators with accounts created before 2019 who have never logged into Webex Control Hub will need to log into Webex Control Hub at least once to enable access to this API.

An administrator account with the audit:events_read scope is required to use this API.

list_events_gen(org_id: str, from_: str | datetime, to_: str | datetime, actor_id: str | None = None, event_categories: list[str] | None = None, **params) AsyncGenerator[AuditEvent, None, None][source]

List Admin Audit Events

List admin audit events in your organization. Several query parameters are available to filter the response.

Long result sets will be split into pages.

NOTE: A maximum of one year of audit events can be returned per request.

Parameters:
  • org_id (str) – List events in this organization, by ID.

  • from (Union[str, datetime]) – List events which occurred after a specific date and time.

  • to (Union[str, datetime]) – List events which occurred before a specific date and time.

  • actor_id (str) – List events performed by this person, by ID.

  • event_categories (list[str]) – List events, by event categories.

Returns:

Generator yielding AuditEvent instances

async list_events(org_id: str, from_: str | datetime, to_: str | datetime, actor_id: str | None = None, event_categories: list[str] | None = None, **params) List[AuditEvent][source]

List Admin Audit Events

List admin audit events in your organization. Several query parameters are available to filter the response.

Long result sets will be split into pages.

NOTE: A maximum of one year of audit events can be returned per request.

Parameters:
  • org_id (str) – List events in this organization, by ID.

  • from (Union[str, datetime]) – List events which occurred after a specific date and time.

  • to (Union[str, datetime]) – List events which occurred before a specific date and time.

  • actor_id (str) – List events performed by this person, by ID.

  • event_categories (list[str]) – List events, by event categories.

Returns:

Generator yielding AuditEvent instances

async list_event_categories() list[str][source]

List Admin Audit Event Categories

Get the list of all admin event categories.

Return type:

list[str]

base = 'adminAudit'
class wxc_sdk.as_api.AsAgentCallerIdApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

API to manage call queue agent caller ID information

available_queues_gen(person_id: str, org_id: str | None = None) AsyncGenerator[AgentQueue, None, None][source]

Retrieve the list of the person’s available call queues and the associated Caller ID information

If the Agent is to enable queueCallerIdEnabled, they must choose which queue to use as the source for outgoing Caller ID. This API returns a list of Call Queues from which the person must select. If this setting is disabled or Agent does not belong to any queue this list will be empty.

This API requires a full admin or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • org_id (str) – organization id

Returns:

yields person’s available call queues and the associated Caller ID information

Return type:

Generator[AgentQueue, None, None]

async available_queues(person_id: str, org_id: str | None = None) List[AgentQueue][source]

Retrieve the list of the person’s available call queues and the associated Caller ID information

If the Agent is to enable queueCallerIdEnabled, they must choose which queue to use as the source for outgoing Caller ID. This API returns a list of Call Queues from which the person must select. If this setting is disabled or Agent does not belong to any queue this list will be empty.

This API requires a full admin or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • org_id (str) – organization id

Returns:

yields person’s available call queues and the associated Caller ID information

Return type:

Generator[AgentQueue, None, None]

async read(person_id: str, org_id: str | None = None) QueueCallerId[source]

Retrieve a call queue agent’s Caller ID information

Each agent in the Call Queue will be able to set their outgoing Caller ID as either the Call Queue’s phone number or their own configured Caller ID. This API fetches the configured Caller ID for the agent in the system.

This API requires a full admin or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • org_id (str) – organization id

Returns:

call queue agent’s Caller ID information

Return type:

QueueCallerId

async update(person_id: str, update: QueueCallerId, org_id: str | None = None)[source]

Modify a call queue agent’s Caller ID information

Each Agent in the Call Queue will be able to set their outgoing Caller ID as either the designated Call Queue’s phone number or their own configured Caller ID. This API modifies the configured Caller ID for the agent in the system.

This API requires a full or user administrator auth token with the spark-admin:telephony_config_write scope.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • update (QueueCallerId) – new settings

  • org_id (str) – organization id

base = 'telephony/config/people'
class wxc_sdk.as_api.AsAnnouncementApi(*, session: AsRestSession)[source]

Bases: object

API for call queue Announcements

list_gen(location_id: str, queue_id: str, org_id: str | None = None) AsyncGenerator[Announcement][source]
Parameters:
  • location_id

  • queue_id

  • org_id

Returns:

async list(location_id: str, queue_id: str, org_id: str | None = None) List[Announcement][source]
Parameters:
  • location_id

  • queue_id

  • org_id

Returns:

async delete_announcement(location_id: str, queue_id: str, file_name: str, org_id: str | None = None)[source]
Parameters:
  • location_id (str)

  • queue_id (str)

  • file_name (str)

  • org_id

class wxc_sdk.as_api.AsAnnouncementsRepositoryApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Not supported for Webex for Government (FedRAMP)

Features: Announcement Repository support reading and writing of Webex Calling Announcement Repository settings for a specific organization.

Viewing these read-only organization settings requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read. Modifying these organization settings requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

A partner administrator can retrieve or change settings in a customer’s organization using the optional orgId query parameter.

list_gen(location_id: str | None = None, order: str | None = None, file_name: str | None = None, file_type: str | None = None, media_file_type: str | None = None, name: str | None = None, org_id: str | None = None, **params) AsyncGenerator[RepoAnnouncement, None, None][source]

Fetch a list of binary announcement greetings at an organization as well as location level. An admin can upload a file at an organization level. This file will be uploaded to the announcement repository. This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Return the list of enterprise or Location announcement files. Without this parameter, the Enterprise level announcements are returned. Possible values: all, locations, Y2lzY29zcGFyazovL3VzL0xPQ0FUSU9OLzMxMTYx

  • order (str) – Sort the list according to fileName or fileSize. The default sort will be in Ascending order.

  • file_name (str) – Return the list of announcements with the given fileName.

  • file_type (str) – Return the list of announcement files for this fileType.

  • media_file_type (str) – Return the list of announcement files for this mediaFileType.

  • name (str) – Return the list of announcement files for this announcement label.

  • org_id (str) – Create an announcement in this organization.

Returns:

yields RepoAnnouncement objects

async list(location_id: str | None = None, order: str | None = None, file_name: str | None = None, file_type: str | None = None, media_file_type: str | None = None, name: str | None = None, org_id: str | None = None, **params) List[RepoAnnouncement][source]

Fetch a list of binary announcement greetings at an organization as well as location level. An admin can upload a file at an organization level. This file will be uploaded to the announcement repository. This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Return the list of enterprise or Location announcement files. Without this parameter, the Enterprise level announcements are returned. Possible values: all, locations, Y2lzY29zcGFyazovL3VzL0xPQ0FUSU9OLzMxMTYx

  • order (str) – Sort the list according to fileName or fileSize. The default sort will be in Ascending order.

  • file_name (str) – Return the list of announcements with the given fileName.

  • file_type (str) – Return the list of announcement files for this fileType.

  • media_file_type (str) – Return the list of announcement files for this mediaFileType.

  • name (str) – Return the list of announcement files for this announcement label.

  • org_id (str) – Create an announcement in this organization.

Returns:

yields RepoAnnouncement objects

async upload_announcement(name: str, file: BufferedReader | str, upload_as: str | None = None, location_id: str | None = None, org_id: str | None = None) str[source]
async usage(location_id: str | None = None, org_id: str | None = None) RepositoryUsage[source]

Retrieves repository usage for announcements for an organization. This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Unique identifier of a location

  • org_id (str) – Create an announcement in this organization.

async details(announcement_id: str, location_id: str | None = None, org_id: str | None = None) RepoAnnouncement[source]

Fetch details of a binary announcement greeting by its ID at an organization level. An admin can upload a file at an organization level. This file will be uploaded to the announcement repository. This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Unique identifier of a location

  • announcement_id (str) – Unique identifier of an announcement.

  • org_id (str) – Get details of an announcement in this organization.

async delete(announcement_id: str, location_id: str | None = None, org_id: str | None = None)[source]

Delete an announcement greeting. This API requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • announcement_id (str) – Unique identifier of an announcement.

  • location_id (str) – Unique identifier of a location where announcement is being deleted.

  • org_id (str) – Delete an announcement in this organization.

async modify(announcement_id: str, name: str, file: BufferedReader | str, upload_as: str | None = None, location_id: str | None = None, org_id: str | None = None)[source]
base = 'telephony/config'
class wxc_sdk.as_api.AsApiChild(*, session: AsRestSession, base: str | None = None)[source]

Bases: object

Base class for child APIs of WebexSimpleApi

session: AsRestSession

REST session

ep(path: str | None = None)[source]

endpoint URL for given path

Parameters:

path (str) – path after APIChild subclass specific endpoint URI prefix

Returns:

endpoint URL

Return type:

str

async get(*args, **kwargs) str | dict[source]

GET request

Parameters:
  • args

  • kwargs

Returns:

async post(*args, **kwargs) str | dict[source]

POST request

Parameters:
  • args

  • kwargs

Returns:

async put(*args, **kwargs) str | dict[source]

PUT request

Parameters:
  • args

  • kwargs

Returns:

async delete(*args, **kwargs) None[source]

DELETE request

Parameters:
  • args

  • kwargs

async patch(*args, **kwargs) str | dict[source]

PATCH request

Parameters:
  • args

  • kwargs

class wxc_sdk.as_api.AsAppServicesApi(*, session: AsRestSession, selector: ApiSelector = ApiSelector.person)[source]

Bases: AsPersonSettingsApiChild

API for person’s app services settings

feature = 'applications'
async read(person_id: str, org_id: str | None = None) AppServicesSettings[source]

Retrieve a Person’s Application Services Settings

Application services let you determine the ringing behavior for calls made to people in certain scenarios. You can also specify which devices can download the Webex Calling app.

This API requires a full, user, or read-only administrator auth token with a scope of spark-admin:people_read.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • org_id (str) – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

Returns:

privacy settings

Return type:

Privacy

async configure(person_id: str, settings: AppServicesSettings, org_id: str | None = None)[source]

Modify a Person’s Application Services Settings

Application services let you determine the ringing behavior for calls made to users in certain scenarios. You can also specify which devices users can download the Webex Calling app on.

This API requires a full or user administrator auth token with the spark-admin:people_write scope.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • settings (AppServicesSettings) – settings for update

  • org_id (str) – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

base = ''
class wxc_sdk.as_api.AsApplyLineKeyTemplatesJobsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

async apply(action: ApplyLineKeyTemplateAction, template_id: str | None = None, location_ids: list[str] | None = None, exclude_devices_with_custom_layout: bool | None = None, include_device_tags: list[str] | None = None, exclude_device_tags: list[str] | None = None, advisory_types: LineKeyTemplateAdvisoryTypes | None = None, org_id: str | None = None) ApplyLineKeyTemplateJobDetails[source]

Apply a Line key Template

Apply a Line Key Template or reset devices to their factory Line Key settings.

Line Keys also known as Programmable Line Keys (PLK) are the keys found on either sides of a typical desk phone display. A Line Key Template is a definition of actions that will be performed by each of the Line Keys for a particular device model. This API allows users to apply a line key template or apply factory default Line Key settings to devices in a set of locations or across all locations in the organization.

Applying a Line Key Template or resetting devices to their default Line Key configuration requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • action (PostApplyLineKeyTemplateRequestAction) – Line key Template action to perform.

  • template_id (str) – templateId is required for APPLY_TEMPLATE action.

  • location_ids (list[str]) – Used to search for devices only in the given locations.

  • exclude_devices_with_custom_layout (bool) – Indicates whether to exclude devices with custom layout.

  • include_device_tags (list[str]) – Include devices only with these tags.

  • exclude_device_tags (list[str]) – Exclude devices with these tags.

  • advisory_types (LineKeyTemplateAdvisoryTypes) – Refine search with advisories.

  • org_id (str) – Apply Line Key Template for this organization.

Return type:

ApplyLineKeyTemplateJobDetails

async list(org_id: str | None = None) list[ApplyLineKeyTemplateJobDetails][source]

Get List of Apply Line Key Template jobs

Get the list of all apply line key templates jobs in an organization.

Line Keys also known as Programmable Line Keys (PLK) are the keys found on either sides of a typical desk phone display. A Line Key Template is a definition of actions that will be performed by each of the Line Keys for a particular device model. This API allows users to retrieve all the apply line key templates jobs in an organization.

Retrieving the list of apply line key templates jobs in an organization requires a full, user or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:

org_id (str) – Retrieve list of line key templates jobs in this organization.

Return type:

list[ApplyLineKeyTemplateJobDetails]

async status(job_id: str, org_id: str | None = None) ApplyLineKeyTemplateJobDetails[source]

Get the job status of an Apply Line Key Template job

Get the status of an apply line key template job by its job ID.

Line Keys also known as Programmable Line Keys (PLK) are the keys found on either sides of a typical desk phone display. A Line Key Template is a definition of actions that will be performed by each of the Line Keys for a particular device model. This API allows users to check the status of an apply line key templates job by job ID in an organization.

Checking the the status of an apply line key templates job in an organization requires a full, user or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • job_id (str) – Retrieve job status for this jobId.

  • org_id (str) – Check a line key template job status in this organization.

Return type:

ApplyLineKeyTemplateJobDetails

errors_gen(job_id: str, org_id: str | None = None) AsyncGenerator[JobErrorItem, None, None][source]

Get job errors for an Apply Line Key Template job

GET job errors for an apply Line Key Template job in an organization.

Line Keys also known as Programmable Line Keys (PLK) are the keys found on either sides of a typical desk phone display. A Line Key Template is a definition of actions that will be performed by each of the Line Keys for a particular device model. This API allows users to retrieve all the errors of an apply line key templates job by job ID in an organization.

Retrieving all the errors of an apply line key templates job in an organization requires a full, user or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • job_id (str) – Retrieve job errors for this jobId.

  • org_id (str) – Retrieve list of errors for an apply line key template job in this organization.

async errors(job_id: str, org_id: str | None = None) List[JobErrorItem][source]

Get job errors for an Apply Line Key Template job

GET job errors for an apply Line Key Template job in an organization.

Line Keys also known as Programmable Line Keys (PLK) are the keys found on either sides of a typical desk phone display. A Line Key Template is a definition of actions that will be performed by each of the Line Keys for a particular device model. This API allows users to retrieve all the errors of an apply line key templates job by job ID in an organization.

Retrieving all the errors of an apply line key templates job in an organization requires a full, user or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • job_id (str) – Retrieve job errors for this jobId.

  • org_id (str) – Retrieve list of errors for an apply line key template job in this organization.

base = 'telephony/config/jobs/devices/applyLineKeyTemplate'
class wxc_sdk.as_api.AsAttachmentActionsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Users create attachment actions by interacting with message attachments such as clicking on a submit button in a card.

async details(action_id: str) AttachmentAction[source]

Shows details for a attachment action, by ID. Specify the attachment action ID in the id URI parameter.

Parameters:

action_id (str) – A unique identifier for the attachment action.

base = 'attachment/actions'
class wxc_sdk.as_api.AsAuthorizationsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Authorizations are user grants to applications to act on the user’s behalf. Authorizations are how Integrations get authorized with specific access scopes in the oAuth client life-cycle. Integrations and some of the Webex service portals, like developer.webex.com, are all oAuth clients, each with their unique clientId.

Your application receives an API access token and a refresh token through the oAuth process. The access token is used to call Webex APIs for which the user authorized the scopes. Access tokens expire fairly frequently, while refresh tokens (when being regularly used) will be refreshed to last forever (see Using the Refresh Token for details).

In this API an authorization is synonymous with an API access token.

To provide admins with fine-grained token management control, you use the /authorizations API with the DELETE HTTP method to revoke access and refresh tokens.

Deleting a refresh token will revoke all associated access tokens as well. Deleting an access token will revoke the developers ability to call the APIs with it. Webex subsystems may cache the validity of the token for a short while longer after the authorization was deleted.

Admins can revoke user authorizations for users in their organization. When an admin deletes their own token, the clientId used to authorize the request must match the clientId used to generate the token.

To use the authorizations API in an Integration the scopes must include: identity:tokens_write, identity:tokens_read.

async list(person_id: str | None = None, person_email: str | None = None) list[Authorization][source]

Lists all authorizations for a user. Either personId or personEmail must be provided. This API does not support pagination.

Parameters:
  • person_id – List authorizations for this user id.

  • person_email – List authorizations for this user email.

Returns:

List of Authorizations

async delete(authorization_id: str | None = None, client_id: str | None = None, org_id: str | None = None)[source]

Deletes an authorization, by authorization ID or client ID and org ID.

Specify the authorization Id in the authorizationId parameter in the URI which was listed in the list resource. The client_id parameter can be combined with org_id.

Parameters:
  • authorization_id (str) – The unique identifier for the authorization

  • client_id (str) – The unique oAuth client id.

  • org_id (str) – The ID of the organization. If no orgId is specified, use orgId from the OAuth token.

base = 'authorizations'
class wxc_sdk.as_api.AsAutoAttendantApi(session: AsRestSession)[source]

Bases: AsApiChild

Auto attendant API

forwarding: AsForwardingApi
list_gen(org_id: str | None = None, location_id: str | None = None, name: str | None = None, phone_number: str | None = None, **params) AsyncGenerator[AutoAttendant, None, None][source]

Read the List of Auto Attendants List all Auto Attendants for the organization.

Auto attendants play customized prompts and provide callers with menu options for routing their calls through your system.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • org_id (str) – List auto attendants for this organization.

  • location_id (str) – Return the list of auto attendants for this location.

  • name (str) – Only return auto attendants with the matching name.

  • phone_number (str) – Only return auto attendants with the matching phone number.

Returns:

yields AutoAttendant objects

async list(org_id: str | None = None, location_id: str | None = None, name: str | None = None, phone_number: str | None = None, **params) List[AutoAttendant][source]

Read the List of Auto Attendants List all Auto Attendants for the organization.

Auto attendants play customized prompts and provide callers with menu options for routing their calls through your system.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • org_id (str) – List auto attendants for this organization.

  • location_id (str) – Return the list of auto attendants for this location.

  • name (str) – Only return auto attendants with the matching name.

  • phone_number (str) – Only return auto attendants with the matching phone number.

Returns:

yields AutoAttendant objects

async by_name(name: str, location_id: str | None = None, org_id: str | None = None) AutoAttendant | None[source]

Get auto attendant info by name

Parameters:
  • location_id

  • name

  • org_id

Returns:

async details(location_id: str, auto_attendant_id: str, org_id: str | None = None) AutoAttendant[source]

Get Details for an Auto Attendant Retrieve an Auto Attendant details.

Auto attendants play customized prompts and provide callers with menu options for routing their calls through your system.

Retrieving an auto attendant details requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Retrieve an auto attendant details in this location.

  • auto_attendant_id (str) – Retrieve the auto attendant with the matching ID.

  • org_id (str) – Retrieve auto attendant details from this organization.

Returns:

auto attendant details

Return type:

AutoAttendant

async create(location_id: str, settings: AutoAttendant, org_id: str | None = None) str[source]

Create an Auto Attendant Create new Auto Attendant for the given location.

Auto attendants play customized prompts and provide callers with menu options for routing their calls through your system.

Creating an auto attendant requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Create the auto attendant for this location.

  • settings (AutoAttendant) – auto attendant settings for new auto attendant

  • org_id (str) – Create the auto attendant for this organization.

Returns:

ID of the newly created auto attendant.

Return type:

str

async update(location_id: str, auto_attendant_id: str, settings: AutoAttendant, org_id: str | None = None)[source]

Update an Auto Attendant Update the designated Auto Attendant.

Auto attendants play customized prompts and provide callers with menu options for routing their calls through your system.

Updating an auto attendant requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Location in which this auto attendant exists.

  • auto_attendant_id (str) – Update an auto attendant with the matching ID.

  • settings (AutoAttendant) – auto attendant settings for the update

  • org_id (str) – Create the auto attendant for this organization.

async delete_auto_attendant(location_id: str, auto_attendant_id: str, org_id: str | None = None)[source]

elete the designated Auto Attendant.

Auto attendants play customized prompts and provide callers with menu options for routing their calls through your system.

Deleting an auto attendant requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Location from which to delete an auto attendant.

  • auto_attendant_id (str) – Delete the auto attendant with the matching ID.

  • org_id (str) – Delete the auto attendant from this organization.

base = 'telephony/config/autoAttendants'
class wxc_sdk.as_api.AsBargeApi(*, session: AsRestSession, selector: ApiSelector = ApiSelector.person)[source]

Bases: AsPersonSettingsApiChild

API for barge settings; also used for virtual lines

feature = 'bargeIn'
async read(entity_id: str, org_id: str | None = None) BargeSettings[source]

Retrieve Barge In Settings

The Barge In feature enables you to use a Feature Access Code (FAC) to answer a call that was directed to another subscriber, or barge-in on the call if it was already answered. Barge In can be used across locations.

This API requires a full, user, or read-only administrator auth token with a scope of spark-admin:people_read or a user auth token with spark:people_read scope can be used by an entity to read their own settings.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • org_id (str) – entity is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

Returns:

barge settings for specific user

Return type:

BargeSettings

async configure(entity_id: str, barge_settings: BargeSettings, org_id: str | None = None)[source]

Configure Barge In Settings

The Barge In feature enables you to use a Feature Access Code (FAC) to answer a call that was directed to another subscriber, or barge-in on the call if it was already answered. Barge In can be used across locations.

This API requires a full or user administrator auth token with the spark-admin:people_write scope or a user auth token with spark:people_write scope can be used by an entity to update their own settings.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • barge_settings (BargeSettings) – new setting to be applied

  • org_id – entity is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

base = ''
class wxc_sdk.as_api.AsCQPolicyApi(session: AsRestSession)[source]

Bases: object

async holiday_service_details(location_id: str, queue_id: str, org_id: str | None = None) HolidayService[source]

Retrieve Call Queue Holiday Service details.

Configure the call queue to route calls differently during the holidays.

Retrieving call queue holiday service details requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Retrieve settings for a call queue in this location.

  • queue_id (str) – Retrieve settings for the call queue with this identifier.

  • org_id (str) – Retrieve call queue settings from this organization.

Returns:

Call Queue Holiday Service details

Return type:

HolidayService

async holiday_service_update(location_id: str, queue_id: str, update: HolidayService, org_id: str | None = None)[source]

Update the designated Call Queue Holiday Service.

Configure the call queue to route calls differently during the holidays.

Updating a call queue holiday service requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Location in which this call queue exists.

  • queue_id (str) – Update setting for the call queue with the matching ID.

  • update (HolidayService) – holiday service settings.

  • org_id (str) – Update call queue settings from this organisation.

async night_service_detail(location_id: str, queue_id: str, org_id: str | None = None) NightService[source]

Retrieve Call Queue Night service details.

Configure the call queue to route calls differently during the hours when the queue is not in service. This is determined by a schedule that defines the business hours of the queue.

Retrieving call queue details requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Retrieve settings for a call queue in this location.

  • queue_id (str) – Retrieve settings for the call queue night service with this identifier.

  • org_id (str) – Retrieve call queue night service settings from this organisation

Returns:

Call Queue Night service details

Return type:

NightService

async night_service_update(location_id: str, queue_id: str, update: NightService, org_id: str | None = None)[source]

Update Call Queue Night Service details.

Configure the call queue to route calls differently during the hours when the queue is not in service. This is determined by a schedule that defines the business hours of the queue.

Retrieving call queue night service details requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – update settings for a call queue in this location.

  • queue_id (str) – update settings for the call queue night service with this identifier.

  • update (NightService) – new night service settings

  • org_id (str) – update call queue night service settings from this organisation.

async stranded_calls_details(location_id: str, queue_id: str, org_id: str | None = None) StrandedCalls[source]

Allow admin to view default/configured Stranded Calls settings.

Stranded-All agents logoff Policy: If the last agent staffing a queue “unjoins” the queue or signs out, then all calls in the queue become stranded. Stranded-Unavailable Policy: This policy allows for the configuration of the processing of calls that are in a staffed queue when all agents are unavailable.

Retrieving call queue Stranded Calls details requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Retrieve settings for a call queue in this location.

  • queue_id (str) – Retrieve settings for the call queue with this identifier.

  • org_id (str) – Retrieve call queue settings from this organization.

Returns:

Stranded Calls settings

Return type:

StrandedCalls

async stranded_calls_update(location_id: str, queue_id: str, update: StrandedCalls, org_id: str | None = None)[source]

Update the designated Call Stranded Calls Service.

Allow admin to modify configured Stranded Calls settings.

Updating a call queue stranded calls requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Location in which this call queue exists.

  • queue_id (str) – Update setting for the call queue with the matching ID.

  • update (StrandedCalls) – Call Stranded Calls settings

  • org_id (str) – Update call queue settings from this organisation.

async forced_forward_details(location_id: str, queue_id: str, org_id: str | None = None) ForcedForward[source]

Retrieve Call Queue policy Forced Forward details.

This policy allows calls to be temporarily diverted to a configured destination.

Retrieving call queue Forced Forward details requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id – Location in which this call queue exists.

  • queue_id – Retrieve setting for the call queue with the matching ID.

  • org_id – Retrieve call queue settings from this organisation.

Returns:

Call Queue policy Forced Forward details.

Return type:

ForcedForward

async forced_forward_update(location_id: str, queue_id: str, update: ForcedForward, org_id: str | None = None)[source]

Update the designated Forced Forward Service.

If the option is enabled, then incoming calls to the queue are forwarded to the configured destination. Calls that are already in the queue remain queued. The policy can be configured to play an announcement prior to proceeding with the forward.

Updating a call queue Forced Forward service requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Location in which this call queue exists.

  • queue_id (str) – Update setting for the call queue with the matching ID.

  • update (ForcedForward) – new call queue Forced Forward settings

  • org_id (str) – Update call queue settings from this organisation.

class wxc_sdk.as_api.AsCallBridgeApi(*, session: AsRestSession, selector: ApiSelector = ApiSelector.person)[source]

Bases: AsPersonSettingsApiChild

User Call Settings with Call Bridge Feature

Not supported for Webex for Government (FedRAMP)

Person Call Settings supports modifying Webex Calling settings for a specific person.

Viewing People requires a full, user, or read-only administrator auth token with a scope of spark-admin:people_read or, for select APIs, a user auth token with spark:people_read scope can be used by a person to read their own settings.

Configuring People settings requires a full or user administrator auth token with the spark-admin:people_write scope or, for select APIs, a user auth token with spark:people_write scope can be used by a person to update their own settings.

feature = 'callBridge'
async read(entity_id: str, org_id: str | None = None) CallBridgeSetting[source]

Read Call Bridge Settings

Retrieve Bridge settings.

This API requires a full, user or read-only administrator or location administrator auth token with a scope of spark-admin:people_read.

Parameters:
  • entity_id (str) – Unique identifier for the person.

  • org_id (str) – ID of the organization in which the person resides. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

Return type:

:class:’CallBridgeSetting’

async configure(entity_id: str, setting: CallBridgeSetting, org_id: str | None = None)[source]

Configure Call Bridge Settings

Configure Call Bridge settings.

This API requires a full or user administrator or location administrator auth token with the spark-admin:people_write scope.

Parameters:
  • entity_id (str) – Unique identifier for the person.

  • setting (:class:'CallBridgeSetting') – new call bridge settings

  • org_id (str) – ID of the organization in which the person resides. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

Return type:

None

base = ''
class wxc_sdk.as_api.AsCallInterceptApi(*, session: AsRestSession, selector: ApiSelector = ApiSelector.person)[source]

Bases: AsPersonSettingsApiChild

API for call intercept settings

Also used for virtual lines and workspaces

feature = 'intercept'
async read(entity_id: str, org_id: str | None = None) InterceptSetting[source]

Read Call Intercept Settings

Retrieves Call Intercept Settings

The intercept feature gracefully takes an entity’s phone out of service, while providing callers with informative announcements and alternative routing options. Depending on the service configuration, none, some, or all incoming calls to the specified entity are intercepted. Also depending on the service configuration, outgoing calls are intercepted or rerouted to another location.

This API requires a full, user, or read-only administrator auth token with a scope of spark-admin:people_read.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • org_id (str) – entity is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

Returns:

user’s call intercept settings

Return type:

InterceptSetting

async configure(entity_id: str, intercept: InterceptSetting, org_id: str | None = None)[source]

Configure Call Intercept Settings

Configures Call Intercept Settings

The intercept feature gracefully takes an entity’s phone out of service, while providing callers with informative announcements and alternative routing options. Depending on the service configuration, none, some, or all incoming calls to the specified entity are intercepted. Also depending on the service configuration, outgoing calls are intercepted or rerouted to another location.

This API requires a full or user administrator auth token with the spark-admin:people_write scope.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • intercept (InterceptSetting) – new intercept settings

  • org_id (str) – entity is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

async greeting(entity_id: str, content: BufferedReader | str, upload_as: str | None = None, org_id: str | None = None)[source]

Configure Call Intercept Greeting

ConfigureCall Intercept Greeting by uploading a Waveform Audio File Format, .wav, encoded audio file.

Your request will need to be a multipart/form-data request rather than JSON, using the audio/wav Content-Type.

This API requires a full or user administrator auth token with the spark-admin:people_write scope or a user auth token with spark:people_write scope can be used by an entity to update their settings.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • content (Union[BufferedReader, str]) – the file to be uploaded, can be a path to a file or a buffered reader (opened file); if a reader referring to an open file is passed then make sure to open the file as binary b/c otherwise the content length might be calculated wrong

  • upload_as (str) – filename for the content. Only required if content is a reader; has to be a .wav file name.

  • org_id (str) – entity is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

base = ''
class wxc_sdk.as_api.AsCallParkApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Call Park API

list_gen(location_id: str, order: Literal['ASC', 'DSC'] | None = None, name: str | None = None, org_id: str | None = None, **params) AsyncGenerator[CallPark, None, None][source]

Read the List of Call Parks

List all Call Parks for the organization.

Call Park allows call recipients to place a call on hold so that it can be retrieved from another device.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

NOTE: The Call Park ID will change upon modification of the Call Park name.

Parameters:
  • location_id (str) – Return the list of call parks for this location.

  • order (str) – Sort the list of call parks by name, either ASC or DSC. Default is ASC.

  • name (str) – Return the list of call parks that contains the given name. The maximum length is 80.

  • org_id (str) – List call parks for this organization.

Returns:

yields CallPark objects

async list(location_id: str, order: Literal['ASC', 'DSC'] | None = None, name: str | None = None, org_id: str | None = None, **params) List[CallPark][source]

Read the List of Call Parks

List all Call Parks for the organization.

Call Park allows call recipients to place a call on hold so that it can be retrieved from another device.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

NOTE: The Call Park ID will change upon modification of the Call Park name.

Parameters:
  • location_id (str) – Return the list of call parks for this location.

  • order (str) – Sort the list of call parks by name, either ASC or DSC. Default is ASC.

  • name (str) – Return the list of call parks that contains the given name. The maximum length is 80.

  • org_id (str) – List call parks for this organization.

Returns:

yields CallPark objects

async create(location_id: str, settings: CallPark, org_id: str | None = None) str[source]

Create a Call Park

Create new Call Parks for the given location.

Call Park allows call recipients to place a call on hold so that it can be retrieved from another device.

Creating a call park requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

NOTE: The Call Park ID will change upon modification of the Call Park name.

Parameters:
  • location_id (str) – Create the call park for this location.

  • settings (CallPark) – settings for new call park

  • org_id – Create the call park for this organization.

Returns:

ID of the newly created call park.

Return type:

str

async delete_callpark(location_id: str, callpark_id: str, org_id: str | None = None)[source]

Delete a Call Park

Delete the designated Call Park.

Call Park allows call recipients to place a call on hold so that it can be retrieved from another device.

Deleting a call park requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

NOTE: The Call Park ID will change upon modification of the Call Park name.

Parameters:
  • location_id (str) – Location from which to delete a call park.

  • callpark_id (str) – Delete the call park with the matching ID.

  • org_id (str) – Delete the call park from this organization.

async details(location_id: str, callpark_id: str, org_id: str | None = None) CallPark[source]

Get Details for a Call Park

Retrieve Call Park details.

Call Park allows call recipients to place a call on hold so that it can be retrieved from another device.

Retrieving call park details requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

NOTE: The Call Park ID will change upon modification of the Call Park name.

Parameters:
  • location_id (str) – Retrieve settings for a call park in this location.

  • callpark_id (str) – Retrieve settings for a call park with the matching ID.

  • org_id (str) – Retrieve call park settings from this organization.

Returns:

call park info

Return type:

CallPark

async update(location_id: str, callpark_id: str, settings: CallPark, org_id: str | None = None) str[source]

Update a Call Park

Update the designated Call Park.

Call Park allows call recipients to place a call on hold so that it can be retrieved from another device.

Updating a call park requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

NOTE: The Call Park ID will change upon modification of the Call Park name.

Parameters:
  • location_id (str) – RLocation in which this call park exists.

  • callpark_id (str) – Update settings for a call park with the matching ID.

  • settings (CallPark) – updates

  • org_id (str) – Update call park settings from this organization.

available_agents_gen(location_id: str, call_park_name: str | None = None, name: str | None = None, phone_number: str | None = None, order: str | None = None, org_id: str | None = None) AsyncGenerator[PersonPlaceAgent, None, None][source]

Get available agents from Call Parks Retrieve available agents from call parks for a given location.

Call Park allows call recipients to place a call on hold so that it can be retrieved from another device.

Retrieving available agents from call parks requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Return the available agents for this location.

  • call_park_name (str) – Only return available agents from call parks with the matching name.

  • name (str) – Only return available agents with the matching name.

  • phone_number (str) – Only return available agents with the matching primary number.

  • order (str) – Order the available agents according to the designated fields. Up to three vertical bar (|) separated sort order fields may be specified. Available sort fields: fname, lname, number and extension. The maximum supported sort order value is 3.

  • org_id (str) – Return the available agents for this organization.

Returns:

yields PersonPlaceCallPark objects

async available_agents(location_id: str, call_park_name: str | None = None, name: str | None = None, phone_number: str | None = None, order: str | None = None, org_id: str | None = None) List[PersonPlaceAgent][source]

Get available agents from Call Parks Retrieve available agents from call parks for a given location.

Call Park allows call recipients to place a call on hold so that it can be retrieved from another device.

Retrieving available agents from call parks requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Return the available agents for this location.

  • call_park_name (str) – Only return available agents from call parks with the matching name.

  • name (str) – Only return available agents with the matching name.

  • phone_number (str) – Only return available agents with the matching primary number.

  • order (str) – Order the available agents according to the designated fields. Up to three vertical bar (|) separated sort order fields may be specified. Available sort fields: fname, lname, number and extension. The maximum supported sort order value is 3.

  • org_id (str) – Return the available agents for this organization.

Returns:

yields PersonPlaceCallPark objects

available_recalls_gen(location_id: str, name: str | None = None, order: str | None = None, org_id: str | None = None) AsyncGenerator[AvailableRecallHuntGroup, None, None][source]

Get available recall hunt groups from Call Parks

Retrieve available recall hunt groups from call parks for a given location.

Call Park allows call recipients to place a call on hold so that it can be retrieved from another device.

Retrieving available recall hunt groups from call parks requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Return the available recall hunt groups for this location.

  • name (str) – Only return available recall hunt groups with the matching name.

  • order – Order the available recall hunt groups according to the designated fields. Available sort fields: lname.

  • order – str

  • org_id (str) – Return the available recall hunt groups for this organization.

Returns:

yields AvailableRecallHuntGroup objects

async available_recalls(location_id: str, name: str | None = None, order: str | None = None, org_id: str | None = None) List[AvailableRecallHuntGroup][source]

Get available recall hunt groups from Call Parks

Retrieve available recall hunt groups from call parks for a given location.

Call Park allows call recipients to place a call on hold so that it can be retrieved from another device.

Retrieving available recall hunt groups from call parks requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Return the available recall hunt groups for this location.

  • name (str) – Only return available recall hunt groups with the matching name.

  • order – Order the available recall hunt groups according to the designated fields. Available sort fields: lname.

  • order – str

  • org_id (str) – Return the available recall hunt groups for this organization.

Returns:

yields AvailableRecallHuntGroup objects

async call_park_settings(location_id: str, org_id: str | None = None) LocationCallParkSettings[source]

Get Call Park Settings

Retrieve Call Park Settings from call parks for a given location.

Call Park allows call recipients to place a call on hold so that it can be retrieved from another device.

Retrieving settings from call parks requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Return the call park settings for this location.

  • org_id (str) – Return the call park settings for this organization.

Returns:

async update_call_park_settings(location_id: str, settings: LocationCallParkSettings, org_id: str | None = None)[source]

Update Call Park settings

Update Call Park settings for the designated location.

Call Park allows call recipients to place a call on hold so that it can be retrieved from another device.

Updating call park settings requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Location for which call park settings will be updated.

  • settings (LocationCallParkSettings) – update settings

  • org_id (str) – Update call park settings from this organization.

base = 'telephony/config/callParks'
class wxc_sdk.as_api.AsCallPickupApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Call Pickup API

list_gen(location_id: str, order: Literal['ASC', 'DSC'] | None = None, name: str | None = None, org_id: str | None = None, **params) AsyncGenerator[CallPickup, None, None][source]

Read the List of Call Pickups

List all Call Pickups for the organization.

Call Pickup enables a user(agent) to answer any ringing line within their pickup group.

Retrieving this list requires a full, user, or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

NOTE: The Call Pickup ID will change upon modification of the Call Pickup name.

Parameters:
  • location_id (str) – Return the list of call pickups for this location.

  • order (str) – Sort the list of call pickups by name, either ASC or DSC. Default is ASC.

  • name (str) – Return the list of call pickups that contains the given name. The maximum length is 80.

  • org_id (str) – List call pickups for this organization.

Returns:

yields CallPickup objects

async list(location_id: str, order: Literal['ASC', 'DSC'] | None = None, name: str | None = None, org_id: str | None = None, **params) List[CallPickup][source]

Read the List of Call Pickups

List all Call Pickups for the organization.

Call Pickup enables a user(agent) to answer any ringing line within their pickup group.

Retrieving this list requires a full, user, or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

NOTE: The Call Pickup ID will change upon modification of the Call Pickup name.

Parameters:
  • location_id (str) – Return the list of call pickups for this location.

  • order (str) – Sort the list of call pickups by name, either ASC or DSC. Default is ASC.

  • name (str) – Return the list of call pickups that contains the given name. The maximum length is 80.

  • org_id (str) – List call pickups for this organization.

Returns:

yields CallPickup objects

async create(location_id: str, settings: CallPickup, org_id: str | None = None) str[source]

Create a Call Pickup

Create new Call Pickups for the given location.

Call Pickup enables a user(agent) to answer any ringing line within their pickup group.

Creating a call pickup requires a full or user administrator auth token with a scope of spark-admin:telephony_config_write.

NOTE: The Call Pickup ID will change upon modification of the Call Pickup name.

Parameters:
  • location_id (str) – Create the call pickup for this location.

  • settings (CallPickup) – settings for new call pickup

  • org_id – Create the call pickup for this organization.

Returns:

ID of the newly created call pickup.

Return type:

str

async delete_pickup(location_id: str, pickup_id: str, org_id: str | None = None)[source]

Delete a Call Pickup

Delete the designated Call Pickup.

Call Pickup enables a user(agent) to answer any ringing line within their pickup group.

Deleting a call pickup requires a full or user administrator auth token with a scope of spark-admin:telephony_config_write.

NOTE: The Call Pickup ID will change upon modification of the Call Pickup name.

Parameters:
  • location_id (str) – Location from which to delete a call pickup.

  • pickup_id (str) – Delete the call pickup with the matching ID.

  • org_id (str) – Delete the call pickup from this organization.

async details(location_id: str, pickup_id: str, org_id: str | None = None) CallPickup[source]

Get Details for a Call Pickup

Retrieve Call Pickup details.

Call Pickup enables a user(agent) to answer any ringing line within their pickup group.

Retrieving call pickup details requires a full, user, or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

NOTE: The Call Pickup ID will change upon modification of the Call Pickup name.

Parameters:
  • location_id (str) – Retrieve settings for a call pickup in this location.

  • pickup_id (str) – Retrieve settings for a call pickup with the matching ID.

  • org_id (str) – Retrieve call pickup settings from this organization.

Returns:

call pickup info

Return type:

CallPickup

async update(location_id: str, pickup_id: str, settings: CallPickup, org_id: str | None = None) str[source]

Update a Call Pickup

Update the designated Call Pickup.

Call Pickup enables a user(agent) to answer any ringing line within their pickup group.

Updating a call pickup requires a full or user administrator auth token with a scope of spark-admin:telephony_config_write.

NOTE: The Call Pickup ID will change upon modification of the Call Pickup name.

Parameters:
  • location_id (str) – Location in which this call pickup exists.

  • pickup_id (str) – Update settings for a call pickup with the matching ID.

  • settings (CallPickup) – updates

  • org_id (str) – Update call pickup settings from this organization.

available_agents_gen(location_id: str, call_pickup_name: str | None = None, name: str | None = None, phone_number: str | None = None, order: str | None = None, org_id: str | None = None) AsyncGenerator[PersonPlaceAgent, None, None][source]

Get available agents from Call Pickups Retrieve available agents from call pickups for a given location.

Call Pickup enables a user(agent) to answer any ringing line within their pickup group.

Retrieving available agents from call pickups requires a full, user, or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Return the available agents for this location.

  • call_pickup_name (str) – Only return available agents from call pickups with the matching name.

  • name (str) – Only return available agents with the matching name.

  • phone_number (str) – Only return available agents with the matching primary number.

  • order (str) – Order the available agents according to the designated fields. Up to three vertical bar (|) separated sort order fields may be specified. Available sort fields: fname, lname, number and extension. The maximum supported sort order value is 3.

  • org_id (str) – Return the available agents for this organization.

Returns:

yields PersonPlaceCallPark objects

async available_agents(location_id: str, call_pickup_name: str | None = None, name: str | None = None, phone_number: str | None = None, order: str | None = None, org_id: str | None = None) List[PersonPlaceAgent][source]

Get available agents from Call Pickups Retrieve available agents from call pickups for a given location.

Call Pickup enables a user(agent) to answer any ringing line within their pickup group.

Retrieving available agents from call pickups requires a full, user, or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Return the available agents for this location.

  • call_pickup_name (str) – Only return available agents from call pickups with the matching name.

  • name (str) – Only return available agents with the matching name.

  • phone_number (str) – Only return available agents with the matching primary number.

  • order (str) – Order the available agents according to the designated fields. Up to three vertical bar (|) separated sort order fields may be specified. Available sort fields: fname, lname, number and extension. The maximum supported sort order value is 3.

  • org_id (str) – Return the available agents for this organization.

Returns:

yields PersonPlaceCallPark objects

base = 'telephony/config/callPickups'
class wxc_sdk.as_api.AsCallQueueApi(session: AsRestSession)[source]

Bases: object

Call Queue APÍ

forwarding: AsForwardingApi
announcement: AsAnnouncementApi
policy: AsCQPolicyApi
list_gen(location_id: str | None = None, name: str | None = None, phone_number: str | None = None, department_id: str | None = None, department_name: str | None = None, org_id: str | None = None, **params) AsyncGenerator[CallQueue, None, None][source]

Read the List of Call Queues List all Call Queues for the organization.

Call queues temporarily hold calls in the cloud when all agents, which can be users or agents, assigned to receive calls from the queue are unavailable. Queued calls are routed to an available agent when not on an active call. Each call queue is assigned a Lead Number, which is a telephone number outside callers can dial to reach users assigned to the call queue. Call queues are also assigned an internal extension, which can be dialed internally to reach users assigned to the call queue.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Only return call queues with matching location ID.

  • name (str) – Only return call queues with the matching name.

  • phone_number (str) – Only return call queues with matching primary phone number or extension.

  • department_id (str) – Return only call queues with the matching departmentId.

  • department_name (str) – Return only call queues with the matching departmentName.

  • org_id (str) – List call queues for this organization

  • params (dict) – dict of additional parameters passed directly to endpoint

Returns:

yields CallQueue objects

async list(location_id: str | None = None, name: str | None = None, phone_number: str | None = None, department_id: str | None = None, department_name: str | None = None, org_id: str | None = None, **params) List[CallQueue][source]

Read the List of Call Queues List all Call Queues for the organization.

Call queues temporarily hold calls in the cloud when all agents, which can be users or agents, assigned to receive calls from the queue are unavailable. Queued calls are routed to an available agent when not on an active call. Each call queue is assigned a Lead Number, which is a telephone number outside callers can dial to reach users assigned to the call queue. Call queues are also assigned an internal extension, which can be dialed internally to reach users assigned to the call queue.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Only return call queues with matching location ID.

  • name (str) – Only return call queues with the matching name.

  • phone_number (str) – Only return call queues with matching primary phone number or extension.

  • department_id (str) – Return only call queues with the matching departmentId.

  • department_name (str) – Return only call queues with the matching departmentName.

  • org_id (str) – List call queues for this organization

  • params (dict) – dict of additional parameters passed directly to endpoint

Returns:

yields CallQueue objects

async by_name(name: str, location_id: str | None = None, org_id: str | None = None) CallQueue | None[source]

Get queue info by name

Parameters:
  • location_id

  • name

  • org_id

Returns:

async create(location_id: str, settings: CallQueue, org_id: str | None = None) str[source]

Create a Call Queue Create new Call Queues for the given location.

Call queues temporarily hold calls in the cloud when all agents, which can be users or agents, assigned to receive calls from the queue are unavailable. Queued calls are routed to an available agent when not on an active call. Each call queue is assigned a Lead Number, which is a telephone number outside callers can dial to reach users assigned to the call queue. Call queues are also assigned an internal extension, which can be dialed internally to reach users assigned to the call queue.

Creating a call queue requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Create the call queue for this location.

  • settings (CallQueue) – parameters for queue creation.

  • org_id (str) – Create the call queue for this organization.

Returns:

queue id

Return type:

str

Example

settings = CallQueue(name=new_name,
                     extension=extension,
                     call_policies=CallQueueCallPolicies.default(),
                     queue_settings=QueueSettings.default(queue_size=10),
                     agents=[Agent(agent_id=user.person_id) for user in members])

# create new queue
queue_id = api.telephony.callqueue.create(location_id=target_location.location_id,
                                          settings=settings)
async delete_queue(location_id: str, queue_id: str, org_id: str | None = None)[source]

Delete a Call Queue Delete the designated Call Queue.

Call queues temporarily hold calls in the cloud when all agents, which can be users or agents, assigned to receive calls from the queue are unavailable. Queued calls are routed to an available agent when not on an active call. Each call queue is assigned a Lead Number, which is a telephone number outside callers can dial to reach users assigned to the call queue. Call queues are also assigned an internal extension, which can be dialed internally to reach users assigned to the call queue.

Deleting a call queue requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Location from which to delete a call queue.

  • queue_id (str) – Delete the call queue with the matching ID.

  • org_id (str) – Delete the call queue from this organization.

async details(location_id: str, queue_id: str, org_id: str | None = None) CallQueue[source]

Get Details for a Call Queue Retrieve Call Queue details.

Call queues temporarily hold calls in the cloud when all agents, which can be users or agents, assigned to receive calls from the queue are unavailable. Queued calls are routed to an available agent when not on an active call. Each call queue is assigned a Lead Number, which is a telephone number outside callers can dial to reach users assigned to the call queue. Call queues are also assigned anvinternal extension, which can be dialed internally to reach users assigned to the call queue.

Retrieving call queue details requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Retrieve settings for a call queue in this location

  • queue_id (str) – Retrieve settings for the call queue with this identifier.

  • org_id (str) – Retrieve call queue settings from this organization.

Returns:

call queue details

Return type:

CallQueue

async update(location_id: str, queue_id: str, update: CallQueue, org_id: str | None = None)[source]

Update a Call Queue

Update the designated Call Queue.

Call queues temporarily hold calls in the cloud when all agents, which can be users or agents, assigned to receive calls from the queue are unavailable. Queued calls are routed to an available agent when not on an active call. Each call queue is assigned a Lead Number, which is a telephone number outside callers can dial to reach users assigned to the call queue. Call queues are also assigned an internal extension, which can be dialed internally to reach users assigned to the call queue.

Updating a call queue requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Location in which this call queue exists.

  • queue_id (str) – Update setting for the call queue with the matching ID.

  • update (CallQueue) – updates

  • org_id – Update call queue settings from this organization.

Examples:

api = WebexSimpleApi()

# shortcut
cq = api.telephony.callqueue

# disable a call queue
update = CallQueue(enabled=False)
cq.update(location_id=...,
          queue_id=...,
          update=update)

# set the call routing policy to SIMULTANEOUS
update = CallQueue(call_policies=CallPolicies(policy=Policy.simultaneous))
cq.update(location_id=...,
          queue_id=...,
          update=update)
# don't bounce calls after the set number of rings.
update = CallQueue(
    call_policies=CallPolicies(
        call_bounce=CallBounce(
            enabled=False)))
cq.update(location_id=...,
          queue_id=...,
          update=update)

Alternatively you can also read call queue details, update them in place and then call update().

details = cq.details(location_id=...,
                     queue_id=...)
details.call_policies.call_bounce.agent_unavailable_enabled=False
details.call_policies.call_bounce.on_hold_enabled=False
cq.update(location_id=...,
          queue_id=...,
          update=details)
class wxc_sdk.as_api.AsCallRecordingApi(*, session: AsRestSession, selector: ApiSelector = ApiSelector.person)[source]

Bases: AsPersonSettingsApiChild

API for recording settings

Also used for virtual lines, workspaces

feature = 'callRecording'
async read(entity_id: str, org_id: str | None = None) CallRecordingSetting[source]

Read Call Recording Settings

Retrieve Call Recording Settings

The Call Recording feature provides a hosted mechanism to record the calls placed and received on the Carrier platform for replay and archival. This feature is helpful for quality assurance, security, training, and more.

This API requires a full or user administrator auth token with the spark-admin:people_write scope.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • org_id (str) – entity is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

async configure(entity_id: str, recording: CallRecordingSetting, org_id: str | None = None)[source]

Configure Call Recording Settings for a entity

Configure Call Recording Settings

The Call Recording feature provides a hosted mechanism to record the calls placed and received on the Carrier platform for replay and archival. This feature is helpful for quality assurance, security, training, and more.

This API requires a full or user administrator auth token with the spark-admin:people_write scope.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • recording (CallRecordingSetting) – the new recording settings

  • org_id (str) – entity is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

base = ''
class wxc_sdk.as_api.AsCallRecordingSettingsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Features: Call Recording

Not supported for Webex for Government (FedRAMP)

Features: Call Recording supports reading and writing of Webex Calling Call Recording settings for a specific organization.

Viewing these read-only organization settings requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Modifying these organization settings requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

A partner administrator can retrieve or change settings in a customer’s organization using the optional orgId query parameter.

async read(org_id: str | None = None) CallRecordingInfo[source]

Get Call Recording Settings

Retrieve Call Recording settings for the organization.

Call Recording feature enables authorized agents to record any active call that Webex Contact Center manages.

Retrieving call recording settings requires a full or read-only administrator or location administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:

org_id (str) – Retrieve call recording settings from this organization.

Return type:

CallRecordingInfo

async update(enabled: bool, org_id: str | None = None)[source]

Update Call Recording Settings

Update Call Recording settings for the organization.

Call Recording feature enables authorized agents to record any active call that Webex Contact Center manages.

Updating call recording settings requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

NOTE: This API is for Cisco partners only.

Parameters:
  • enabled (bool) – Whether or not the call recording is enabled.

  • org_id (str) – Retrieve call recording settings from this organization.

Return type:

None

async read_terms_of_service(vendor_id: str, org_id: str | None = None) CallRecordingTermsOfService[source]

Get Call Recording Terms Of Service Settings

Retrieve Call Recording Terms Of Service settings for the organization.

Call Recording feature enables authorized agents to record any active call that Webex Contact Center manages.

Retrieving call recording terms of service settings requires a full or read-only administrator or location administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • vendor_id (str) – Retrieve call recording terms of service details for the given vendor.

  • org_id (str) – Retrieve call recording terms of service details from this organization.

Return type:

CallRecordingTermsOfService

async update_terms_of_service(vendor_id: str, enabled: bool, org_id: str | None = None)[source]

Update Call Recording Terms Of Service Settings

Update Call Recording Terms Of Service settings for the given vendor.

Call Recording feature enables authorized agents to record any active call that Webex Contact Center manages.

Updating call recording terms of service settings requires a full administrator or location administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • vendor_id (str) – Update call recording terms of service settings for the given vendor.

  • enabled (bool) – Whether or not the call recording terms of service are enabled.

  • org_id (str) – Update call recording terms of service settings from this organization.

Return type:

None

async read_org_compliance_announcement(org_id: str | None = None) OrgComplianceAnnouncement[source]

Get Details for the organization compliance announcement setting

Retrieve the organization compliance announcement settings.

The Compliance Announcement feature interacts with the Call Recording feature, specifically with the playback of the start/stop announcement. When the compliance announcement is played to the PSTN party, and the PSTN party is connected to a party with call recording enabled, then the start/stop announcement is inhibited.

Retrieving organization compliance announcement setting requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:

org_id (str) – Retrieve compliance announcement setting from this organization.

Return type:

OrgComplianceAnnouncement

async update_org_compliance_announcement(settings: OrgComplianceAnnouncement, org_id: str | None = None)[source]

Update the organization compliance announcement

The Compliance Announcement feature interacts with the Call Recording feature, specifically with the playback of the start/stop announcement. When the compliance announcement is played to the PSTN party, and the PSTN party is connected to a party with call recording enabled, then the start/stop announcement is inhibited.

Updating the organization compliance announcement requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • settings (OrgComplianceAnnouncement) – new settings

  • org_id (str) – Update the compliance announcement setting from this organization.

Return type:

None

async read_location_compliance_announcement(location_id: str, org_id: str | None = None) LocationComplianceAnnouncement[source]

Get Details for the location compliance announcement setting

Retrieve the location compliance announcement settings.

The Compliance Announcement feature interacts with the Call Recording feature, specifically with the playback of the start/stop announcement. When the compliance announcement is played to the PSTN party, and the PSTN party is connected to a party with call recording enabled, then the start/stop announcement is inhibited.

Retrieving location compliance announcement setting requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Retrieve compliance announcement settings for this location.

  • org_id (str) – Retrieve compliance announcement setting from this organization.

Return type:

LocationComplianceAnnouncement

async update_location_compliance_announcement(location_id: str, settings: LocationComplianceAnnouncement, org_id: str | None = None)[source]

Update the location compliance announcement

The Compliance Announcement feature interacts with the Call Recording feature, specifically with the playback of the start/stop announcement. When the compliance announcement is played to the PSTN party, and the PSTN party is connected to a party with call recording enabled, then the start/stop announcement is inhibited.

Updating the location compliance announcement requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Update the compliance announcement settings for this location.

  • settings (LocationComplianceAnnouncement) – new settings

  • org_id (str) – Update the compliance announcement setting from this organization.

Return type:

None

base = 'telephony/config'
class wxc_sdk.as_api.AsCallWaitingApi(*, session: AsRestSession, selector: ApiSelector = ApiSelector.person)[source]

Bases: AsPersonSettingsApiChild

API for person’s call waiting settings

Also used for virtual lines, worekspaces

feature = 'callWaiting'
async read(entity_id: str, org_id: str | None = None) bool[source]

Read Call Waiting Settings for

Retrieve Call Waiting Settings

With this feature, an entity can place an active call on hold and answer an incoming call. When enabled, while you are on an active call, a tone alerts you of an incoming call and you can choose to answer or ignore the call.

This API requires a full, user, or read-only administrator auth token with a scope of spark-admin:people_read.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • org_id (str) – entity is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

Returns:

call waiting setting

Return type:

bool

async configure(entity_id: str, enabled: bool, org_id: str | None = None)[source]

Configure Call Waiting Settings

Configure an entity’s Call Waiting Settings

With this feature, a entity can place an active call on hold and answer an incoming call. When enabled, while you are on an active call, a tone alerts you of an incoming call and you can choose to answer or ignore the call.

This API requires a full or user administrator auth token with the spark-admin:people_write scope.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • enabled (bool) – true if the Call Waiting feature is enabled.

  • org_id (str) – entity is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

base = ''
class wxc_sdk.as_api.AsCallerIdApi(*, session: AsRestSession, selector: ApiSelector = ApiSelector.person)[source]

Bases: AsPersonSettingsApiChild

API for caller id settings

Also used for: virtual lines, workspaces

feature = 'callerId'
async read(entity_id: str, org_id: str | None = None) CallerId[source]

Retrieve Caller ID Settings

Caller ID settings control how a entity’s information is displayed when making outgoing calls.

This API requires a full, user, or read-only administrator auth token with a scope of spark-admin:people_read or a user auth token with spark:people_read scope can be used by a entity to read their settings.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • org_id (str) – entity is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

async configure(entity_id: str, org_id: str | None = None, selected: CallerIdSelectedType | None = None, custom_number: str | None = None, first_name: str | None = None, last_name: str | None = None, external_caller_id_name_policy: ExternalCallerIdNamePolicy | None = None, custom_external_caller_id_name: str | None = None)[source]

Configure a Caller ID Settings

Caller ID settings control how a entity’s information is displayed when making outgoing calls.

This API requires a full or user administrator auth token with the spark-admin:people_write scope or a user auth token with spark:people_write scope can be used by a entity to update their own settings.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • org_id (str) – entity is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

  • selected (CallerIdSelectedType) – Which type of outgoing Caller ID will be used.

  • custom_number (str) – This value must be an assigned number from the entity’s location.

  • first_name (str) – entity’s Caller ID first name. Characters of %, +, `, “ and Unicode characters are not allowed.

  • last_name (str) – entity’s Caller ID last name. Characters of %, +, `, “ and Unicode characters are not allowed.

  • external_caller_id_name_policy (ExternalCallerIdNamePolicy) – Designates which type of External Caller ID Name policy is used. Default is DIRECT_LINE.

  • custom_external_caller_id_name (str) – Custom External Caller Name, which will be shown if External Caller ID Name is OTHER.

async configure_settings(entity_id: str, settings: CallerId, org_id: str | None = None)[source]

Configure a Caller ID Settings

Caller ID settings control how a entity’s information is displayed when making outgoing calls.

This API requires a full or user administrator auth token with the spark-admin:people_write scope or a user auth token with spark:people_write scope can be used by a entity to update their own settings.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • settings (CallerId) – new settings

  • org_id (str) – entity is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

Example

api = self.api.telephony.virtual_lines.caller_id
caller_id_settings = api.read(entity_id=self.target.id)
caller_id_settings.block_in_forward_calls_enabled = True
api.configure_settings(entity_id=self.target.id, settings=caller_id_settings)
base = ''
class wxc_sdk.as_api.AsCallingBehaviorApi(*, session: AsRestSession, selector: ApiSelector = ApiSelector.person)[source]

Bases: AsPersonSettingsApiChild

API for person’s calling behavior settings

feature = 'callingBehavior'
async read(person_id: str, org_id: str | None = None) CallingBehavior[source]

Read Person’s Calling Behavior

Retrieves the calling behavior and UC Manager Profile settings for the person which includes overall calling behavior and calling UC Manager Profile ID.

Webex Calling Behavior controls which Webex telephony application is to be used.

An organization has an organization-wide default Calling Behavior that may be overridden for individual persons.

In addition, UC Manager Profiles are applicable if your organization uses Jabber in Team Messaging mode or Calling in Webex Teams (Unified CM).

The UC Manager Profile also has an organization-wide default and may be overridden for individual persons.

This API requires a full, user, or read-only administrator auth token with a scope of spark-admin:people_read.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • org_id (str) – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

Returns:

calling behavior setting

Return type:

CallingBehavior

async configure(person_id: str, settings: CallingBehavior, org_id: str | None = None)[source]

Configure a Person’s Calling Behavior

Modifies the calling behavior settings for the person which includes overall calling behavior and UC Manager Profile ID.

Webex Calling Behavior controls which Webex telephony application is to be used.

An organization has an organization-wide default Calling Behavior that may be overridden for individual persons.

In addition, UC Manager Profiles are applicable if your organization uses Jabber in Team Messaging mode or Calling in Webex Teams (Unified CM).

The UC Manager Profile also has an organization-wide default and may be overridden for individual persons.

This API requires a full or user administrator auth token with the spark-admin:people_write scope.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • settings (CallingBehavior) – new settings

  • org_id (str) – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

base = ''
class wxc_sdk.as_api.AsCallparkExtensionApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Call Park Extension API

list_gen(extension: str | None = None, name: str | None = None, location_id: str | None = None, location_name: str | None = None, order: str | None = None, org_id: str | None = None, **params) AsyncGenerator[CallParkExtension, None, None][source]

Read the List of Call Park Extensions

List all Call Park Extensions for the organization.

The Call Park service, enabled for all users by default, allows a user to park a call against an available user’s extension or to a Call Park Extension. Call Park Extensions are extensions defined within the Call Park service for holding parked calls.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • extension (str) – Only return call park extensions with the matching extension.

  • name (str) – Only return call park extensions with the matching name.

  • location_id (str) – Only return call park extensions with matching location ID.

  • location_name (str) – Only return call park extensions with matching location name.

  • order (str) – Order the available agents according to the designated fields. Available sort fields: groupName, callParkExtension, callParkExtensionName, callParkExtensionExternalId.

  • org_id (str) – List call park extensions for this organization.

  • params – additional parameters

Returns:

yields wxc_sdk.common.CallParkExtension instances

async list(extension: str | None = None, name: str | None = None, location_id: str | None = None, location_name: str | None = None, order: str | None = None, org_id: str | None = None, **params) List[CallParkExtension][source]

Read the List of Call Park Extensions

List all Call Park Extensions for the organization.

The Call Park service, enabled for all users by default, allows a user to park a call against an available user’s extension or to a Call Park Extension. Call Park Extensions are extensions defined within the Call Park service for holding parked calls.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • extension (str) – Only return call park extensions with the matching extension.

  • name (str) – Only return call park extensions with the matching name.

  • location_id (str) – Only return call park extensions with matching location ID.

  • location_name (str) – Only return call park extensions with matching location name.

  • order (str) – Order the available agents according to the designated fields. Available sort fields: groupName, callParkExtension, callParkExtensionName, callParkExtensionExternalId.

  • org_id (str) – List call park extensions for this organization.

  • params – additional parameters

Returns:

yields wxc_sdk.common.CallParkExtension instances

async details(location_id: str, cpe_id: str, org_id: str | None = None) CallParkExtension[source]

Get Details for a Call Park Extension

Retrieve Call Park Extension details.

The Call Park service, enabled for all users by default, allows a user to park a call against an available user’s extension or to a Call Park Extension. Call Park Extensions are extensions defined within the Call Park service for holding parked calls.

Retrieving call park extension details requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Retrieve details for a call park extension in this location.

  • cpe_id (str) – Retrieve details for a call park extension with the matching ID.

  • org_id (str) – Retrieve call park extension details from this organization

Returns:

call park extension details

Return type:

wxc_sdk.common.CallParkExtension instance (only name and extension are set)

async create(location_id: str, name: str, extension: str, org_id: str | None = None) str[source]

Create new Call Park Extensions for the given location. Call Park Extension enables a call recipient to park a call to an extension, so someone else within the same Organization can retrieve the parked call by dialing that extension. Call Park Extensions can be added as monitored lines by users’ Cisco phones, so users can park and retrieve calls by pressing the associated phone line key. Creating a call park extension requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Create the call park extension for this location.

  • name (str) – Name for the call park extension. The maximum length is 30.

  • extension (str) – Unique extension which will be assigned to call park extension. The minimum length is 2, maximum length is 10.

  • org_id (str) – Create the call park extension for this organization.

Returns:

id of the new call park extension

Return type:

str

async delete(location_id: str, cpe_id: str, org_id: str | None = None)[source]

Delete the designated Call Park Extension. Call Park Extension enables a call recipient to park a call to an extension, so someone else within the same Organization can retrieve the parked call by dialing that extension. Call Park Extensions can be added as monitored lines by users’ Cisco phones, so users can park and retrieve calls by pressing the associated phone line key. Deleting a call park extension requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Location from which to delete a call park extension.

  • cpe_id (str) – Delete the call park extension with the matching ID.

  • org_id (str) – Delete the call park extension from this organization.

async update(location_id: str, cpe_id: str, name: str | None = None, extension: str | None = None, org_id: str | None = None)[source]

Update the designated Call Park Extension. Call Park Extension enables a call recipient to park a call to an extension, so someone else within the same Organization can retrieve the parked call by dialing that extension. Call Park Extensions can be added as monitored lines by users’ Cisco phones, so users can park and retrieve calls by pressing the associated phone line key. Updating a call park extension requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Location in which this call park extension exists.

  • cpe_id (str) – Update a call park extension with the matching ID.

  • name (str) – Name for the call park extension. The maximum length is 30.

  • extension (str) – Unique extension which will be assigned to call park extension. The minimum length is 2, maximum length is 10.

  • org_id (str) – Update a call park extension from this organization.

base = 'telephony'
class wxc_sdk.as_api.AsCallsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

async dial(destination: str) DialResponse[source]

Initiate an outbound call to a specified destination. This is also commonly referred to as Click to Call or Click to Dial. Alerts on all the devices belonging to the user. When the user answers on one of these alerting devices, an outbound call is placed from that device to the destination.

Parameters:

destination (str) – The destination to be dialed. The destination can be digits or a URI. Some examples for destination include: 1234, 2223334444, +12223334444, *73, tel:+12223334444, user@company.domain, sip:user@company.domain

Returns:

Call id and call session id

async answer(call_id: str, endpoint_id: str | None = None)[source]

Answer an incoming call. When no endpointId is specified, the call is answered on the user’s primary device. When an endpointId is specified, the call is answered on the device or application identified by the endpointId. The answer API is rejected if the device is not alerting for the call or the device does not support answer via API.

Parameters:
  • call_id (str) – The call identifier of the call to be answered.

  • endpoint_id (str) – The ID of the device or application to answer the call on. The endpointId must be one of the endpointIds returned by wxc_sdk.person_settings.preferred_answer.AsPreferredAnswerApi.read()

async reject(call_id: str, action: RejectAction | None = None)[source]

Reject an unanswered incoming call.

Parameters:
  • call_id (str) – The call identifier of the call to be rejected.

  • action – The rejection action to apply to the call. The busy action is applied if no specific action is provided.

async hangup(call_id: str)[source]

Hangup a call. If used on an unanswered incoming call, the call is rejected and sent to busy.

Parameters:

call_id (str) – The call identifier of the call to hangup.

async hold(call_id: str)[source]

Hold a connected call.

Parameters:

call_id (str) – The call identifier of the call to hold.

async resume(call_id: str)[source]

Resume a held call.

Parameters:

call_id (str) – The call identifier of the call to resume.

async divert(call_id: str, destination: str | None = None, to_voicemail: bool | None = None)[source]

Divert a call to a destination or a user’s voicemail. This is also commonly referred to as Blind Transfer

Parameters:
  • call_id (str) – The call identifier of the call to divert.

  • destination (str) – The destination to divert the call to. If toVoicemail is false, destination is required. The destination can be digits or a URI. Some examples for destination include: 1234, 2223334444, +12223334444, *73, tel:+12223334444, user@company.domain, sip:user@company.domain

  • to_voicemail (bool) – If set to true, the call is diverted to voicemail. If no destination is specified, the call is diverted to the user’s own voicemail. If a destination is specified, the call is diverted to the specified user’s voicemail.

async transfer(call_id1: str | None = None, call_id2: str | None = None, destination: str | None = None)[source]

Transfer two calls together. Unanswered incoming calls cannot be transferred but can be diverted using the divert API. If the user has only two calls and wants to transfer them together, the callId1 and callId2 parameters are optional and when not provided the calls are automatically selected and transferred. If the user has more than two calls and wants to transfer two of them together, the callId1 and callId2 parameters are mandatory to specify which calls are being transferred. These are also commonly referred to as Attended Transfer, Consultative Transfer, or Supervised Transfer and will return a 204 response. If the user wants to transfer one call to a new destination but only when the destination responds, the callId1 and destination parameters are mandatory to specify the call being transferred and the destination. This is referred to as a Mute Transfer and is similar to the divert API with the difference of waiting for the destination to respond prior to transferring the call. If the destination does not respond, the call is not transferred. This will return a 201 response.

Parameters:
  • call_id1 (str) – The call identifier of the first call to transfer. This parameter is mandatory if either call_id2 or destination is provided.

  • call_id2 – The call identifier of the first call to transfer. This parameter is mandatory if either callId2 or destination is provided.

  • destination (str) – The destination to be transferred to. The destination can be digits or a URI. Some examples for destination include: 1234, 2223334444, +12223334444, *73, tel:+12223334444, user@company.domain, sip:user@company.domain. This parameter is mandatory if call_id1 is provided and call_id2 is not provided.

async park(call_id: str, destination: str | None = None, is_group_park: bool | None = None) ParkedAgainst[source]

Park a connected call. The number field in the response can be used as the destination for the retrieve command to retrieve the parked call.

Parameters:
  • call_id (str) – The call identifier of the call to park.

  • destination (str) – Identifies where the call is to be parked. If not provided, the call is parked against the parking user. The destination can be digits or a URI. Some examples for destination include: 1234, 2223334444, +12223334444, *73, tel:+12223334444, user@company.domain, sip:user@company.domain

  • is_group_park (bool) – If set to true, the call is parked against an automatically selected member of the user’s call park group and the destination parameter is ignored.

Returns:

The details of where the call has been parked.

Return type:

ParkedAgainst

async retrieve(destination: str) CallInfo[source]
Parameters:

destination – Identifies where the call is parked. The number field from the park command response can be used as the destination for the retrieve command. If not provided, the call parked against the retrieving user is retrieved. The destination can be digits or a URI. Some examples for destination include: 1234, 2223334444, +12223334444, *73, tel:+12223334444, user@company.domain, sip:user@company.domain

Returns:

call id and call session id of retreived call

Return type:

CallInfo

async start_recording(call_id: str)[source]

Start recording a call. Use of this API is only valid when the user’s call recording mode is set to “On Demand”.

Parameters:

call_id (str) – The call identifier of the call to start recording.

async stop_recording(call_id: str)[source]

Stop recording a call. Use of this API is only valid when a call is being recorded and the user’s call recording mode is set to “On Demand”.

Parameters:

call_id (str) – The call identifier of the call to stop recording.

async pause_recording(call_id: str)[source]

Pause recording on a call. Use of this API is only valid when a call is being recorded and the user’s call recording mode is set to “On Demand” or “Always with Pause/Resume”.

Parameters:

call_id (str) – The call identifier of the call to pause recording.

async resume_recording(call_id: str)[source]

Resume recording a call. Use of this API is only valid when a call’s recording is paused and the user’s call recording mode is set to “On Demand” or “Always with Pause/Resume”.

Parameters:

call_id (str) – The call identifier of the call to resume recording.

async transmit_dtmf(call_id: str, dtmf: str)[source]

Transmit DTMF digits to a call.

Parameters:
  • call_id (str) – The call identifier of the call to hold.

  • dtmf – The DTMF digits to transmit. Each digit must be part of the following set: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, *, #, A, B, C, D]. A comma “,” may be included to indicate a pause between digits. For the value “1,234”, the DTMF 1 digit is initially sent. After a pause, the DTMF 2, 3, and 4 digits are sent successively.

async push(call_id: str)[source]

Pushes a call from the assistant to the executive the call is associated with. Use of this API is only valid when the assistant’s call is associated with an executive.

Parameters:

call_id (str) – The call identifier of the call to push.

async pickup(target: str) CallInfo[source]

Picks up an incoming call to another user. A new call is initiated to perform the pickup in a similar manner to the dial command. When target is not present, the API pickups up a call from the user’s call pickup group. When target is present, the API pickups an incoming call from the specified target user.

Parameters:

target (str) – Identifies the user to pickup an incoming call from. If not provided, an incoming call to the user’s call pickup group is picked up. The target can be digits or a URI. Some examples for target include: 1234, 2223334444, +12223334444, tel:+12223334444, user@company.domain, sip:user@company.domain

Returns:

call info of picked up call

Return type:

CallInfo

async barge_in(target: str)[source]

Barge-in on another user’s answered call. A new call is initiated to perform the barge-in in a similar manner to the dial command.

Parameters:

target (str) – Identifies the user to barge-in on. The target can be digits or a URI. Some examples for target include: 1234, 2223334444, +12223334444, tel:+12223334444, user@company.domain, sip:user@company.domain

Returns:

call info of picked up call

Return type:

CallInfo

list_calls_gen() AsyncGenerator[TelephonyCall, None, None][source]

Get the list of details for all active calls associated with the user.

Returns:

yield TelephonyCall

async list_calls() List[TelephonyCall][source]

Get the list of details for all active calls associated with the user.

Returns:

yield TelephonyCall

async call_details(call_id: str) TelephonyCall[source]

Get the details of the specified active call for the user.

Parameters:

call_id (str) – The call identifier of the call.

Returns:

call details

Return type:

TelephonyCall

call_history_gen(history_type: str | HistoryType | None = None) AsyncGenerator[CallHistoryRecord, None, None][source]

List Call History Get the list of call history records for the user. A maximum of 20 call history records per type (placed, missed, received) are returned.

Parameters:

history_type (HistoryType or str) – The type of call history records to retrieve. If not specified, then all call history records are retrieved. Possible values: placed, missed, received

Returns:

yields CallHistoryRecord objects

async call_history(history_type: str | HistoryType | None = None) List[CallHistoryRecord][source]

List Call History Get the list of call history records for the user. A maximum of 20 call history records per type (placed, missed, received) are returned.

Parameters:

history_type (HistoryType or str) – The type of call history records to retrieve. If not specified, then all call history records are retrieved. Possible values: placed, missed, received

Returns:

yields CallHistoryRecord objects

base = 'telephony/calls'
class wxc_sdk.as_api.AsDECTDevicesApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

DECT Devices Settings

Not supported for Webex for Government (FedRAMP)

DECT APIs allow the admin to create a DECT network, and add base stations and handsets to the DECT network. People, places and virtual lines member types are supported on handset lines in the DECT network. Currently, APIs support Cisco DECT device models only.

Viewing and searching DECT settings requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Adding and modifying these DECT settings requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

async create_dect_network(location_id: str, name: str, display_name: str, model: DECTNetworkModel, default_access_code_enabled: bool, default_access_code: str, org_id: str | None = None) str[source]

Create a DECT Network

Create a multi-cell DECT network for a given location.

Creating a DECT network requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Create a DECT network in this location.

  • name (str) – Name of the DECT network. Min and max length supported for the DECT network name are 1 and 40 respectively.

  • display_name (str) – Add a default name (11 characters max) to display for all handsets. If left blank, the default name will be an indexed number followed by the DECT network name.

  • model (DECTNetworkModel) – Select a device model type depending on the number of base stations and handset lines needed in the DECT network.

  • default_access_code_enabled (bool) – If set to true, need to provide a default access code that will be shared for all users in this network to pair their lines to the next available handset. Otherwise, each user will get a unique 4-digit access code that will be auto-generated. Note: There is currently no public API to retrieve the auto generated access codes for handsets. Use Control Hub instead.

  • default_access_code (str) – If defaultAccessCodeEnabled is set to true, then provide a default access code that needs to be a 4-numeric digit. The access code should be unique to the DECT network for the location.

  • org_id (str) – Create a DECT network in this organization

Return type:

str

async list_dect_networks(name: str | None = None, location_id: str | None = None, org_id: str | None = None) list[DECTNetworkDetail][source]

Get the List of DECT Networks for an organization

Retrieves the list of DECT networks for an organization.

DECT Networks provide roaming voice services via base stations and wireless handsets. A DECT network can be provisioned up to 1000 lines across up to 254 base stations.

This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • name (str) – List of DECT networks with this name.

  • location_id (str) – List of DECT networks at this location.

  • org_id (str) – List of DECT networks in this organization.

Return type:

list[DECTNetworkDetail]

async dect_network_details(location_id: str, dect_network_id: str, org_id: str | None = None) DECTNetworkDetail[source]

Get DECT Network Details

Retrieves the details of a DECT network.

DECT Networks provide roaming voice services via base stations and wireless handsets. A DECT network can be provisioned up to 1000 lines across up to 254 base stations.

This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Details of the DECT network at this location.

  • dect_network_id (str) – Details of the specified DECT network.

  • org_id (str) – Details of the DECT network in this organization.

Return type:

DECTNetworkDetail

async update_dect_network(location_id: str, dect_network_id: str, name: str, default_access_code_enabled: bool, default_access_code: str | None = None, display_name: str | None = None, org_id: str | None = None)[source]

Update DECT Network

Update the details of a DECT network.

DECT Networks provide roaming voice services via base stations and wireless handsets. A DECT network can be provisioned up to 1000 lines across up to 254 base stations.

This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Update DECT network details in the specified location.

  • dect_network_id (str) – Update DECT network details in the specified DECT network.

  • name (str) – Name of the DECT network. This should be unique across the location.

  • default_access_code_enabled (bool) – Default access code is enabled. If true, the default access code is mandatory. If false, an auto-generated access code is used.

  • default_access_code (str) – Default access code for the DECT network. The default access code should be unique within the same location to avoid the handset accidentally registering with base stations from different DECT networks in range. This is mandatory when defaultAccessCodeEnabled is true.

  • display_name (str) – DECT network name that will be displayed on the handset.

  • org_id (str) – Update DECT network details in the specified organization.

Return type:

None

async update_dect_network_settings(settings: DECTNetworkDetail, org_id: str | None = None)[source]

Update DECT Network from settings

Update the details of a DECT network from settings.

DECT Networks provide roaming voice services via base stations and wireless handsets. A DECT network can be provisioned up to 1000 lines across up to 254 base stations.

This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • settings – DECT Network to update. location.id and id are used to address the DECT network to be updated. Only name, display_name, default_access_code_enabled, default_access_code are considered for the update

  • org_id (str) – Update DECT network details in the specified organization.

Return type:

None

async delete_dect_network(location_id: str, dect_network_id: str, org_id: str | None = None)[source]

Delete DECT Network

Delete a DECT network.

DECT Networks provide roaming voice services via base stations and wireless handsets. A DECT network can be provisioned up to 1000 lines across up to 254 base stations.

This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Delete the DECT network in the specified location.

  • dect_network_id (str) – Delete the specified DECT network.

  • org_id (str) – Delete the DECT network in the specified organization.

Return type:

None

async create_base_stations(location_id: str, dect_id: str, base_station_macs: list[str], org_id: str | None = None) list[BaseStationResponse][source]

Create Multiple Base Stations

This API is used to create multiple base stations in a DECT network in an organization.

Creating base stations in a DECT network requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Create a base station in this location.

  • dect_id (str) – Create a base station for the DECT network.

  • base_station_macs (list[str]) – Array of base stations.

  • org_id (str) – Create a base station for a DECT network in this organization.

Return type:

list[BaseStationResponse]

async list_base_stations(location_id: str, dect_network_id: str, org_id: str | None = None) list[BaseStationsResponse][source]

Get a list of DECT Network Base Stations

Retrieve a list of base stations in a DECT Network.

A DECT network supports 2 types of base stations, DECT DBS-110 Single-Cell and DECT DBS-210 Multi-Cell. A DECT DBS-110 allows up to 30 lines of registration and supports 1 base station only. A DECT DBS-210 can have up to 254 base stations and supports up to 1000 lines of registration.

This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Location containing the DECT network.

  • dect_network_id (str) – Retrieve the list of base stations in the specified DECT network ID.

  • org_id (str) – Organization containing the DECT network.

Return type:

list[BaseStationsResponse]

async base_station_details(location_id: str, dect_network_id: str, base_station_id: str, org_id: str | None = None) BaseStationDetail[source]

Get the details of a specific DECT Network Base Station

Retrieve details of a specific base station in the DECT Network.

A DECT network supports 2 types of base stations, DECT DBS-110 Single-Cell and DECT DBS-210 Multi-Cell. A DECT DBS-110 allows up to 30 lines of registration and supports 1 base station only. A DECT DBS-210 can have up to 254 base stations and supports up to 1000 lines of registration.

This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Location containing the DECT network.

  • dect_network_id (str) – Retrieve details of a specific base station in the specified DECT network ID.

  • base_station_id (str) – Retrieve details of the specific DECT base station ID.

  • org_id (str) – Organization containing the DECT network.

Return type:

BaseStationDetail

async delete_bulk_base_stations(location_id: str, dect_network_id: str, org_id: str | None = None)[source]

Delete bulk DECT Network Base Stations

Delete all the base stations in the DECT Network.

A DECT network supports 2 types of base stations, DECT DBS-110 Single-Cell and DECT DBS-210 Multi-Cell. A DECT DBS-110 allows up to 30 lines of registration and supports 1 base station only. A DECT DBS-210 can have up to 254 base stations and supports up to 1000 lines of registration.

This API requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Location containing the DECT network.

  • dect_network_id (str) – Delete all the base stations in the specified DECT network ID.

  • org_id (str) – Organization containing the DECT network.

Return type:

None

async delete_base_station(location_id: str, dect_network_id: str, base_station_id: str, org_id: str | None = None)[source]

Delete a specific DECT Network Base Station

Delete a specific base station in the DECT Network.

A DECT network supports 2 types of base stations, DECT DBS-110 Single-Cell and DECT DBS-210 Multi-Cell. A DECT DBS-110 allows up to 30 lines of registration and supports 1 base station only. A DECT DBS-210 can have up to 254 base stations and supports up to 1000 lines of registration.

This API requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Location containing the DECT network.

  • dect_network_id (str) – Delete a specific base station in the specified DECT network ID.

  • base_station_id (str) – Delete the specific DECT base station ID.

  • org_id (str) – Organization containing the DECT network.

Return type:

None

async add_a_handset(location_id: str, dect_network_id: str, line1_member_id: str, line2_member_id: str | None = None, custom_display_name: str | None = None, org_id: str | None = None)[source]

Add a Handset to a DECT Network

Add a handset to a DECT network in a location in an organization.

Adding a handset to a DECT network requires a full administrator auth token with a scope of spark-admin:telephony_config_write

Parameters:
  • location_id (str) – Add handset in this location.

  • dect_network_id (str) – A unique identifier for the DECT network.

  • line1_member_id (str) – ID of the member on line1 of the handset. Members can be PEOPLE or PLACE.

  • line2_member_id (str) – ID of the member on line2 of the handset. Members can be PEOPLE, PLACE, or VIRTUAL_LINE.

  • custom_display_name (str) – Custom display name on the handset. Min and max length supported for the custom display name is 1 and 16 respectively. Mandatory parameter.

  • org_id (str) – Add handset in this organization.

Return type:

None

async list_handsets(location_id: str, dect_network_id: str, basestation_id: str | None = None, member_id: str | None = None, org_id: str | None = None) DECTHandsetList[source]

Get List of Handsets for a DECT Network ID

List all the handsets associated with a DECT Network ID.

A handset can have up to two lines, and a DECT network supports a total of 120 lines across all handsets. A member on line1 of a DECT handset can be of type PEOPLE or PLACE while a member on line2 of a DECT handset can be of type PEOPLE, PLACE, or VIRTUAL_LINE.

This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Location containing the DECT network.

  • dect_network_id (str) – Search handset details in the specified DECT network ID.

  • basestation_id (str) – Search handset details in the specified DECT base station ID.

  • member_id (str) – ID of the member of the handset. Members can be of type PEOPLE, PLACE, or VIRTUAL_LINE.

  • org_id (str) – Organization containing the DECT network.

Return type:

DECTHandsetList

async handset_details(location_id: str, dect_network_id: str, handset_id: str, org_id: str | None = None) DECTHandsetItem[source]

Get Specific DECT Network Handset Details

List the specific DECT Network handset details.

A handset can have up to two lines, and a DECT network supports a total of 120 lines across all handsets. A member on line1 of a DECT handset can be of type PEOPLE or PLACE while a member on line2 of a DECT handset can be of type PEOPLE, PLACE, or VIRTUAL_LINE.

This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Location containing the DECT network.

  • dect_network_id (str) – Search handset details in the specified DECT network ID.

  • handset_id (str) – A unique identifier for the handset.

  • org_id (str) – Organization containing the DECT network.

Return type:

DECTHandsetGet

async update_handset(location_id: str, dect_network_id: str, handset_id: str, line1_member_id: str, custom_display_name: str, line2_member_id: str | None = None, org_id: str | None = None)[source]

Update DECT Network Handset

Update the line assignment on a handset.

A handset can have up to two lines, and a DECT network supports a total of 120 lines across all handsets. A member on line1 of a DECT handset can be of type PEOPLE or PLACE while a member on line2 of a DECT handset can be of type PEOPLE, PLACE, or VIRTUAL_LINE.

Updating a DECT Network handset requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Location containing the DECT network.

  • dect_network_id (str) – Update handset details in the specified DECT network.

  • handset_id (str) – A unique identifier for the handset.

  • line1_member_id (str) – ID of the member on line1 of the handset. Members can be PEOPLE or PLACE.

  • custom_display_name (str) – Custom display name on the handset.

  • line2_member_id (str) – ID of the member on line2 of the handset. Members can be PEOPLE, PLACE, or VIRTUAL_LINE.

  • org_id (str) – Organization containing the DECT network.

Return type:

None

async delete_handset(location_id: str, dect_network_id: str, handset_id: str, org_id: str | None = None)[source]

Delete specific DECT Network Handset Details

Delete a specific DECT Network handset.

A handset can have up to two lines, and a DECT network supports a total of 120 lines across all handsets. A member on line1 of a DECT handset can be of type PEOPLE or PLACE while a member on line2 of a DECT handset can be of type PEOPLE, PLACE, or VIRTUAL_LINE.

This API requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Location containing the DECT network.

  • dect_network_id (str) – Delete handset details in the specified DECT network ID.

  • handset_id (str) – A unique identifier for the handset.

  • org_id (str) – Organization containing the DECT network.

Return type:

None

async delete_handsets(location_id: str, dect_network_id: str, handset_ids: list[str], delete_all: bool | None = None, org_id: str | None = None)[source]

Delete multiple handsets

Delete multiple handsets or all of them.

A handset can have up to two lines, and a DECT network supports a total of 120 lines across all handsets. A member on line1 of a DECT handset can be of type PEOPLE or PLACE while a member on line2 of a DECT handset can be of type PEOPLE, PLACE, or VIRTUAL_LINE.

This API requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Location containing the DECT network.

  • dect_network_id (str) – Delete handset details in the specified DECT network ID.

  • handset_ids (list[str]) – Array of the handset IDs to be deleted.

  • delete_all (bool) – If present the items array is ignored and all items in the context are deleted.

  • org_id (str) – Organization containing the DECT network.

Return type:

None

async dect_networks_associated_with_person(person_id: str, org_id: str | None = None) list[AssignedDectNetwork][source]

GET List of DECT networks associated with a Person

Retrieves the list of DECT networks for a person in an organization.

DECT Network provides roaming voice services via base stations and wireless handsets. DECT network can be provisioned up to 1000 lines across up to 254 base stations.

This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • person_id (str) – List of DECT networks associated with this person.

  • org_id (str) – List of DECT networks associated with a person in this organization.

Return type:

list[AssignedDectNetwork]

async dect_networks_associated_with_workspace(workspace_id: str, org_id: str | None = None) list[AssignedDectNetwork][source]

GET List of DECT networks associated with a workspace

Retrieves the list of DECT networks for a workspace in an organization.

DECT Network provides roaming voice services via base stations and wireless handsets. DECT network can be provisioned up to 1000 lines across up to 254 base stations.

This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • workspace_id (str) – List of DECT networks associated with this workspace.

  • org_id (str) – List of DECT networks associated with a workspace in this organization.

Return type:

list[AssignedDectNetwork]

async dect_networks_associated_with_virtual_line(virtual_line_id: str, org_id: str | None = None) list[AssignedDectNetwork][source]

Get List of Dect Networks Handsets for a Virtual Line

Retrieve DECT Network details assigned for a virtual line.

Virtual line is a capability in Webex Calling that allows administrators to configure multiple lines to Webex Calling users.

Retrieving the assigned device detials for a virtual line requires a full or user or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • virtual_line_id (str) – Retrieve settings for a virtual line with the matching ID.

  • org_id (str) – Retrieve virtual line settings from this organization.

Return type:

list[AssignedDectNetwork]

available_members_gen(member_name: str | None = None, phone_number: str | None = None, extension: str | None = None, location_id: str | None = None, order: str | None = None, exclude_virtual_line: bool | None = None, usage_type: UsageType | None = None, org_id: str | None = None, **params) AsyncGenerator[AvailableMember, None, None][source]

Search Available Members

List the members that are available to be assigned to DECT handset lines.

This requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • member_name (str) – Search (Contains) numbers based on member name.

  • phone_number (str) – Search (Contains) based on number.

  • extension (str) – Search (Contains) based on extension.

  • location_id (str) – List members for the location ID.

  • order (str) – Sort the list of available members on the device in ascending order by name, using either last name lname or first name fname. Default sort is the last name in ascending order.

  • exclude_virtual_line (bool) – If true, search results will exclude virtual lines in the member list. NOTE: Virtual lines cannot be assigned as the primary line.

  • usage_type (UsageType) – Search for members eligible to become the owner of the device, or share line on the device.

  • org_id (str) – Search members in this organization.

Returns:

Generator yielding AvailableMember instances

async available_members(member_name: str | None = None, phone_number: str | None = None, extension: str | None = None, location_id: str | None = None, order: str | None = None, exclude_virtual_line: bool | None = None, usage_type: UsageType | None = None, org_id: str | None = None, **params) List[AvailableMember][source]

Search Available Members

List the members that are available to be assigned to DECT handset lines.

This requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • member_name (str) – Search (Contains) numbers based on member name.

  • phone_number (str) – Search (Contains) based on number.

  • extension (str) – Search (Contains) based on extension.

  • location_id (str) – List members for the location ID.

  • order (str) – Sort the list of available members on the device in ascending order by name, using either last name lname or first name fname. Default sort is the last name in ascending order.

  • exclude_virtual_line (bool) – If true, search results will exclude virtual lines in the member list. NOTE: Virtual lines cannot be assigned as the primary line.

  • usage_type (UsageType) – Search for members eligible to become the owner of the device, or share line on the device.

  • org_id (str) – Search members in this organization.

Returns:

Generator yielding AvailableMember instances

base = 'telephony/config'
class wxc_sdk.as_api.AsDetailedCDRApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

To retrieve Detailed Call History information, you must use a token with the spark-admin:calling_cdr_read scope. The authenticating user must be a read-only-admin or full-admin of the organization and have the administrator role “Webex Calling Detailed Call History API access” enabled.

Detailed Call History information is available 5 minutes after a call has ended and may be retrieved for up to 48 hours. For example, if a call ends at 9:46 am, the record for that call can be collected using the API from 9:51 am, and is available until 9:46 am two days later.

This API is rate-limited to one call every 5 minutes for a given organization ID.

get_cdr_history_gen(start_time: str | datetime | None = None, end_time: str | datetime | None = None, locations: list[str] | None = None, **params) AsyncGenerator[CDR, None, None][source]

Provides Webex Calling Detailed Call History data for your organization.

Results can be filtered with the startTime, endTime and locations request parameters. The startTime and endTime parameters specify the start and end of the time period for the Detailed Call History reports you wish to collect. The API will return all reports that were created between startTime and endTime.

Parameters:
  • start_time (Union[str, datetime]) –

    Time of the first report you wish to collect. (report time is the time the call finished). Can be a datetime object or an ISO-8601 datetime string to be parsed by dateutil.parser.isoparse().

    Note: The specified time must be between 5 minutes ago and 48 hours ago.

  • end_time (Union[str, datetime]) – Time of the last report you wish to collect. Note: The specified time should be earlier than startTime and no earlier than 48 hours ago. Can be a datetime object or an ISO-8601 datetime string to be parsed by dateutil.parser.isoparse().

  • locations (list[str]) – Names of the location (as shown in Control Hub). Up to 10 comma-separated locations can be provided. Allows you to query reports by location.

  • params – additional arguments

Returns:

async get_cdr_history(start_time: str | datetime | None = None, end_time: str | datetime | None = None, locations: list[str] | None = None, **params) List[CDR][source]

Provides Webex Calling Detailed Call History data for your organization.

Results can be filtered with the startTime, endTime and locations request parameters. The startTime and endTime parameters specify the start and end of the time period for the Detailed Call History reports you wish to collect. The API will return all reports that were created between startTime and endTime.

Parameters:
  • start_time (Union[str, datetime]) –

    Time of the first report you wish to collect. (report time is the time the call finished). Can be a datetime object or an ISO-8601 datetime string to be parsed by dateutil.parser.isoparse().

    Note: The specified time must be between 5 minutes ago and 48 hours ago.

  • end_time (Union[str, datetime]) – Time of the last report you wish to collect. Note: The specified time should be earlier than startTime and no earlier than 48 hours ago. Can be a datetime object or an ISO-8601 datetime string to be parsed by dateutil.parser.isoparse().

  • locations (list[str]) – Names of the location (as shown in Control Hub). Up to 10 comma-separated locations can be provided. Allows you to query reports by location.

  • params – additional arguments

Returns:

base = 'devices'
class wxc_sdk.as_api.AsDeviceConfigurationsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

The Device Configurations API allows developers to view and modify configurations on Webex Rooms devices, as well as other devices that use the configuration service.

Viewing the list of all device configurations in an organization requires an administrator auth token with the spark-admin:devices_read scope. Adding, updating, or deleting configurations for devices in an organization requires an administrator auth token with both the spark-admin:devices_write and the spark-admin:devices_read scope.

async list(device_id: str, key: str | None = None) DeviceConfigurationResponse[source]

Lists all device configurations associated with the given device ID. Administrators can list configurations for all devices within an organization.

Parameters:
  • device_id (str) – List device configurations by device ID.

  • key (str) –

    This can optionally be used to filter configurations. Keys are composed of segments. It’s possible to use absolute paths, wildcards or ranges.

    Absolute gives only one configuration as a result. Conference.MaxReceiveCallRate for example gives the ConferenceMaxReceiveCallRate configuration.

    Wildcards (*) can specify multiple configurations with shared segments. Audio.Ultrasound.* for example will filter on all Audio Ultrasound configurations.

    Range ([number]) can be used to filter numbered segments. FacilityService.Service[1].Name for instance only shows the first FacilityService Service Name configuration, FacilityService.Service[*].Name shows all, FacilityService.Service[1..3].Name shows the first three and FacilityService.Service[2..n].Name shows all starting at 2.

Returns:

device configurations

async update(device_id: str, operations: List[DeviceConfigurationOperation]) DeviceConfigurationResponse[source]

Update Device Configurations

Parameters:
  • device_id – Update device configurations by device ID.

  • operations – list if operations to apply

base = 'deviceConfigurations'
class wxc_sdk.as_api.AsDeviceSettingsJobsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

API for jobs to update device settings at the location and organization level

async change(location_id: str | None, customization: DeviceCustomization, org_id: str | None = None) StartJobResponse[source]

Change device settings across organization or locations jobs.

Performs bulk and asynchronous processing for all types of device settings initiated by organization and system admins in a stateful persistent manner. This job will modify the requested device settings across all the devices. Whenever a location ID is specified in the request, it will modify the requested device settings only for the devices that are part of the provided location within an organization.

Returns a unique job ID which can then be utilized further to retrieve status and errors for the same.

Only one job per customer can be running at any given time within the same organization. An attempt to run multiple jobs at the same time will result in a 409 error response.

Running a job requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Location within an organization where changes of device settings will be applied to all the devices within it.

  • customization (DeviceCustomization) – customization. Atttribute custom_enabled Indicates if all the devices within this location will be customized with new requested customizations(if set to true) or will be overridden with the one at organization level (if set to false or any other value). This field has no effect when the job is being triggered at organization level.

  • org_id (str) – Apply change device settings for all the devices under this organization.

Returns:

information about the created job

Return type:

StartJobResponse

list_gen(org_id: str | None = None, **params) AsyncGenerator[StartJobResponse, None, None][source]

List change device settings jobs.

Lists all the jobs for jobType calldevicesettings for the given organization in order of most recent one to oldest one irrespective of its status.

This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • org_id (str) – Retrieve list of ‘calldevicesettings’ jobs for this organization.

  • params – optional parameters

Returns:

Generator of StartJobResponse instances

async list(org_id: str | None = None, **params) List[StartJobResponse][source]

List change device settings jobs.

Lists all the jobs for jobType calldevicesettings for the given organization in order of most recent one to oldest one irrespective of its status.

This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • org_id (str) – Retrieve list of ‘calldevicesettings’ jobs for this organization.

  • params – optional parameters

Returns:

Generator of StartJobResponse instances

async status(job_id: str, org_id: str | None = None) StartJobResponse[source]

Get change device settings job status.

Provides details of the job with jobId of jobType calldevicesettings.

This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • job_id (str) – Retrieve job details for this jobId.

  • org_id (str) – Retrieve job details for this org

Returns:

job details

Return type:

StartJobResponse

errors_gen(job_id: str, org_id: str | None = None) AsyncGenerator[JobErrorItem, None, None][source]

List change device settings job errors.

Lists all error details of the job with jobId of jobType calldevicesettings.

This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • job_id – Retrieve job details for this jobId.

  • org_id – Retrieve list of jobs for this organization.

Returns:

async errors(job_id: str, org_id: str | None = None) List[JobErrorItem][source]

List change device settings job errors.

Lists all error details of the job with jobId of jobType calldevicesettings.

This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • job_id – Retrieve job details for this jobId.

  • org_id – Retrieve list of jobs for this organization.

Returns:

base = 'telephony/config/jobs/devices/callDeviceSettings'
class wxc_sdk.as_api.AsDevicesApi(*, session: AsRestSession)[source]

Bases: AsApiChild

Devices represent cloud-registered Webex RoomOS devices or IP Phones. Devices may be associated with Workspaces or People.

The following scopes are required for performing the specified actions:

Searching and viewing details for devices requires an auth token with the spark:devices_read scope.

Updating or deleting your devices requires an auth token with the spark:devices_write scope.

Viewing the list of all devices in an organization requires an administrator auth token with the spark-admin:devices_read scope.

Adding, updating, or deleting all devices in an organization requires an administrator auth token with the spark-admin:devices_write scope.

Generating an activation code requires an auth token with the identity:placeonetimepassword_create scope.

settings_jobs: AsDeviceSettingsJobsApi

device jobs Api

list_gen(person_id: str | None = None, workspace_id: str | None = None, location_id: str | None = None, workspace_location_id: str | None = None, display_name: str | None = None, product: str | None = None, product_type: ProductType | None = None, tag: str | None = None, connection_status: ConnectionStatus | None = None, serial: str | None = None, software: str | None = None, upgrade_channel: str | None = None, error_code: str | None = None, capability: str | None = None, permission: str | None = None, mac: str | None = None, device_platform: DevicePlatform | None = None, org_id: str | None = None, **params) AsyncGenerator[Device, None, None][source]

List Devices

Lists all active Webex devices associated with the authenticated user, such as devices activated in personal mode. Administrators can list all devices within an organization.

Parameters:
  • person_id (str) – List devices by person ID.

  • workspace_id (str) – List devices by workspace ID.

  • location_id (str) – List devices by location ID.

  • workspace_location_id (str) – List devices by workspace location ID. Deprecated, prefer location_id.

  • display_name (str) – List devices with this display name.

  • product (str) – List devices with this product name.

  • product_type (str) – List devices with this type. Possible values: roomdesk, phone, accessory, webexgo, unknown

  • tag (str separating the tag values or adding several tag parameters.) – List devices which have a tag. Searching for multiple tags (logical AND) can be done by comma

  • connection_status (str) – List devices with this connection statu

  • serial (str) – List devices with this serial number.

  • software (str) – List devices with this software version.

  • upgrade_channel (str) – List devices with this upgrade channel.

  • error_code (str) – List devices with this error code.

  • capability (str) – List devices with this capability. For example: xapi

  • permission (str) – List devices with this permission.

  • mac (str) – List devices with this MAC address.

  • device_platform (DevicePlatform) – List devices with this device platform.

  • org_id (str) – List devices in this organization. Only admin users of another organization (such as partners) may use this parameter.

Returns:

Generator yielding Device instances

async list(person_id: str | None = None, workspace_id: str | None = None, location_id: str | None = None, workspace_location_id: str | None = None, display_name: str | None = None, product: str | None = None, product_type: ProductType | None = None, tag: str | None = None, connection_status: ConnectionStatus | None = None, serial: str | None = None, software: str | None = None, upgrade_channel: str | None = None, error_code: str | None = None, capability: str | None = None, permission: str | None = None, mac: str | None = None, device_platform: DevicePlatform | None = None, org_id: str | None = None, **params) List[Device][source]

List Devices

Lists all active Webex devices associated with the authenticated user, such as devices activated in personal mode. Administrators can list all devices within an organization.

Parameters:
  • person_id (str) – List devices by person ID.

  • workspace_id (str) – List devices by workspace ID.

  • location_id (str) – List devices by location ID.

  • workspace_location_id (str) – List devices by workspace location ID. Deprecated, prefer location_id.

  • display_name (str) – List devices with this display name.

  • product (str) – List devices with this product name.

  • product_type (str) – List devices with this type. Possible values: roomdesk, phone, accessory, webexgo, unknown

  • tag (str separating the tag values or adding several tag parameters.) – List devices which have a tag. Searching for multiple tags (logical AND) can be done by comma

  • connection_status (str) – List devices with this connection statu

  • serial (str) – List devices with this serial number.

  • software (str) – List devices with this software version.

  • upgrade_channel (str) – List devices with this upgrade channel.

  • error_code (str) – List devices with this error code.

  • capability (str) – List devices with this capability. For example: xapi

  • permission (str) – List devices with this permission.

  • mac (str) – List devices with this MAC address.

  • device_platform (DevicePlatform) – List devices with this device platform.

  • org_id (str) – List devices in this organization. Only admin users of another organization (such as partners) may use this parameter.

Returns:

Generator yielding Device instances

async details(device_id: str, org_id: str | None = None) Device[source]

Get Device Details Shows details for a device, by ID.

Specify the device ID in the deviceId parameter in the URI.

Parameters:
  • device_id (str) – A unique identifier for the device.

  • org_id (str)

Returns:

Device details

Return type:

Device

async delete(device_id: str, org_id: str | None = None)[source]

Delete a Device

Deletes a device, by ID.

Specify the device ID in the deviceId parameter in the URI.

Parameters:
  • device_id (str) – A unique identifier for the device.

  • org_id (str)

async modify_device_tags(device_id: str, op: TagOp, value: List[str], org_id: str | None = None) Device[source]

Modify Device Tags

Update requests use JSON Patch syntax.

Parameters:
  • device_id (str) – A unique identifier for the device.

  • op (TagOp) – tag operation

  • value (list[str]) – list of tags

  • org_id (str)

Returns:

device details

Return type:

Device

async activation_code(workspace_id: str | None = None, person_id: str | None = None, model: str | None = None, org_id: str | None = None) ActivationCodeResponse[source]

Create a Device Activation Code

Generate an activation code for a device in a specific workspace by workspaceId or for a person by personId. This requires an auth token with the identity:placeonetimepassword_create and spark-admin:devices_write scopes.

  • Adding a device to a workspace with calling type none or thirdPartySipCalling will reset the workspace calling type to freeCalling.

  • Either workspaceId or personId should be provided. If both are supplied, the request will be invalid.

  • If no model is supplied, the code returned will only be accepted on RoomOS devices.

  • If your device is a phone, you must provide the model as a field. You can get the model from the supported devices API.

Parameters:
  • workspace_id (str) – The ID of the workspace where the device will be activated.

  • person_id (str) – The ID of the person who will own the device once activated.

  • model (str) – The model of the device being created.

  • org_id (str) – The organization associated with the activation code generated.

Return type:

ActivationCodeResponse

async create_by_mac_address(mac: str, workspace_id: str | None = None, person_id: str | None = None, model: str | None = None, password: str | None = None, org_id: str | None = None) Device[source]

Create a phone by it’s MAC address in a specific workspace or for a person. Specify the mac, model and either workspaceId or personId.

Parameters:
  • mac (str) – The MAC address of the device being created.

  • workspace_id (str) – The ID of the workspace where the device will be activated.

  • person_id (str) – The ID of the person who will own the device once activated.

  • model (str) – The model of the device being created.

  • password (str) – SIP password to be configured for the phone, only required with third party devices.

  • org_id (str) – The organization associated with the device.

Returns:

created device information

Return type:

Device

base = 'devices'
class wxc_sdk.as_api.AsDialPlanApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

list_gen(dial_plan_name: str | None = None, route_group_name: str | None = None, trunk_name: str | None = None, order: str | None = None, org_id: str | None = None, **params) AsyncGenerator[DialPlan, None, None][source]

List all Dial Plans for the organization.

Dial plans route calls to on-premises destinations by use of the trunks or route groups with which the dial plan is associated. Multiple dial patterns can be defined as part of your dial plan. Dial plans are configured globally for an enterprise and apply to all users, regardless of location.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • dial_plan_name (str) – Return the list of dial plans matching the dial plan name.

  • route_group_name (str) – Return the list of dial plans matching the route group name.

  • trunk_name (str) – Return the list of dial plans matching the trunk name.

  • order (str) – Order the dial plans according to the designated fields. Available sort fields: name, routeName, routeType. Sort order is ascending by default

  • org_id (str) – List dial plans for this organization.

Returns:

async list(dial_plan_name: str | None = None, route_group_name: str | None = None, trunk_name: str | None = None, order: str | None = None, org_id: str | None = None, **params) List[DialPlan][source]

List all Dial Plans for the organization.

Dial plans route calls to on-premises destinations by use of the trunks or route groups with which the dial plan is associated. Multiple dial patterns can be defined as part of your dial plan. Dial plans are configured globally for an enterprise and apply to all users, regardless of location.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • dial_plan_name (str) – Return the list of dial plans matching the dial plan name.

  • route_group_name (str) – Return the list of dial plans matching the route group name.

  • trunk_name (str) – Return the list of dial plans matching the trunk name.

  • order (str) – Order the dial plans according to the designated fields. Available sort fields: name, routeName, routeType. Sort order is ascending by default

  • org_id (str) – List dial plans for this organization.

Returns:

async create(name: str, route_id: str, route_type: RouteType, dial_patterns: List[str] | None = None, org_id: str | None = None) CreateResponse[source]

Create a Dial Plan for the organization.

Dial plans route calls to on-premises destinations by use of trunks or route groups. They are configured globally for an enterprise and apply to all users, regardless of location. A dial plan also specifies the routing choice (trunk or route group) for calls that match any of its dial patterns. Specific dial patterns can be defined as part of your dial plan.

Creating a dial plan requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • name (str) – A unique name for the dial plan.

  • route_id (str) – ID of route type associated with the dial plan.

  • route_type (wxc_sdk.common.RouteType) – Route Type associated with the dial plan.

  • dial_patterns (list[str]) – An Array of dial patterns

  • org_id (str) – Organization to which dial plan belongs.

Returns:

result of dial plan creation

Return type:

CreateResponse

async details(dial_plan_id: str, org_id: str | None = None) DialPlan[source]

Get a Dial Plan for the organization.

Dial plans route calls to on-premises destinations by use of trunks or route groups. They are configured globally for an enterprise and apply to all users, regardless of location. A dial plan also specifies the routing choice (trunk or route group) for calls that match any of its dial patterns. Specific dial patterns can be defined as part of your dial plan.

Retrieving a dial plan requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • dial_plan_id (str) – ID of the dial plan.

  • org_id (str) – Organization to which dial plan belongs.

Returns:

dial plan details

Return type:

DialPlan

async update(update: DialPlan, org_id: str | None = None)[source]

Modify a Dial Plan for the organization.

Dial plans route calls to on-premises destinations by use of trunks or route groups. They are configured globally for an enterprise and apply to all users, regardless of location. A dial plan also specifies the routing choice (trunk or route group) for calls that match any of its dial patterns. Specific dial patterns can be defined as part of your dial plan.

Modifying a dial plan requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • update – DialPlan objects with updated settings. Only name, route_id and route_type are considered. All three need to be set

  • org_id (str) – Organization to which dial plan belongs.

async delete_dial_plan(dial_plan_id: str, org_id: str | None = None)[source]

Delete a Dial Plan for the organization.

Dial plans route calls to on-premises destinations by use of trunks or route groups. They are configured globally for an enterprise and apply to all users, regardless of location. A dial plan also specifies the routing choice (trunk or route group) for calls that match any of its dial patterns. Specific dial patterns can be defined as part of your dial plan.

Deleting a dial plan requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • dial_plan_id (str) – ID of the dial plan.

  • org_id (str) – Organization to which dial plan belongs.

patterns_gen(dial_plan_id: str, org_id: str | None = None, dial_pattern: str | None = None, **params) AsyncGenerator[str, None, None][source]

List all Dial Patterns for the organization.

Dial plans route calls to on-premises destinations by use of trunks or route groups. They are configured globally for an enterprise and apply to all users, regardless of location. A dial plan also specifies the routing choice (trunk or route group) for calls that match any of its dial patterns. Specific dial patterns can be defined as part of your dial plan.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • dial_plan_id (str) – ID of the dial plan.

  • org_id (str) – List dial patterns associated with a dial plan.

  • dial_pattern – An enterprise dial pattern is represented by a sequence of digits (1-9), followed by optional wildcard characters. Valid wildcard characters are ! (matches any sequence of digits) and X (matches a single digit, 0-9). The ! wildcard can only occur once at the end and only in an E.164 pattern

Returns:

list of patterns

Return type:

list[str]

async patterns(dial_plan_id: str, org_id: str | None = None, dial_pattern: str | None = None, **params) List[str][source]

List all Dial Patterns for the organization.

Dial plans route calls to on-premises destinations by use of trunks or route groups. They are configured globally for an enterprise and apply to all users, regardless of location. A dial plan also specifies the routing choice (trunk or route group) for calls that match any of its dial patterns. Specific dial patterns can be defined as part of your dial plan.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • dial_plan_id (str) – ID of the dial plan.

  • org_id (str) – List dial patterns associated with a dial plan.

  • dial_pattern – An enterprise dial pattern is represented by a sequence of digits (1-9), followed by optional wildcard characters. Valid wildcard characters are ! (matches any sequence of digits) and X (matches a single digit, 0-9). The ! wildcard can only occur once at the end and only in an E.164 pattern

Returns:

list of patterns

Return type:

list[str]

async modify_patterns(dial_plan_id: str, dial_patterns: List[PatternAndAction], org_id: str | None = None)[source]

Modify dial patterns for the Dial Plan.

Dial plans route calls to on-premises destinations by use of trunks or route groups. They are configured globally for an enterprise and apply to all users, regardless of location. A dial plan also specifies the routing choice (trunk or route group) for calls that match any of its dial patterns. Specific dial patterns can be defined as part of your dial plan.

Modifying a dial pattern requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • dial_plan_id (str) – ID of the dial plan being modified.

  • dial_patterns (PatternAndAction) – Array of dial patterns to add or delete. Dial Pattern that is not present in the request is not modified.

  • org_id (str) – Organization to which dial plan belongs.

async delete_all_patterns(dial_plan_id: str, org_id: str | None = None)[source]

Delete all dial patterns from the Dial Plan.

Dial plans route calls to on-premises destinations by use of trunks or route groups. They are configured globally for an enterprise and apply to all users, regardless of location. A dial plan also specifies the routing choice (trunk or route group) for calls that match any of its dial patterns. Specific dial patterns can be defined as part of your dial plan.

Deleting dial pattern requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • dial_plan_id (str) – ID of the dial plan being modified.

  • org_id (str) – Organization to which dial plan belongs.

base = 'telephony/config/premisePstn/dialPlans'
class wxc_sdk.as_api.AsDigitPatternsApi(*, session: AsRestSession, selector: ApiSelector = ApiSelector.person)[source]

Bases: AsPersonSettingsApiChild

feature = 'outgoingPermission/digitPatterns'
async get_digit_patterns(entity_id: str, org_id: str | None = None) DigitPatterns[source]

Retrieve Digit Patterns

Retrieve digit patterns.

Digit patterns are used to bypass permissions.

Retrieving digit patterns requires a full or user or read-only administrator or location administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • entity_id (str) – Unique identifier for location, person, workspace, or virtual line.

  • org_id (str) – ID of the organization in which the entity resides. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access the API.

Return type:

UserOutgoingPermissionDigitPatternGetListObject

async details(entity_id: str, digit_pattern_id: str, org_id: str | None = None) DigitPattern[source]

Retrieve Digit Pattern Details

Retrieve the digit pattern details.

Digit patterns are used to bypass permissions.

Retrieving the digit pattern details requires a full or user or read-only administrator or location administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • entity_id (str) – Unique identifier for location, person, workspace, or virtual line.

  • digit_pattern_id (str) – Unique identifier for the digit pattern.

  • org_id (str) – ID of the organization in which the entity resides. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access the API.

Return type:

UserDigitPatternObject

async create(entity_id: str, pattern: DigitPattern, org_id: str | None = None) str[source]

Create Digit Patterns

Create new digit pattern.

Digit patterns are used to bypass permissions.

Creating the digit pattern requires a full or user or location administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • entity_id (str) – Unique identifier for location, person, workspace, or virtual line.

  • pattern (DigitPattern) – new digit pattern

  • org_id (str) – ID of the organization in which the entity resides. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access the API.

Return type:

str

async update_category_control_settings(entity_id: str, use_custom_digit_patterns: bool | None = None, org_id: str | None = None)[source]

Modify the Digit Pattern Category Control Settings for the entity

Modifies whether this user uses the specified digit patterns when placing outbound calls or not.

Updating the digit pattern category control settings requires a full or user or location administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • entity_id (str) – Unique identifier for location, person, workspace, or virtual line.

  • use_custom_digit_patterns (bool) – When true, use custom settings for the digit patterns category of outgoing call permissions.

  • org_id (str) – ID of the organization in which the entity resides. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access the API.

Return type:

None

async update(entity_id: str, settings: DigitPattern, org_id: str | None = None)[source]

Modify Digit Patterns

Modify Digit Patterns

Digit patterns are used to bypass permissions.

Updating the digit pattern requires a full or user or location administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • entity_id (str) – Unique identifier for location, person, workspace, or virtual line.

  • settings (DigitPattern) – new digit pattern settings

  • org_id (str) – ID of the organization in which the entity resides. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access the API.

Return type:

None

async delete(entity_id: str, digit_pattern_id: str, org_id: str | None = None)[source]

Delete a Digit Pattern

Delete Digit Pattern.

Digit patterns are used to bypass permissions.

Deleting the digit pattern requires a full or user or location administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • entity_id (str) – Unique identifier for location, person, workspace, or virtual line.

  • digit_pattern_id (str) – Unique identifier for the digit pattern.

  • org_id (str) – ID of the organization in which the entity resides. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access the API.

Return type:

None

async delete_all(entity_id: str, org_id: str | None = None)[source]

Delete all Digit Patterns.

Digit patterns are used to bypass permissions.

Deleting the digit patterns requires a full or user or location administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • entity_id (str) – Unique identifier for location, person, workspace, or virtual line.

  • org_id (str) – ID of the organization in which the entity resides. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access the API.

Return type:

None

base = ''
class wxc_sdk.as_api.AsDndApi(*, session: AsRestSession, selector: ApiSelector = ApiSelector.person)[source]

Bases: AsPersonSettingsApiChild

API for person’s DND settings

feature = 'doNotDisturb'
async read(person_id: str, org_id: str | None = None) DND[source]

Read Do Not Disturb Settings for a Person Retrieve a Person’s Do Not Disturb Settings

When enabled, this feature will give all incoming calls the busy treatment. Optionally, you can enable a Ring Reminder to play a brief tone on your desktop phone when you receive incoming calls.

This API requires a full, user, or read-only administrator auth token with a scope of spark-admin:people_read or a user auth token with spark:people_read scope can be used by a person to read their settings. :param person_id: Unique identifier for the person. :type person_id: str :param org_id: Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API. :type org_id: str :return:

async configure(person_id: str, dnd_settings: DND, org_id: str | None = None)[source]

Configure Do Not Disturb Settings for a Person Configure a Person’s Do Not Disturb Settings

When enabled, this feature will give all incoming calls the busy treatment. Optionally, you can enable a Ring Reminder to play a brief tone on your desktop phone when you receive incoming calls.

This API requires a full or user administrator auth token with the spark-admin:people_write scope or a user auth token with spark:people_write scope can be used by a person to update their settings.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • dnd_settings (DND) – new setting to be applied

  • org_id – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

base = ''
class wxc_sdk.as_api.AsEventsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Events are generated when actions take place within Webex, such as when someone creates or deletes a message. The Events API can only be used by a Compliance Officer with an API access token that contains the spark-compliance:events_read scope. See the Compliance Guide for more information.

list_gen(has_attachments: bool | None = None, resource: EventResource | None = None, type_: EventType | None = None, actor_id: str | None = None, from_: str | datetime | None = None, to_: str | datetime | None = None, **params) AsyncGenerator[ComplianceEvent, None, None][source]

List events in your organization. Several query parameters are available to filter the response.

Long result sets will be split into pages.

Parameters:
  • has_attachments (bool) – If enabled, filters message events to only those that contain the attachments attribute.

  • resource (EventResource) – List events with a specific resource type.

  • type (EventType) – List events with a specific event type.

  • actor_id (str) – List events performed by this person, by person ID.

  • from (str) – List events which occurred after a specific date and time.

  • to (str) – List events which occurred before a specific date and time. If unspecified, or set to a time in the future, lists events up to the present.

async list(has_attachments: bool | None = None, resource: EventResource | None = None, type_: EventType | None = None, actor_id: str | None = None, from_: str | datetime | None = None, to_: str | datetime | None = None, **params) List[ComplianceEvent][source]

List events in your organization. Several query parameters are available to filter the response.

Long result sets will be split into pages.

Parameters:
  • has_attachments (bool) – If enabled, filters message events to only those that contain the attachments attribute.

  • resource (EventResource) – List events with a specific resource type.

  • type (EventType) – List events with a specific event type.

  • actor_id (str) – List events performed by this person, by person ID.

  • from (str) – List events which occurred after a specific date and time.

  • to (str) – List events which occurred before a specific date and time. If unspecified, or set to a time in the future, lists events up to the present.

async details(event_id: str) ComplianceEvent[source]

Shows details for an event, by event ID. Specify the event ID in the eventId parameter in the URI.

Parameters:

event_id (str) – The unique identifier for the event.

base = 'events'
class wxc_sdk.as_api.AsExecAssistantApi(*, session: AsRestSession, selector: ApiSelector = ApiSelector.person)[source]

Bases: AsPersonSettingsApiChild

API for person’s exec assistant settings

feature = 'executiveAssistant'
async read(person_id: str, org_id: str | None = None) ExecAssistantType[source]

Retrieve Executive Assistant Settings for a Person

Retrieve the executive assistant settings for the specified personId.

People with the executive service enabled, can select from a pool of assistants who have been assigned the executive assistant service and who can answer or place calls on their behalf. Executive assistants can set the call forward destination and join or leave an executive’s pool.

This API requires a full, user, or read-only administrator auth token with a scope of spark-admin:people_read.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • org_id (str) – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

Returns:

exec assistant setting

Return type:

ExecAssistantType

async configure(person_id: str, setting: ExecAssistantType, org_id: str | None = None)[source]

Modify Executive Assistant Settings for a Person

Modify the executive assistant settings for the specified personId.

People with the executive service enabled, can select from a pool of assistants who have been assigned the executive assistant service and who can answer or place calls on their behalf. Executive assistants can set the call forward destination and join or leave an executive’s pool.

This API requires a full or user administrator auth token with the spark-admin:people_write scope.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • setting (ExecAssistantType) – New exex assistant settings

  • org_id (str) – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

base = ''
class wxc_sdk.as_api.AsForwardingApi(session: AsRestSession, feature_selector: FeatureSelector)[source]

Bases: object

API for forwarding settings on call queues, hunt groups, and auto attendants

async settings(location_id: str, feature_id: str, org_id: str | None = None) CallForwarding[source]

Retrieve Call Forwarding settings for the designated feature including the list of call forwarding rules.

Parameters:
  • location_id (str) – Location in which this feature exists.

  • feature_id (str) – Retrieve the call forwarding settings for this entity

  • org_id (str) – Retrieve call forwarding settings from this organization.

Returns:

call forwarding settings

Return type:

class:CallForwarding

async update(location_id: str, feature_id: str, forwarding: CallForwarding, org_id: str | None = None)[source]

Update Call Forwarding Settings for a feature

Update Call Forwarding settings for the designated feature.

Updating call forwarding settings for a feature requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Location in which this feature exists.

  • feature_id (str) – Update call forwarding settings for this feature.

  • forwarding (CallForwarding) – Forwarding settings

  • org_id (str) – Update feature forwarding settings from this organization.

async create_call_forwarding_rule(location_id: str, feature_id: str, forwarding_rule: ForwardingRuleDetails, org_id: str | None = None) str[source]

Create a Selective Call Forwarding Rule feature

A selective call forwarding rule for feature to be forwarded or not forwarded to the designated number, based on the defined criteria.

Note that the list of existing call forward rules is available feature’s call forwarding settings. :param location_id: Location in which the call queue exists. :type location_id: str :param feature_id: Create the rule for this feature :type feature_id: str :param forwarding_rule: details of rule to be created :type forwarding_rule: ForwardingRuleDetails :param org_id: Create the feature forwarding rule for this organization. :type org_id: str :return: forwarding rule id :rtype; str

async call_forwarding_rule(location_id: str, feature_id: str, rule_id: str, org_id: str | None = None) ForwardingRuleDetails[source]

Retrieve a Selective Call Forwarding Rule’s settings for the designated Call Queue.

A selective call forwarding rule for feature allows calls to be forwarded or not forwarded to the designated number, based on the defined criteria.

Note that the list of existing call forward rules is available in the feature’s call forwarding settings. :param location_id: Location in which the feature exists. :type location_id: stre :param feature_id: Retrieve setting for a rule for this feature. :type feature_id: str :param rule_id: feature rule you are retrieving settings for. :type rule_id: str :param org_id: Retrieve feature forwarding settings from this organization. :type org_id: str :return: call forwarding rule details :rtype: ForwardingRuleDetails

async update_call_forwarding_rule(location_id: str, feature_id: str, rule_id: str, forwarding_rule: ForwardingRuleDetails, org_id: str | None = None) str[source]

Update a Selective Call Forwarding Rule’s settings for the designated feature.

A selective call forwarding rule for feature allows calls to be forwarded or not forwarded to the designated number, based on the defined criteria.

Note that the list of existing call forward rules is available in the feature’s call forwarding settings.

NOTE: The Call Forwarding Rule ID will change upon modification of the Call Forwarding Rule name.

Parameters:
  • location_id (str) – Location in which the feature exists.

  • feature_id (str) – Update settings for a rule for this feature.

  • rule_id (str) – feature you are updating settings for.

  • forwarding_rule (ForwardingRuleDetails) – forwarding rule details for update

  • org_id (str) – Update feature rule settings for this organization.

Returns:

new call forwarding rule id

Return type:

str

async delete_call_forwarding_rule(location_id: str, feature_id: str, rule_id: str, org_id: str | None = None)[source]

Delete a Selective Call Forwarding Rule for the designated feature.

A selective call forwarding rule for a feature allows calls to be forwarded or not forwarded to the designated number, based on the defined criteria.

Note that the list of existing call forward rules is available in the feature’s call forwarding settings.

class wxc_sdk.as_api.AsGroupsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Groups contain a collection of members in Webex. A member represents a Webex user. A group is used to assign templates and settings to the set of members contained in a group. To create and manage a group, including adding and removing members from a group, an auth token containing the identity:groups_rw is required. Searching and viewing members of a group requires an auth token with a scope of identity:groups_read. To learn more about managing people to use as members in the /groups API please refer to the People API.

list_gen(include_members: bool | None = None, attributes: str | None = None, sort_by: str | None = None, sort_order: str | None = None, list_filter: str | None = None, org_id: str | None = None, **params) AsyncGenerator[Group, None, None][source]

List groups in your organization.

Parameters:
  • include_members (bool) – Include members in list response

  • attributes (str) – comma separated list of attributes to return

  • sort_by (str) – attribute to sort by

  • sort_order (str) – sort order, ascending or descending

  • org_id (str) – List groups in this organization. Only admin users of another organization (such as partners) may use this parameter.

  • list_filter (str) – Searches the group by displayName with an operator and a value. The available operators are eq (equal) and sw (starts with). Only displayName can be used to filter results.

  • params

Returns:

generator of Group objects

async list(include_members: bool | None = None, attributes: str | None = None, sort_by: str | None = None, sort_order: str | None = None, list_filter: str | None = None, org_id: str | None = None, **params) List[Group][source]

List groups in your organization.

Parameters:
  • include_members (bool) – Include members in list response

  • attributes (str) – comma separated list of attributes to return

  • sort_by (str) – attribute to sort by

  • sort_order (str) – sort order, ascending or descending

  • org_id (str) – List groups in this organization. Only admin users of another organization (such as partners) may use this parameter.

  • list_filter (str) – Searches the group by displayName with an operator and a value. The available operators are eq (equal) and sw (starts with). Only displayName can be used to filter results.

  • params

Returns:

generator of Group objects

async create(settings: Group) Group[source]

Create a new group using the provided settings. Only display_name is mandatory

Parameters:

settings (Group) – settings for new group

Returns:

new group

Return type:

Group

async details(group_id: str, include_members: bool | None = None) Group[source]

Get group details

Parameters:
  • group_id (str) – group id

  • include_members (bool) – return members in response

Returns:

group details

Return type:

Group

members_gen(group_id: str, **params) AsyncGenerator[GroupMember, None, None][source]

Query members of a group

Parameters:
  • group_id (str) – group id

  • params

Returns:

generator of GroupMember instances

async members(group_id: str, **params) List[GroupMember][source]

Query members of a group

Parameters:
  • group_id (str) – group id

  • params

Returns:

generator of GroupMember instances

async update(group_id: str, settings: Group | None = None, remove_all: bool | None = None) Group[source]

update group information.

Options: change displayName, add new members, remove some or all members, replace all members

Parameters:
  • group_id

  • settings

  • remove_all

Returns:

async delete_group(group_id: str)[source]

Delete a group

Parameters:

group_id (str) – group id

base = 'groups'
class wxc_sdk.as_api.AsGuestManagementApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Guest Management

Guests in Webex are users with only a temporary identity and are often used for single-transaction collaborations. Examples include click-to-call and click-to-chat applications where the guest interacts with the agent only for the duration of the call or chat session. Guests in Webex are created and managed via a Service App with the scope guest-issuer:write and guest-issuer:read and are represented by a token with a fixed and predefined set of scopes.

Since the Service App manages its own pool of guests, you need to insert the Service App token into the developer portal’s Try-It mode rather than your default personal token.

The guests/token endpoint is used to create and retrieve guest tokens, and the guests/count is used to assess the number of current guests.

Creating guests via the guest-issuer application type is deprecated and will be removed in the future.

async create(subject: str, display_name: str) Guest[source]

Create a Guest

Create a new token for a single guest user. The Service App that creates the guest must have the scope guest-issuer:write.

Guests are implicitly created by retrieving the guest access token.

Repeated calls to this API with the same subject will create additional tokens without invalidating previous ones. Tokens are valid until the expiresIn.

Guests can be renamed by supplying the same subject and changing the displayName.

To retrieve a new token for an existing guest, please provide the existing guest’s subject. Tokens are valid until expiresIn.

Parameters:
  • subject (str) – The unique and external identifier of the guest.

  • display_name (str) – The display name shown in the Webex application.

Return type:

Guest

async guest_count() int[source]

Get Guest Count

To retrieve the number of guests, the scopes guest-issuer:read or guest-issuer:write are needed.

Return type:

int

base = 'guests'
class wxc_sdk.as_api.AsHotelingApi(*, session: AsRestSession, selector: ApiSelector = ApiSelector.person)[source]

Bases: AsPersonSettingsApiChild

API for person’s hoteling settings

feature = 'hoteling'
async read(person_id: str, org_id: str | None = None) bool[source]

Read Hoteling Settings for a Person

Retrieve a person’s hoteling settings.

As an administrator, you can enable hoteling for people so that their phone profile (phone number, features, and calling plan) is temporarily loaded onto a shared (host) phone.

This API requires a full, user, or read-only administrator auth token with a scope of spark-admin:people_read.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • org_id (str) – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

Returns:

hoteling setting

Return type:

bool

async configure(person_id: str, enabled: bool, org_id: str | None = None)[source]

Configure Hoteling Settings for a Person

Configure a person’s hoteling settings.

As an administrator, you can enable hoteling for people so that their phone profile (phone number, features, and calling plan) is temporarily loaded onto a shared (host) phone.

This API requires a full or user administrator auth token with the spark-admin:people_write scope.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • enabled (bool) – When true, allow this person to connect to a Hoteling host device.

  • org_id (str) – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

base = ''
class wxc_sdk.as_api.AsHuntGroupApi(session: AsRestSession)[source]

Bases: AsApiChild

Hunt Group API

forwarding: AsForwardingApi
list_gen(org_id: str | None = None, location_id: str | None = None, name: str | None = None, phone_number: str | None = None, **params) AsyncGenerator[HuntGroup, None, None][source]

Read the List of Hunt Groups

List all calling Hunt Groups for the organization.

Hunt groups can route incoming calls to a group of people or workspaces. You can even configure a pattern to route to a whole group.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • org_id – List hunt groups for this organization.

  • location_id – Only return hunt groups with matching location ID.

  • name – Only return hunt groups with the matching name.

  • phone_number – Only return hunt groups with the matching primary phone number or extension.

Returns:

yields HuntGroup instances

async list(org_id: str | None = None, location_id: str | None = None, name: str | None = None, phone_number: str | None = None, **params) List[HuntGroup][source]

Read the List of Hunt Groups

List all calling Hunt Groups for the organization.

Hunt groups can route incoming calls to a group of people or workspaces. You can even configure a pattern to route to a whole group.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • org_id – List hunt groups for this organization.

  • location_id – Only return hunt groups with matching location ID.

  • name – Only return hunt groups with the matching name.

  • phone_number – Only return hunt groups with the matching primary phone number or extension.

Returns:

yields HuntGroup instances

async by_name(name: str, location_id: str | None = None, org_id: str | None = None) HuntGroup | None[source]

Get hunt group info by name :param location_id: :param name: :param org_id: :return:

async create(location_id: str, settings: HuntGroup, org_id: str | None = None) str[source]

Create a Hunt Group

Create new Hunt Groups for the given location.

Hunt groups can route incoming calls to a group of people or workspaces. You can even configure a pattern to route to a whole group.

Creating a hunt group requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Create the hunt group for the given location.

  • settings (HuntGroup) – hunt group details

  • org_id (str) – Create the hunt group for this organization.

Returns:

ID of the newly created hunt group.

Return type:

str

async delete_huntgroup(location_id: str, huntgroup_id: str, org_id: str | None = None)[source]

Delete a Hunt Group

Delete the designated Hunt Group.

Hunt groups can route incoming calls to a group of people or workspaces. You can even configure a pattern to route to a whole group.

Deleting a hunt group requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Location from which to delete a hunt group.

  • huntgroup_id (str) – Delete the hunt group with the matching ID.

  • org_id (str) – Delete the hunt group with the matching ID.

async details(location_id: str, huntgroup_id: str, org_id: str | None = None) HuntGroup[source]

Get Details for a Hunt Group

Retrieve Hunt Group details.

Hunt groups can route incoming calls to a group of people or workspaces. You can even configure a pattern to route to a whole group.

Retrieving hunt group details requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Retrieve settings for a hunt group in this location.

  • huntgroup_id (str) – Retrieve settings for the hunt group with this identifier.

  • org_id (str) – Retrieve hunt group settings from this organization.

Returns:

hunt group details

async update(location_id: str, huntgroup_id: str, update: HuntGroup, org_id: str | None = None)[source]

Update a Hunt Group

Update the designated Hunt Group.

Hunt groups can route incoming calls to a group of people or workspaces. You can even configure a pattern to route to a whole group.

Updating a hunt group requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Update the hunt group for this location.

  • huntgroup_id (str) – Update setting for the hunt group with the matching ID.

  • update (HuntGroup) – hunt group settings

  • org_id – Update hunt group settings from this organization.

base = 'telephony/config/huntGroups'
class wxc_sdk.as_api.AsIncomingPermissionsApi(*, session: AsRestSession, selector: ApiSelector = ApiSelector.person)[source]

Bases: AsPersonSettingsApiChild

API for incoming permissions settings

Also used for virtual lines, workspaces

feature = 'incomingPermission'
async read(entity_id: str, org_id: str | None = None) IncomingPermissions[source]

Read Incoming Permission Settings

Retrieve Incoming Permission Settings

You can change the incoming calling permissions for an entity if you want them to be different from your organization’s default.

This API requires a full, user, or read-only administrator auth token with a scope of spark-admin:people_read.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • org_id (str) – entity is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

Returns:

incoming permission settings for specific user

Return type:

IncomingPermissions

async configure(entity_id: str, settings: IncomingPermissions, org_id: str | None = None)[source]

Configure incoming permissions settings

The Barge In feature enables you to use a Feature Access Code (FAC) to answer a call that was directed to another subscriber, or barge-in on the call if it was already answered. Barge In can be used across locations.

This API requires a full or user administrator auth token with the spark-admin:people_write scope or a user auth token with spark:people_write scope can be used by an entity to update their own settings.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • settings (IncomingPermissions) – new setting to be applied

  • org_id (str) – entity is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

base = ''
class wxc_sdk.as_api.AsInternalDialingApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Internal dialing settings for location

url(location_id: str) str[source]
async read(location_id: str, org_id: str | None = None) InternalDialing[source]

Get current configuration for routing unknown extensions to the Premises as internal calls

If some users in a location are registered to a PBX, retrieve the setting to route unknown extensions (digits that match the extension length) to the PBX.

Retrieving the internal dialing configuration requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – location for which internal calling configuration is being requested

  • org_id (str)

Returns:

settings

Return type:

InternalDialing

async update(location_id: str, update: InternalDialing, org_id: str | None = None)[source]

Modify current configuration for routing unknown extensions to the Premises as internal calls

If some users in a location are registered to a PBX, enable the setting to route unknown extensions (digits that match the extension length) to the PBX.

Editing the internal dialing configuration requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – location for which internal calling configuration is being requested

  • update (InternalDialing) – new settings

  • org_id (str)

base = 'telephony/config/locations'
class wxc_sdk.as_api.AsJobsApi(*, session: AsRestSession)[source]

Bases: AsApiChild

Jobs API

device_settings: AsDeviceSettingsJobsApi

API for device settings jobs

manage_numbers: AsManageNumbersJobsApi

API for manage numbers jobs

apply_line_key_templates: AsApplyLineKeyTemplatesJobsApi

API for apply line key template jobs

rebuild_phones: AsRebuildPhonesJobsApi

API for rebuild phone jobs

base = 'telephony/config/jobs'
class wxc_sdk.as_api.AsLicensesApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Licenses

An allowance for features and services that are provided to users on a Webex services subscription. Cisco and its partners manage the amount of licenses provided to administrators and users. License can be assigned only by admins.

Viewing the list of all licenses in your organization and viewing license details requires an administrator auth token with a scope of spark-admin:licenses_read.

Updating the licenses of users requires an administrator auth token with a scope of spark-admin:people_write.

To learn about how to allocate Hybrid Services licenses, see the Managing Hybrid Services guide.

async list(org_id: str | None = None) list[License][source]

List all licenses for a given organization. If no org_id is specified, the default is the organization of the authenticated user.

Response properties that are not applicable to the license will not be present in the response.

Parameters:

org_id (str) – List licenses for this organization.

Returns:

yields License instances

async details(license_id) License[source]

Shows details for a license, by ID.

Response properties that are not applicable to the license will not be present in the response.

Parameters:

license_id (str) – The unique identifier for the license.

Returns:

license details

Return type:

License

assigned_users_gen(license_id: str, **params) AsyncGenerator[LicenseUser, None, None][source]

Get users license is assigned to, by license ID.

Specify the license ID in the licenseId parameter in the URI. Long result sets will be split into pages.

Parameters:

license_id (str) – The unique identifier for the license.

async assigned_users(license_id: str, **params) List[LicenseUser][source]

Get users license is assigned to, by license ID.

Specify the license ID in the licenseId parameter in the URI. Long result sets will be split into pages.

Parameters:

license_id (str) – The unique identifier for the license.

async assign_licenses_to_users(email: str | None = None, person_id: str | None = None, licenses: List[LicenseRequest] | None = None, site_urls: List[SiteUrlsRequest] | None = None, org_id: str | None = None) UserLicensesResponse[source]

Assign Licenses to Users

Assign licenses and attendee siteUrls to existing users. Only an admin can assign licenses. Only existing users can be assigned a license. Assign meeting licenses to users outside your organization (Status will be pending until the user accepts the invite)

At least one of the following body parameters is required to assign license to the user: email, personId. For Calling license assignment, properties phoneNumber or extension are required. If phoneNumber is not provided then locationId is mandatory.

When assigning licenses and attendee siteUrls to a user who does not belong to the organization, the licenses and siteUrls remain in pending state until the user accepts them. The pendingLicenses and pendingSiteUrls are part of the response.

Parameters:
  • email (str) – Email address of the user.

  • person_id (str) – A unique identifier for the user.

  • licenses (list[LicenseRequest]) – An array of licenses to be assigned to the user.

  • site_urls (list[SiteUrlsRequest]) – An array of siteUrls to be assigned to the user.

  • org_id (str) – The ID of the organization to which the licenses and siteUrls belong. If not specified, the organization ID from the OAuth token is used.

Return type:

UserLicensesResponse

Example

self.api.licenses.assign_licenses_to_users(
    person_id=new_user.person_id,
    licenses=[LicenseRequest(id=calling_license_id,
                             properties=LicenseProperties(location_id=target_location.location_id,
                                                          extension=extension))])
base = 'licenses'
class wxc_sdk.as_api.AsLocationAccessCodesApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Access codes API

async read(location_id: str, org_id: str | None = None) list[AuthCode][source]

Get Location Access Code

Retrieve access codes details for a customer location.

Use Access Codes to bypass the set permissions for all persons/workspaces at this location.

Retrieving access codes details requires a full, user or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Retrieve access codes details for this location.

  • org_id (str) – Retrieve access codes details for a customer location in this organization

Returns:

list of wxc_sdk.common.CallPark

async create(location_id: str, access_codes: list[AuthCode], org_id: str | None = None) list[AuthCode][source]

Create access code in location

Parameters:
  • location_id (str) – Add new access code for this location.

  • access_codes (list of wxc_sdk.common.AuthCode) – Access code details

  • org_id (str) – Add new access code for this organization.

async delete_codes(location_id: str, access_codes: list[str | AuthCode], org_id: str | None = None) list[AuthCode][source]

Delete Access Code Location

Deletes the access code details for a particular location for a customer.

Use Access Codes to bypass the set permissions for all persons/workspaces at this location.

Modifying the access code location details requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Deletes the access code details for this location.

  • access_codes (list of wxc_sdk.common.AuthCode or str) – access codes to delete

  • org_id (str) – Delete access codes from this organization.

async delete_all(location_id: str, org_id: str | None = None)[source]

Delete Outgoing Permission Location Access Codes

Deletes all the access codes for a particular location for a customer.

Use Access Codes to bypass the set permissions for all persons/workspaces at this location.

Deleting the access codes requires a full or user administrator or location administrator auth token with the spark-admin:telephony_config_write scope.

Parameters:
  • location_id (str) – Deletes all the access codes for this location.

  • org_id (str) – Deletes the access codes for a customer location.

Return type:

None

base = 'telephony/config/locations'
class wxc_sdk.as_api.AsLocationInterceptApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

API for location’s call intercept settings

async read(location_id: str, org_id: str | None = None) InterceptSetting[source]

Get Location Intercept

Retrieve intercept location details for a customer location.

Intercept incoming or outgoing calls for persons in your organization. If this is enabled, calls are either routed to a designated number the person chooses, or to the person’s voicemail.

Retrieving intercept location details requires a full, user or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Retrieve intercept details for this location.

  • org_id (str) – Retrieve intercept location details for a customer location.

Returns:

user’s call intercept settings

Return type:

wxc_sdk.person_settings.call_intercept.InterceptSetting

async configure(location_id: str, settings: InterceptSetting, org_id: str | None = None)[source]

Put Location Intercept

Modifies the intercept location details for a customer location.

Intercept incoming or outgoing calls for users in your organization. If this is enabled, calls are either routed to a designated number the user chooses, or to the user’s voicemail.

Modifying the intercept location details requires a full, user administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Unique identifier for the person.

  • settings (InterceptSetting) – new intercept settings

  • org_id (str) – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

base = 'telephony/config/locations'
class wxc_sdk.as_api.AsLocationMoHApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Access codes API

async read(location_id: str, org_id: str | None = None) LocationMoHSetting[source]

Get Music On Hold

Retrieve the location’s music on hold settings.

Location’s music on hold settings allows you to play music when a call is placed on hold or parked.

Retrieving location’s music on hold settings requires a full, user or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Retrieve access codes details for this location.

  • org_id (str) – Retrieve access codes details for a customer location in this organization

Returns:

MoH settings

Return type:

LocationMoHSetting

async update(location_id: str, settings: LocationMoHSetting, org_id: str | None = None) LocationMoHSetting[source]

Get Music On Hold

Retrieve the location’s music on hold settings.

Location’s music on hold settings allows you to play music when a call is placed on hold or parked.

Retrieving location’s music on hold settings requires a full, user or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Retrieve access codes details for this location.

  • settings (LocationMoHSetting) – new settings

  • org_id (str) – Retrieve access codes details for a customer location in this organization

Returns:

list of wxc_sdk.common.CallPark

async create(location_id: str, access_codes: list[AuthCode], org_id: str | None = None) list[AuthCode][source]
Parameters:
  • location_id (str) – Add new access code for this location.

  • access_codes (list of wxc_sdk.common.AuthCode) – Access code details

  • org_id (str) – Add new access code for this organization.

async delete_codes(location_id: str, access_codes: list[str | AuthCode], org_id: str | None = None) list[AuthCode][source]

Delete Access Code Location

Deletes the access code details for a particular location for a customer.

Use Access Codes to bypass the set permissions for all persons/workspaces at this location.

Modifying the access code location details requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Deletes the access code details for this location.

  • access_codes (list of wxc_sdk.common.AuthCode or str) – access codes to delete

  • org_id (str) – Delete access codes from this organization.

base = 'telephony/config/locations'
class wxc_sdk.as_api.AsLocationNumbersApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

async add(location_id: str, phone_numbers: list[str], number_type: ~wxc_sdk.telephony.location.numbers.TelephoneNumberType | None = None, state: ~wxc_sdk.common.NumberState = <NumberState.inactive: 'INACTIVE'>, org_id: str | None = None)[source]

Adds a specified set of phone numbers to a location for an organization.

Each location has a set of phone numbers that can be assigned to people, workspaces, or features. Phone numbers must follow E.164 format. Active phone numbers are in service.

Adding a phone number to a location requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

WARNING: This API is only supported for non-integrated PSTN connection types of Local Gateway (LGW) and Non-integrated CPP. It should never be used for locations with integrated PSTN connection types like Cisco PSTN or Integrated CCP because backend data issues may occur.

Parameters:
  • location_id (str) – LocationId to which numbers should be added.

  • phone_numbers (list[str]) – List of phone numbers that need to be added.

  • number_type (TelephoneNumberType) – Type of the number.

  • state (wxc_sdk.common.NumberState) – State of the phone numbers.

  • org_id (str) – Organization to manage

async activate(location_id: str, phone_numbers: list[str], org_id: str | None = None)[source]

Activate the specified set of phone numbers in a location for an organization.

Each location has a set of phone numbers that can be assigned to people, workspaces, or features. Phone numbers must follow E.164 format for all countries, except for the United States, which can also follow the National format. Active phone numbers are in service.

Activating a phone number in a location requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

WARNING: This API is only supported for non-integrated PSTN connection types of Local Gateway (LGW) and Non-integrated CPP. It should never be used for locations with integrated PSTN connection types like Cisco PSTN or Integrated CCP because backend data issues may occur.

Parameters:
  • location_id (str) – LocationId in which numbers should be activated.

  • phone_numbers (list[str]) – List of phone numbers to be activated.

  • org_id (str) – Organization to manage

async remove(location_id: str, phone_numbers: list[str], org_id: str | None = None)[source]

Remove the specified set of phone numbers from a location for an organization.

Each location has a set of phone numbers that can be assigned to people, workspaces, or features. Phone numbers must follow E.164 format for all countries, except for the United States, which can also follow the National format. Active phone numbers are in service.

Removing a phone number from a location requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

WARNING: This API is only supported for non-integrated PSTN connection types of Local Gateway (LGW) and Non-integrated CPP. It should never be used for locations with integrated PSTN connection types like Cisco PSTN or Integrated CCP because backend data issues may occur.

Parameters:
  • location_id (str) – LocationId from which numbers should be removed.

  • phone_numbers (list[str]) – List of phone numbers to be removed.

  • org_id (str) – Organization to manage

base = 'telephony/config/locations'
class wxc_sdk.as_api.AsLocationVoicemailSettingsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

location voicemail settings API, for now only enable/disable Vm transcription

async read(location_id: str, org_id: str | None = None) LocationVoiceMailSettings[source]

Get Location Voicemail

Retrieve voicemail settings for a specific location.

Location’s voicemail settings allows you to enable voicemail transcription for a specific location.

Retrieving location’s voicemail settings requires a full, user or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Retrieve access codes details for this location.

  • org_id (str) – Retrieve access codes details for a customer location in this organization

Returns:

location voicemail settings

Return type:

LocationVoiceMailSettings

async update(location_id: str, settings: LocationVoiceMailSettings, org_id: str | None = None)[source]

Get Location Voicemail

Retrieve voicemail settings for a specific location.

Location’s voicemail settings allows you to enable voicemail transcription for a specific location.

Retrieving location’s voicemail settings requires a full, user or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Retrieve access codes details for this location.

  • settings (LocationVoiceMailSettings) – new settings

  • org_id (str) – Retrieve access codes details for a customer location in this organization

base = 'telephony/config/locations'
class wxc_sdk.as_api.AsLocationsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Location API

Locations allow you to organize users and workspaces based on a physical location. You can configure both calling and workspace management functions into the same location. You can also create and inspect locations in Webex Control Hub. See Locations on Control Hub for more information.

list_gen(name: str | None = None, location_id: str | None = None, org_id: str | None = None, **params) AsyncGenerator[Location, None, None][source]

List locations for an organization.

Parameters:
  • name (str) – List locations whose name contains this string (case-insensitive).

  • location_id (str) – List locations by ID.

  • org_id (str) – List locations in this organization. Only admin users of another organization (such as partners) may use this parameter.

Returns:

generator of Location instances

async list(name: str | None = None, location_id: str | None = None, org_id: str | None = None, **params) List[Location][source]

List locations for an organization.

Parameters:
  • name (str) – List locations whose name contains this string (case-insensitive).

  • location_id (str) – List locations by ID.

  • org_id (str) – List locations in this organization. Only admin users of another organization (such as partners) may use this parameter.

Returns:

generator of Location instances

async by_name(name: str, org_id: str | None = None) Location | None[source]

Get a location by name

Parameters:
  • name (str) – name of the location to search

  • org_id (str) – search in list of locations in this organization. Only admin users of another organization (such as partners) may use this parameter.

Returns:

locations

Return type:

Location

async details(location_id: str, org_id: str | None = None) Location[source]

Shows details for a location, by ID.

Parameters:
  • location_id (str) – A unique identifier for the location.

  • org_id (str) – Get location common attributes for this organization.

Returns:

location details

Return type:

Location

async create(name: str, time_zone: str, preferred_language: str, announcement_language: str, address1: str, city: str, state: str, postal_code: str, country: str, address2: str | None = None, latitude: str | None = None, longitude: str | None = None, notes: str | None = None, org_id: str | None = None) str[source]

Create a new Location for a given organization. Only an admin in the organization can create a new Location.

Creating a location in your organization requires an administrator auth token with the spark-admin:locations_write.

Partners may specify orgId query parameter to create location in managed organization.

The following body parameters are required to create a new location: name, timeZone, preferredLanguage, address, announcementLanguage.

latitude, longitude and notes are optional parameters to create a new location.

Parameters:
  • name (str) – The name of the location.

  • time_zone (str) – Time zone associated with this location

  • preferred_language (str) – Default email language.

  • announcement_language (str) – Location’s phone announcement language.

  • address1 (str) – Address 1

  • address2 (str) – Address 2

  • city (str) – City

  • state (str) – State Code

  • postal_code (str) – Postal Code

  • country (str) – ISO-3166 2-Letter Country Code.

  • org_id (str) – Create a location common attribute for this organization.

  • latitude (str) – Latitude

  • longitude (str) – Longitude

  • notes (str) – Notes

Returns:

ID of new location

Return type:

str

async update(location_id: str, settings: Location, org_id: str | None = None)[source]

Update details for a location, by ID.

Specify the location ID in the locationId parameter in the URI. Only an admin can update a location details.

Updating a location in your organization requires an administrator auth token with the spark-admin:locations_write.

Parameters:
  • location_id (str) – Update location common attributes for this location.

  • settings (Location) – new settings for the org:

  • org_id (str) – Update location common attributes for this organization

async list_floors(location_id: str) List[Floor][source]

List Location Floors

List location floors. Requires an administrator auth token with the spark-admin:locations_read scope.

Parameters:

location_id (str) – A unique identifier for the location.

Return type:

list[Floor]

async create_floor(location_id: str, floor_number: int, display_name: str | None = None) Floor[source]

Create a Location Floor

Create a new floor in the given location. The displayName parameter is optional, and omitting it will result in the creation of a floor without that value set. Requires an administrator auth token with the spark-admin:locations_write scope.

Parameters:
  • location_id (str) – A unique identifier for the location.

  • floor_number (int) – The floor number.

  • display_name (str) – The floor display name.

Return type:

Floor

async floor_details(location_id: str, floor_id: str) Floor[source]

Get Location Floor Details

Shows details for a floor, by ID. Specify the floor ID in the floorId parameter in the URI. Requires an administrator auth token with the spark-admin:locations_read scope.

Parameters:
  • location_id (str) – A unique identifier for the location.

  • floor_id (str) – A unique identifier for the floor.

Return type:

Floor

async update_floor(floor: Floor) Floor[source]

Update a Location Floor

Updates details for a floor, by ID. Specify the floor ID in the floorId parameter in the URI. Include all details for the floor returned by a previous call to Get Location Floor Details. Omitting the optional displayName field will result in that field no longer being defined for the floor. Requires an administrator auth token with the spark-admin:locations_write scope.

Parameters:

floor (Floor) – new floor settings

Return type:

Floor

async delete_floor(location_id: str, floor_id: str)[source]

Delete a Location Floor

Deletes a floor, by ID. Requires an administrator auth token with the spark-admin:locations_write scope.

Parameters:
  • location_id (str) – A unique identifier for the location.

  • floor_id (str) – A unique identifier for the floor.

Return type:

None

base = 'locations'
class wxc_sdk.as_api.AsManageNumbersJobsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

API for jobs to manage numbers

list_gen(org_id: str | None = None, **params) AsyncGenerator[NumberJob, None, None][source]

Lists all Manage Numbers jobs for the given organization in order of most recent one to oldest one irrespective of its status. The public API only supports initiating jobs which move numbers between locations. Via Control Hub they can initiate both the move and delete, so this listing can show both. This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:

org_id (str) – Retrieve list of Manage Number jobs for this organization.

async list(org_id: str | None = None, **params) List[NumberJob][source]

Lists all Manage Numbers jobs for the given organization in order of most recent one to oldest one irrespective of its status. The public API only supports initiating jobs which move numbers between locations. Via Control Hub they can initiate both the move and delete, so this listing can show both. This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:

org_id (str) – Retrieve list of Manage Number jobs for this organization.

async initiate_job(operation: str, target_location_id: str, number_list: List[NumberItem]) NumberJob[source]

Starts the numbers move from one location to another location. Although jobs can do both MOVE and DELETE actions internally, only MOVE is supported publicly. In order to move a number, For example, you can move from Cisco PSTN to Cisco PSTN, but you cannot move from Cisco PSTN to a location with Cloud Connected PSTN. This API requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • operation (str) – Indicates the kind of operation to be carried out.

  • target_location_id (str) – The target location within organization where the unassigned numbers will be moved from the source location.

  • number_list (list[NumberItem]) – Indicates the numbers to be moved from source to target locations.

async status(job_id: str | None = None) NumberJob[source]

Returns the status and other details of the job. This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:

job_id (str) – Retrieve job details for this jobId.

async pause(job_id: str | None = None, org_id: str | None = None)[source]

Pause the running Manage Numbers Job. A paused job can be resumed or abandoned. This API requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • job_id (str) – Pause the Manage Numbers job for this jobId.

  • org_id (str) – Pause the Manage Numbers job for this organization.

async resume(job_id: str | None = None, org_id: str | None = None)[source]

Resume the paused Manage Numbers Job. A paused job can be resumed or abandoned. This API requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • job_id (str) – Resume the Manage Numbers job for this jobId.

  • org_id (str) – Resume the Manage Numbers job for this organization.

async abandon(job_id: str | None = None, org_id: str | None = None)[source]

Abandon the Manage Numbers Job. This API requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • job_id (str) – Abandon the Manage Numbers job for this jobId.

  • org_id (str) – Abandon the Manage Numbers job for this organization.

errors_gen(job_id: str | None = None, org_id: str | None = None, **params) AsyncGenerator[ManageNumberErrorItem, None, None][source]

Lists all error details of Manage Numbers job. This will not list any errors if exitCode is COMPLETED. If the status is COMPLETED_WITH_ERRORS then this lists the cause of failures. List of possible Errors: This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • job_id (str) – Retrieve the error details for this jobId.

  • org_id (str) – Retrieve list of jobs for this organization.

async errors(job_id: str | None = None, org_id: str | None = None, **params) List[ManageNumberErrorItem][source]

Lists all error details of Manage Numbers job. This will not list any errors if exitCode is COMPLETED. If the status is COMPLETED_WITH_ERRORS then this lists the cause of failures. List of possible Errors: This API requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • job_id (str) – Retrieve the error details for this jobId.

  • org_id (str) – Retrieve list of jobs for this organization.

base = 'telephony/config/jobs/numbers'
class wxc_sdk.as_api.AsMeetingChatsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Chats are content captured in a meeting when chat messages are sent between the participants within a meeting. This feature allows a Compliance Officer to access the in-meeting chat content.

The Compliance Officer can use the Meeting Chats API to retrieve the chats of a meeting and to delete all chats associated with a meeting. private chats are text messages between two people. group chats are for larger breakout spaces. Meeting chats are different from room messages in that there is no catch-up propagation. For example, if a user joins a meeting late only, chat messages that are created from then on, will be propagated to this user. To understand which user saw which message if they joined late, you have to query the meetingParticipants REST resource for the joined/left times and compare to the meetingsChat chatTime field.

The Webex meetings chat functionality and API endpoint described here is “upon-request” and not enabled by default. If you need it enabled for your org, or if you need help, please contact the Webex Developer Support team at devsupport@webex.com.

list_gen(meeting_id: str, offset: int | None = None, **params) AsyncGenerator[ChatObject, None, None][source]

Lists the meeting chats of a finished meeting instance specified by meetingId. You can set a maximum number of chats to return.

Use this operation to list the chats of a finished meeting instance when they are ready. Please note that only meeting instances in state ended are supported for meetingId. Meeting series, scheduled meetings and in-progress meeting instances are not supported.

Parameters:
  • meeting_id (str) – A unique identifier for the meeting instance to which the chats belong. The meeting ID of a scheduled personal room meeting is not supported.

  • offset (int) – Offset from the first result that you want to fetch.

async list(meeting_id: str, offset: int | None = None, **params) List[ChatObject][source]

Lists the meeting chats of a finished meeting instance specified by meetingId. You can set a maximum number of chats to return.

Use this operation to list the chats of a finished meeting instance when they are ready. Please note that only meeting instances in state ended are supported for meetingId. Meeting series, scheduled meetings and in-progress meeting instances are not supported.

Parameters:
  • meeting_id (str) – A unique identifier for the meeting instance to which the chats belong. The meeting ID of a scheduled personal room meeting is not supported.

  • offset (int) – Offset from the first result that you want to fetch.

async delete(meeting_id: str)[source]

Deletes the meeting chats of a finished meeting instance specified by meetingId.

Use this operation to delete the chats of a finished meeting instance when they are ready. Please note that only meeting instances in state ended are supported for meetingId. Meeting series, scheduled meetings and in-progress meeting instances are not supported.

Parameters:

meeting_id (str) – A unique identifier for the meeting instance to which the chats belong. Meeting IDs of a scheduled personal room meeting are not supported.

base = 'meetings/postMeetingChats'
class wxc_sdk.as_api.AsMeetingClosedCaptionsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Meeting Closed Captions APIs are enabled upon request, and are not available by default. Please contact the Webex Developer Support team at devsupport@webex.com if you would like to enable this feature for your organization. Meeting closed captions are the automatic transcriptions of what is being said during a meeting in real-time. Closed captions appear after being enabled during a meeting and can be translated to a participant’s language. A closed caption snippet is a short text snippet from a meeting closed caption which was spoken by a particular participant in the meeting. A meeting’s closed captions consists of many snippets. The Closed Captions API manages meeting closed captions and snippets. You can list meeting closed captions, as well as list and download snippets. Closed captions can be retrieved in either Web Video Text Tracks (VTT) or plain text (TXT) format via the download links provided by the vttDownloadLink and txtDownloadlink response properties, respectively. Refer to the Meetings API Scopes section of Meetings Overview guide for the scopes required for each API. Notes: Currently, closed caption APIs are only supported for the Compliance Officer role. Closed captions will be available 15 minutes after the meeting is finished.

list_gen(meeting_id: str, **params) AsyncGenerator[ClosedCaption, None, None][source]

Lists closed captions of a finished meeting instance specified by meetingId.

Parameters:

meeting_id (str) – Unique identifier for the meeting instance which the closed captions belong to. This parameter only applies to ended meeting instnaces. It does not apply to meeting series, scheduled meetings or scheduled personal room meetings.

async list(meeting_id: str, **params) List[ClosedCaption][source]

Lists closed captions of a finished meeting instance specified by meetingId.

Parameters:

meeting_id (str) – Unique identifier for the meeting instance which the closed captions belong to. This parameter only applies to ended meeting instnaces. It does not apply to meeting series, scheduled meetings or scheduled personal room meetings.

list_snippets_gen(closed_caption_id: str, meeting_id: str, **params) AsyncGenerator[CCSnippet, None, None][source]

Lists snippets of a meeting closed caption specified by closedCaptionId.

Parameters:
  • closed_caption_id (str) – Unique identifier for the meeting closed caption which the snippets belong to.

  • meeting_id (str) – Unique identifier for the meeting instance which the closed caption snippets belong to. This parameter only applies to ended meeting instances. It does not apply to meeting series, scheduled meetings or scheduled personal room meetings.

async list_snippets(closed_caption_id: str, meeting_id: str, **params) List[CCSnippet][source]

Lists snippets of a meeting closed caption specified by closedCaptionId.

Parameters:
  • closed_caption_id (str) – Unique identifier for the meeting closed caption which the snippets belong to.

  • meeting_id (str) – Unique identifier for the meeting instance which the closed caption snippets belong to. This parameter only applies to ended meeting instances. It does not apply to meeting series, scheduled meetings or scheduled personal room meetings.

async download_snippets(closed_caption_id: str, meeting_id: str, format: str | None = None)[source]

Download meeting closed caption snippets from the meeting closed caption specified by closedCaptionId formatted either as a Video Text Track (.vtt) file or plain text (.txt) file.

Parameters:
  • closed_caption_id (str) – Unique identifier for the meeting closed caption.

  • meeting_id (str) – Unique identifier for the meeting instance which the closed caption snippets belong to. This parameter only applies to meeting instances in the ended state. It does not apply to meeting series, scheduled meetings or scheduled personal room meetings.

  • format (str) – Format for the downloaded meeting closed caption snippets. Possible values: vtt, txt

base = 'meetingClosedCaptions'
class wxc_sdk.as_api.AsMeetingInviteesApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

This API manages invitees’ relationships to a meeting. You can use the Meeting Invitees API to list, create, update, and delete invitees. Refer to the Meetings API Scopes section of Meetings Overview for scopes required for each API.

list_gen(meeting_id: str, host_email: str | None = None, panelist: bool | None = None, **params) AsyncGenerator[Invitee, None, None][source]

Lists meeting invitees for a meeting with a specified meetingId. You can set a maximum number of invitees to return. This operation can be used for meeting series, scheduled meetings, and ended or ongoing meeting instance objects. If the specified meetingId is for a meeting series, the invitees for the series will be listed; if the meetingId is for a scheduled meeting, the invitees for the particular scheduled meeting will be listed; if the meetingId is for an ended or ongoing meeting instance, the invitees for the particular meeting instance will be listed. See the Webex Meetings guide for more information about the types of meetings. The list returned is sorted in ascending order by email address. Long result sets are split into pages.

Parameters:
  • meeting_id (str) – Unique identifier for the meeting for which invitees are being requested. The meeting can be a meeting series, a scheduled meeting, or a meeting instance which has ended or is ongoing. The meeting ID of a scheduled personal room meeting is not supported for this API.

  • host_email (str) – Email address for the meeting host. This parameter is only used if the user or application calling the API has the admin on-behalf-of scopes. If set, the admin may specify the email of a user in a site they manage and the API will return meeting invitees that are hosted by that user.

  • panelist (bool) – Filter invitees or attendees for webinars only. If true, returns invitees. If false, returns attendees. If null, returns both invitees and attendees.

async list(meeting_id: str, host_email: str | None = None, panelist: bool | None = None, **params) List[Invitee][source]

Lists meeting invitees for a meeting with a specified meetingId. You can set a maximum number of invitees to return. This operation can be used for meeting series, scheduled meetings, and ended or ongoing meeting instance objects. If the specified meetingId is for a meeting series, the invitees for the series will be listed; if the meetingId is for a scheduled meeting, the invitees for the particular scheduled meeting will be listed; if the meetingId is for an ended or ongoing meeting instance, the invitees for the particular meeting instance will be listed. See the Webex Meetings guide for more information about the types of meetings. The list returned is sorted in ascending order by email address. Long result sets are split into pages.

Parameters:
  • meeting_id (str) – Unique identifier for the meeting for which invitees are being requested. The meeting can be a meeting series, a scheduled meeting, or a meeting instance which has ended or is ongoing. The meeting ID of a scheduled personal room meeting is not supported for this API.

  • host_email (str) – Email address for the meeting host. This parameter is only used if the user or application calling the API has the admin on-behalf-of scopes. If set, the admin may specify the email of a user in a site they manage and the API will return meeting invitees that are hosted by that user.

  • panelist (bool) – Filter invitees or attendees for webinars only. If true, returns invitees. If false, returns attendees. If null, returns both invitees and attendees.

async create_invitee(email: str, meeting_id: str, display_name: str | None = None, co_host: bool | None = None, send_email: bool | None = None, panelist: bool | None = None, host_email: str | None = None) Invitee[source]

Invite a person to attend a meeting. Identify the invitee in the request body, by email address.

Parameters:
  • email (str) – Email address for meeting invitee.

  • meeting_id (str) – Unique identifier for the meeting to which a person is being invited. This attribute only applies to meeting series and scheduled meeting. If it’s a meeting series, the meeting invitee is invited to the entire meeting series; if it’s a scheduled meeting, the meeting invitee is invited to this individual scheduled meeting. It doesn’t apply to an ended or ongoing meeting instance. The meeting ID of a scheduled personal room meeting is not supported for this API.

  • display_name (str) – Display name for meeting invitee. The maximum length of displayName is 128 characters. In Webex App, if the email has been associated with an existing Webex account, the display name associated with the Webex account will be used; otherwise, the email will be used as displayName. In Webex site, if displayName is specified, it will show displayName. If displayName is not specified, and the email has been associated with an existing Webex account, the display name associated with the Webex account will be used; otherwise, the email will be used as displayName. Please note that if the invitee has an existing Webex account, the displayName shown in the meeting will be the displayName associated with the Webex account; otherwise, displayName shown in the meeting will be the displayName which is specified by the invitee who does not have a Webex account.

  • co_host (bool) – Whether or not invitee is a designated alternate host for the meeting. See Add Alternate Hosts for Cisco Webex Meetings for more details.

  • send_email (bool) – If true, send an email to the invitee.

  • panelist (bool) – If true, the invitee is a designated panelist for the event meeting.

  • host_email (str) – Email address for the meeting host. This attribute should only be set if the user or application calling the API has the admin on-behalf-of scopes. When used, the admin may specify the email of a user in a site they manage to be the meeting host.

async create_invitees(meeting_id: str, items: List[CreateInviteesItem], host_email: str | None = None) List[Invitee][source]

Invite people to attend a meeting in bulk. Identify each invitee by the email address of each item in the items of the request body. Each invitee should have a unique email. This API limits the maximum size of items in the request body to 100.

Parameters:
  • meeting_id (str) – Unique identifier for the meeting to which the people are being invited. This attribute only applies to meeting series and scheduled meetings. If it’s a meeting series, the meeting invitees are invited to the entire meeting series; if it’s a scheduled meeting, the meeting invitees are invited to this individual scheduled meeting. It doesn’t apply to an ended or ongoing meeting instance. The meeting ID of a scheduled personal room meeting is not supported for this API.

  • host_email (str) – Email address for the meeting host. This attribute should only be set if the user or application calling the API has the admin on-behalf-of scopes. When used, the admin may specify the email of a user in a site they manage to be the meeting host.

  • items (CreateInviteesItem) – Meeting invitees to be inserted.

async invitee_details(meeting_invitee_id: str, host_email: str | None = None) Invitee[source]

Retrieve details for a meeting invitee identified by a meetingInviteeId in the URI.

Parameters:
  • meeting_invitee_id (str) – Unique identifier for the invitee whose details are being requested.

  • host_email (str) – Email address for the meeting host. This parameter is only used if the user or application calling the API has the admin on-behalf-of scopes. If set, the admin may specify the email of a user in a site they manage and the API will return details for a meeting invitee that is hosted by that user.

async update(meeting_invitee_id: str, email: str, display_name: str | None = None, co_host: bool | None = None, send_email: bool | None = None, panelist: bool | None = None, host_email: str | None = None) Invitee[source]

Update details for a meeting invitee identified by a meetingInviteeId in the URI.

Parameters:
  • meeting_invitee_id (str) – Unique identifier for the invitee to be updated. This parameter only applies to an invitee to a meeting series or a scheduled meeting. It doesn’t apply to an invitee to an ended or ongoing meeting instance.

  • email (str) – Email address for meeting invitee.

  • display_name (str) – Display name for meeting invitee. The maximum length of displayName is 128 characters. In Webex App, if the email has been associated with an existing Webex account, the display name associated with the Webex account will be used; otherwise, the email will be used as displayName. In Webex site, if displayName is specified, it will show displayName. If displayName is not specified, and the email has been associated with an existing Webex account, the display name associated with the Webex account will be used; otherwise, the email will be used as displayName. Please note that if the invitee has an existing Webex account, the displayName shown in the meeting will be the displayName associated with the Webex account; otherwise, displayName shown in the meeting will be the displayName which is specified by the invitee who does not have a Webex account.

  • co_host (bool) – Whether or not invitee is a designated alternate host for the meeting. See Add Alternate Hosts for Cisco Webex Meetings for more details.

  • send_email (bool) – If true, send an email to the invitee.

  • panelist (bool) – If true, the invitee is a designated panelist for the event meeting.

  • host_email (str) – Email address for the meeting host. This attribute should only be set if the user or application calling the API has the admin on-behalf-of scopes. When used, the admin may specify the email of a user in a site they manage to be the meeting host.

async delete(meeting_invitee_id: str, host_email: str | None = None, send_email: bool | None = None)[source]

Removes a meeting invitee identified by a meetingInviteeId specified in the URI. The deleted meeting invitee cannot be recovered. If the meeting invitee is associated with a meeting series, the invitee will be removed from the entire meeting series. If the invitee is associated with a scheduled meeting, the invitee will be removed from only that scheduled meeting.

Parameters:
  • meeting_invitee_id (str) – Unique identifier for the invitee to be removed. This parameter only applies to an invitee to a meeting series or a scheduled meeting. It doesn’t apply to an invitee to an ended or ongoing meeting instance.

  • host_email (str) – Email address for the meeting host. This parameter is only used if the user or application calling the API has the admin on-behalf-of scopes. If set, the admin may specify the email of a user in a site they manage and the API will delete a meeting invitee that is hosted by that user.

  • send_email (bool) – If true, send an email to the invitee.

base = 'meetingInvitees'
class wxc_sdk.as_api.AsMeetingParticipantsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

This API manages meeting participants. Refer to the Meetings API Scopes section of Meetings Overview for scopes required for each API.

list_participants_gen(meeting_id: str, host_email: str | None = None, join_time_from: str | None = None, join_time_to: str | None = None, **params) AsyncGenerator[Participant, None, None][source]

List all participants in a live or post meeting. The meetingId parameter is required, which is the unique identifier for the meeting. The authenticated user calling this API must either have an Administrator role with the meeting:admin_participants_read scope, or be the meeting host.

Parameters:
  • meeting_id (str) – The unique identifier for the meeting. Please note that currently meeting ID of a scheduled personal room meeting is not supported for this API.

  • host_email (str) – Email address for the meeting host. This parameter is only used if the user or application calling the API has the admin-level scopes, the admin may specify the email of a user in a site they manage and the API will return meeting participants of the meetings that are hosted by that user.

  • join_time_from (str) – The time participants join a meeting starts from the specified date and time (inclusive) in any ISO 8601 compliant format. If joinTimeFrom is not specified, it equals joinTimeTo minus 7 days.

  • join_time_to (str) – The time participants join a meeting before the specified date and time (exclusive) in any ISO 8601 compliant format. If joinTimeTo is not specified, it equals joinTimeFrom plus 7 days. The interval between joinTimeFrom and joinTimeTo must be within 90 days.

async list_participants(meeting_id: str, host_email: str | None = None, join_time_from: str | None = None, join_time_to: str | None = None, **params) List[Participant][source]

List all participants in a live or post meeting. The meetingId parameter is required, which is the unique identifier for the meeting. The authenticated user calling this API must either have an Administrator role with the meeting:admin_participants_read scope, or be the meeting host.

Parameters:
  • meeting_id (str) – The unique identifier for the meeting. Please note that currently meeting ID of a scheduled personal room meeting is not supported for this API.

  • host_email (str) – Email address for the meeting host. This parameter is only used if the user or application calling the API has the admin-level scopes, the admin may specify the email of a user in a site they manage and the API will return meeting participants of the meetings that are hosted by that user.

  • join_time_from (str) – The time participants join a meeting starts from the specified date and time (inclusive) in any ISO 8601 compliant format. If joinTimeFrom is not specified, it equals joinTimeTo minus 7 days.

  • join_time_to (str) – The time participants join a meeting before the specified date and time (exclusive) in any ISO 8601 compliant format. If joinTimeTo is not specified, it equals joinTimeFrom plus 7 days. The interval between joinTimeFrom and joinTimeTo must be within 90 days.

async query_participants_with_email(meeting_id: str, max: int | None = None, host_email: str | None = None, join_time_from: str | None = None, join_time_to: str | None = None, emails: list[str] | None = None) list[Participant][source]

Query participants in a live meeting, or after the meeting, using participant’s email. The meetingId parameter is the unique identifier for the meeting and is required. The authenticated user calling this API must either have an Administrator role with the meeting:admin_participants_read scope, or be the meeting host.

Parameters:
  • meeting_id (str) – The unique identifier for the meeting.

  • max (int) – Limit the maximum number of participants in the response, up to 1000.

  • host_email (str) – Email address for the meeting host. This parameter is only used if the user or application calling the API has the admin-level scopes, the admin may specify the email of a user in a site they manage and the API will return meeting participants of the meetings that are hosted by that user.

  • join_time_from (str) – The time participants join a meeting starts from the specified date and time (inclusive) in any ISO 8601 compliant format. If joinTimeFrom is not specified, it equals joinTimeTo minus 7 days.

  • join_time_to (str) – The time participants join a meeting before the specified date and time (exclusive) in any ISO 8601 compliant format. If joinTimeTo is not specified, it equals joinTimeFrom plus 7 days. The interval between joinTimeFrom and joinTimeTo must be within 90 days.

  • emails (List[str]) – Participants email list Possible values: a@example.com

async participant_details(participant_id: str, host_email: str | None = None) Participant[source]

Get a meeting participant details of a live or post meeting. The participantId is required to identify the meeting and the participant. The authenticated user calling this API must either have an Administrator role with the meeting:admin_participants_read scope, or be the meeting host.

Parameters:
  • participant_id (str) – The unique identifier for the meeting and the participant.

  • host_email (str) – Email address for the meeting host. This parameter is only used if the user or application calling the API has the admin-level scopes, the admin may specify the email of a user in a site they manage and the API will return meeting participants of the meetings that are hosted by that user.

async update_participant(participant_id: str, muted: bool | None = None, admit: bool | None = None, expel: bool | None = None) UpdateParticipantResponse[source]

To mute, un-mute, expel, or admit a participant in a live meeting. The participantId is required to identify the meeting and the participant. Notes:

Parameters:
  • participant_id (str) – The unique identifier for the meeting and the participant.

  • muted (bool) – The value is true or false, and means to mute or unmute the audio of a participant.

  • admit (bool) – The value can be true or false. The value of true is to admit a participant to the meeting if the participant is in the lobby, No-Op if the participant is not in the lobby or when the value is set to false.

  • expel (bool) – The attribute is exclusive and its value can be true or false. The value of true means that the participant will be expelled from the meeting, the value of false means No-Op.

async admit_participants(participant_ids: List[str] | None = None)[source]

To admit participants into a live meeting in bulk. This API limits the maximum size of items in the request body to 100. Each participantId of items in the request body should have the same prefix of meetingId.

Parameters:

participant_ids (List[str]) – The ID that identifies the meeting participant.

base = 'meetingParticipants'
class wxc_sdk.as_api.AsMeetingPreferencesApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

This API manages a user’s meeting preferences, including Personal Meeting Room settings, video and audio settings, meeting scheduling options, and site settings. Refer to the Meetings API Scopes section of Meetings Overview for scopes required for each API.

async details(user_email: str | None = None, site_url: str | None = None) MeetingPreferenceDetails[source]

Retrieves meeting preferences for the authenticated user.

Parameters:
  • user_email (str) – Email address for the user. This parameter is only used if the user or application calling the API has the required admin-level scopes. If set, the admin may specify the email of a user in a site they manage and the API will return details of the meeting preferences for that user.

  • site_url (str) – URL of the Webex site to query. For individual use, if siteUrl is not specified, the query will use the default site of the user. For admin use, if siteUrl is not specified, the query will use the default site for the admin’s authorization token used to make the call. In the case where the user belongs to a site different than the admin’s default site, the admin can set the site to query using the siteUrl parameter. All available Webex sites and default site of a user can be retrieved from /meetingPreferences/sites.

async personal_meeting_room_options(user_email: str | None = None, site_url: str | None = None) PersonalMeetingRoomOptions[source]

Retrieves the Personal Meeting Room options for the authenticated user.

Parameters:
  • user_email (str) – Email address for the user. This parameter is only used if the user or application calling the API has the admin-level scopes. If set, the admin may specify the email of a user in a site they manage and the API will return details of the Personal Meeting Room options for that user.

  • site_url (str) – URL of the Webex site to query. For individual use, if siteUrl is not specified, the query will use the default site of the user. For admin use, if siteUrl is not specified, the query will use the default site for the admin’s authorization token used to make the call. In the case where the user belongs to a site different than the admin’s default site, the admin can set the site to query using the siteUrl parameter. All available Webex sites and default site of a user can be retrieved from /meetingPreferences/sites.

async update_personal_meeting_room_options(topic: str, host_pin: str, enabled_auto_lock: bool, auto_lock_minutes: int, enabled_notify_host: bool, support_co_host: bool, co_hosts: CoHost, user_email: str | None = None, site_url: str | None = None, support_anyone_as_co_host: bool | None = None, allow_first_user_to_be_co_host: bool | None = None, allow_authenticated_devices: bool | None = None) PersonalMeetingRoomOptions[source]

Update a single meeting

Parameters:
  • topic (str) – Personal Meeting Room topic to be updated.

  • host_pin (str) – Updated PIN for joining the room as host. The host PIN must be digits of a predefined length, e.g. 4 digits. It cannot contain sequential digits, such as 1234 or 4321, or repeated digits of the predefined length, such as 1111. The predefined length for host PIN can be viewed in user’s My Personal Room page and it can only be changed by site administrator.

  • enabled_auto_lock (bool) – Update for option to automatically lock the Personal Room a number of minutes after a meeting starts. When a room is locked, invitees cannot enter until the owner admits them. The period after which the meeting is locked is defined by autoLockMinutes.

  • auto_lock_minutes (int) – Updated number of minutes after which the Personal Room is locked if enabledAutoLock is enabled. Valid options are 0, 5, 10, 15 and 20.

  • enabled_notify_host (bool) – Update for flag to enable notifying the owner of a Personal Room when someone enters the Personal Room lobby while the owner is not in the room.

  • support_co_host (bool) – Update for flag allowing other invitees to host a meetingCoHost in the Personal Room without the owner.

  • co_hosts (CoHost) – Updated array defining cohosts for the room if both supportAnyoneAsCoHost and allowFirstUserToBeCoHost are false

  • user_email (str) – Email address for the user. This parameter is only used if the user or application calling the API has the admin-level scopes. If set, the admin may specify the email of a user in a site they manage and the API will update Personal Meeting Room options for that user.

  • site_url (str) – URL of the Webex site to query. For individual use, if siteUrl is not specified, the query will use the default site of the user. For admin use, if siteUrl is not specified, the query will use the default site for the admin’s authorization token used to make the call. In the case where the user belongs to a site different than the admin’s default site, the admin can set the site to query using the siteUrl parameter. All available Webex sites and default site of a user can be retrieved from /meetingPreferences/sites.

  • support_anyone_as_co_host (bool) – Whether or not to allow any attendee with a host account on the target site to become a cohost when joining the Personal Room. The target site is user’s preferred site.

  • allow_first_user_to_be_co_host (bool) – Whether or not to allow the first attendee with a host account on the target site to become a cohost when joining the Personal Room. The target site is user’s preferred site.

  • allow_authenticated_devices (bool) – Whether or not to allow authenticated video devices in the user’s organization to start or join the meeting without a prompt.

async audio_options(user_email: str | None = None, site_url: str | None = None) Audio[source]

Retrieves audio options for the authenticated user.

Parameters:
  • user_email (str) – Email address for the user. This parameter is only used if the user or application calling the API has the admin-level scopes. If set, the admin may specify the email of a user in a site they manage and the API will return details of the audio options for that user.

  • site_url (str) – URL of the Webex site to query. For individual use, if siteUrl is not specified, the query will use the default site of the user. For admin use, if siteUrl is not specified, the query will use the default site for the admin’s authorization token used to make the call. In the case where the user belongs to a site different than the admin’s default site, the admin can set the site to query using the siteUrl parameter. All available Webex sites and default site of a user can be retrieved from /meetingPreferences/sites.

async update_audio_options(user_email: str | None = None, site_url: str | None = None, default_audio_type: DefaultAudioType | None = None, other_teleconference_description: str | None = None, enabled_global_call_in: bool | None = None, enabled_toll_free: bool | None = None, enabled_auto_connection: bool | None = None, audio_pin: str | None = None, office_number: OfficeNumber | None = None, mobile_number: OfficeNumber | None = None) Audio[source]

Updates audio options for the authenticated user.

Parameters:
  • user_email (str) – Email address for the user. This parameter is only used if the user or application calling the API has the admin-level scopes. If set, the admin may specify the email of a user in a site they manage and the API will update audio options for that user.

  • site_url (str) – URL of the Webex site to query. For individual use, if siteUrl is not specified, the query will use the default site of the user. For admin use, if siteUrl is not specified, the query will use the default site for the admin’s authorization token used to make the call. In the case where the user belongs to a site different than the admin’s default site, the admin can set the site to query using the siteUrl parameter. All available Webex sites and default site of a user can be retrieved from /meetingPreferences/sites.

  • default_audio_type (DefaultAudioType) – Default audio type. This attribute can be modified with the with the Update Audio Options API.

  • other_teleconference_description (str) – Phone number and other information for the teleconference provider to be used, along with instructions for invitees. This attribute can be modified with the with the Update Audio Options API.

  • enabled_global_call_in (bool) – Flag to enable/disable global call ins. Note: If the site does not support global call-ins, you cannot set this option. This attribute can be modified with the with the Update Audio Options API.

  • enabled_toll_free (bool) – Flag to enable/disable call-ins from toll-free numbers. Note: If the site does not support calls from toll-free numbers, you cannot set this option. This attribute can be modified with the with the Update Audio Options API.

  • enabled_auto_connection (bool) – Flag to enable/disable automatically connecting to audio using a computer. The meeting host can enable/disable this option. When this option is set to true, the user is automatically connected to audio via a computer when they start or join a Webex Meetings meeting on a desktop. This attribute can be modified with the Update Audio Options API.

  • audio_pin (str) – PIN to provide a secondary level of authentication for calls where the host is using the phone and may need to invite additional invitees. It must be exactly 4 digits. It cannot contain sequential digits, such as 1234 or 4321, or repeat a digit 4 times, such as 1111. This attribute can be modified with the with the Update Audio Options API.

  • office_number (OfficeNumber) – Office phone number. We recommend that phone numbers be specified to facilitate connecting via audio. This attribute can be modified with the with the Update Audio Options API.

  • mobile_number (OfficeNumber) – Mobile phone number. We recommend that phone numbers be specified to facilitate connecting via audio. This attribute can be modified with the with the Update Audio Options API.

async video_options(user_email: str | None = None, site_url: str | None = None) list[VideoDevice][source]

Retrieves video options for the authenticated user.

Parameters:
  • user_email (str) – Email address for the user. This parameter is only used if the user or application calling the API has the admin-level scopes. If set, the admin may specify the email of a user in a site they manage and the API will return details of the video options for that user.

  • site_url (str) – URL of the Webex site to query. For individual use, if siteUrl is not specified, the query will use the default site of the user. For admin use, if siteUrl is not specified, the query will use the default site for the admin’s authorization token used to make the call. In the case where the user belongs to a site different than the admin’s default site, the admin can set the site to query using the siteUrl parameter. All available Webex sites and default site of a user can be retrieved using Get Site List.

async update_video_options(video_devices: VideoDevice, user_email: str | None = None, site_url: str | None = None) list[VideoDevice][source]

Updates video options for the authenticated user.

Parameters:
  • video_devices (VideoDevice) – Array of video devices. If the array is not empty, one device and no more than one devices must be set as default device.

  • user_email (str) – Email address for the user. This parameter is only used if the user or application calling the API has the admin-level scopes. If set, the admin may specify the email of a user in a site they manage and the API will update video options for that user.

  • site_url (str) – URL of the Webex site to query. For individual use, if siteUrl is not specified, the query will use the default site of the user. For admin use, if siteUrl is not specified, the query will use the default site for the admin’s authorization token used to make the call. In the case where the user belongs to a site different than the admin’s default site, the admin can set the site to query using the siteUrl parameter. All available Webex sites and default site of a user can be retrieved from /meetingPreferences/sites.

async scheduling_options(user_email: str | None = None, site_url: str | None = None) SchedulingOptions[source]

Retrieves scheduling options for the authenticated user.

Parameters:
  • user_email (str) – Email address for the user. This parameter is only used if the user or application calling the API has the admin-level scopes. If set, the admin may specify the email of a user in a site they manage and the API will return details of the scheduling options for that user.

  • site_url (str) – URL of the Webex site to query. For individual use, if siteUrl is not specified, the query will use the default site of the user. For admin use, if siteUrl is not specified, the query will use the default site for the admin’s authorization token used to make the call. In the case where the user belongs to a site different than the admin’s default site, the admin can set the site to query using the siteUrl parameter. All available Webex sites and default site of a user can be retrieved from /meetingPreferences/sites.

async update_scheduling_options(user_email: str | None = None, site_url: str | None = None, enabled_join_before_host: bool | None = None, join_before_host_minutes: int | None = None, enabled_auto_share_recording: bool | None = None, enabled_webex_assistant_by_default: bool | None = None) SchedulingOptions[source]

Updates scheduling options for the authenticated user.

Parameters:
  • user_email (str) – Email address for the user. This parameter is only used if the user or application calling the API has the admin-level scopes. If set, the admin may specify the email of a user in a site they manage and the API will update scheduling options for that user.

  • site_url (str) – URL of the Webex site to query. For individual use, if siteUrl is not specified, the query will use the default site of the user. For admin use, if siteUrl is not specified, the query will use the default site for the admin’s authorization token used to make the call. In the case where the user belongs to a site different than the admin’s default site, the admin can set the site to query using the siteUrl parameter. All available Webex sites and default site of a user can be retrieved from /meetingPreferences/sites.

  • enabled_join_before_host (bool) – Flag to enable/disable Join Before Host. The period during which invitees can join before the start time is defined by autoLockMinutes. This attribute can be modified with the Update Scheduling Options API. Note: This feature is only effective if the site supports the Join Before Host feature. This attribute can be modified with the Update Scheduling Options API.

  • join_before_host_minutes (int) – Number of minutes before the start time that an invitee can join a meeting if enabledJoinBeforeHost is true. Valid options are 0, 5, 10 and 15. This attribute can be modified with the Update Scheduling Options API.

  • enabled_auto_share_recording (bool) – Flag to enable/disable the automatic sharing of the meeting recording with invitees when it is available. This attribute can be modified with the Update Scheduling Options API.

  • enabled_webex_assistant_by_default (bool) – Flag to automatically enable Webex Assistant whenever you start a meeting. This attribute can be modified with the Update Scheduling Options API.

async site_list(user_email: str | None = None) list[MeetingsSite][source]

Retrieves the list of Webex sites that the authenticated user is set up to use.

Parameters:

user_email (str) – Email address for the user. This parameter is only used if the user or application calling the API has the admin-level scopes. If set, the admin may specify the email of a user and the API will return the list of Webex sites for that user.

async update_default_site(default_site: bool, site_url: str, user_email: str | None = None) MeetingsSite[source]

Updates the default site for the authenticated user.

Parameters:
  • default_site (bool) – Whether or not to change user’s default site. Note: defaultSite should be set to true for the user’s single default site

  • site_url (str) – Access URL for the site.

  • user_email (str) – Email address for the user. This parameter is only used if the user or application calling the API has the admin-level scopes. If set, the admin may specify the email of a user in a site they manage and the API will update default site for that user.

base = 'meetingPreferences'
class wxc_sdk.as_api.AsMeetingQandAApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

During a Question and Answer (Q&A) session, attendees can pose questions to hosts, co-hosts, and presenters, who can answer and moderate those questions. You use the Meeting Q&A API to retrieve the questions and the answers in a meeting. Currently, these APIs are available to users with one of the meeting host, admin or Compliance Officer roles. The features and APIs described here are available upon-request and is not enabled by default. If would like this feature enabled for your organization please contact the Webex Developer Support team at devsupport@webex.com.

list_gen(meeting_id: str, **params) AsyncGenerator[QAObject, None, None][source]

Lists questions and answers from a meeting, when ready. Notes:

Parameters:

meeting_id (str) – A unique identifier for the meeting instance which the Q&A belongs to.

documentation: https://developer.webex.com/docs/api/v1/meeting-q-and-a/list-meeting-q-and-a

async list(meeting_id: str, **params) List[QAObject][source]

Lists questions and answers from a meeting, when ready. Notes:

Parameters:

meeting_id (str) – A unique identifier for the meeting instance which the Q&A belongs to.

documentation: https://developer.webex.com/docs/api/v1/meeting-q-and-a/list-meeting-q-and-a

list_answers_gen(question_id: str, meeting_id: str, **params) AsyncGenerator[AnswerObject, None, None][source]

Lists the answers to a specific question asked in a meeting.

Parameters:
  • question_id (str) – The ID of a question.

  • meeting_id (str) – A unique identifier for the meeting instance which the Q&A belongs to.

documentation: https://developer.webex.com/docs/api/v1/meeting-q-and-a/list-answers-of-a-question

async list_answers(question_id: str, meeting_id: str, **params) List[AnswerObject][source]

Lists the answers to a specific question asked in a meeting.

Parameters:
  • question_id (str) – The ID of a question.

  • meeting_id (str) – A unique identifier for the meeting instance which the Q&A belongs to.

documentation: https://developer.webex.com/docs/api/v1/meeting-q-and-a/list-answers-of-a-question

base = 'meetings/q_and_a'
class wxc_sdk.as_api.AsMeetingQualitiesApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

To retrieve quality information, you must use an administrator token with the analytics:read_all scope. The authenticated user must be a read-only or full administrator of the organization to which the meeting belongs and must not be an external administrator. To use this endpoint, the org needs to be licensed for the Webex Pro Pack. For CI-Native site, no additional settings are required. For CI-linked site, the admin must also be set as the Full/ReadOnly Site Admin of the site. A minimum Webex and Teams client version is required. For details, see Troubleshooting Help Doc. Quality information is available 10 minutes after a meeting has started and may be retrieved for up to 7 days. A rate limit of 1 API call every 5 minutes for the same meeting instance ID applies.

meeting_qualities_gen(meeting_id: str, offset: int | None = None, **params) AsyncGenerator[MediaSessionQuality, None, None][source]

Get quality data for a meeting, by meetingId. Only organization administrators can retrieve meeting quality data.

Parameters:
  • meeting_id (str) – Unique identifier for the specific meeting instance. Note: The meetingId can be obtained via the Meeting List API when meetingType=meeting. The id attribute in the Meeting List Response is what is needed, for example, e5dba9613a9d455aa49f6ffdafb6e7db_I_191395283063545470.

  • offset (int) – Offset from the first result that you want to fetch.

documentation: https://developer.webex.com/docs/api/v1/meeting-qualities/get-meeting-qualities

async meeting_qualities(meeting_id: str, offset: int | None = None, **params) List[MediaSessionQuality][source]

Get quality data for a meeting, by meetingId. Only organization administrators can retrieve meeting quality data.

Parameters:
  • meeting_id (str) – Unique identifier for the specific meeting instance. Note: The meetingId can be obtained via the Meeting List API when meetingType=meeting. The id attribute in the Meeting List Response is what is needed, for example, e5dba9613a9d455aa49f6ffdafb6e7db_I_191395283063545470.

  • offset (int) – Offset from the first result that you want to fetch.

documentation: https://developer.webex.com/docs/api/v1/meeting-qualities/get-meeting-qualities

base = ''
class wxc_sdk.as_api.AsMeetingTranscriptsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Not supported for Webex for Government (FedRAMP) A meeting transcript is the automatic transcription of a meeting’s recordings by our industry-leading speech-to-text engine to capture of what was discussed and decided during the meeting, in text form. A transcript snippet is a short text snippet from a meeting transcript which was spoken by a particular participant in the meeting. A meeting transcript consists of many snippets. This API manages meeting transcripts and snippets. You can use the Transcript API to list meeting transcripts, list, get and update transcript snippets. Transcripts may be retrieved via download link defined by vttDownloadLink or txtDownloadlink in the response body. Refer to the Meetings API Scopes section of Meetings Overview for scopes required for each API. NOTE:

list_gen(meeting_id: str | None = None, host_email: str | None = None, site_url: str | None = None, from_: str | None = None, to_: str | None = None, **params) AsyncGenerator[Transcript, None, None][source]

Lists available transcripts of an ended meeting instance. Use this operation to list transcripts of an ended meeting instance when they are ready. Please note that only meeting instances in state ended are supported for meetingId. Meeting series, scheduled meetings and in-progress meeting instances are not supported.

Parameters:
  • meeting_id (str) – Unique identifier for the meeting instance to which the transcript belongs. Please note that currently the meeting ID of a scheduled personal room meeting is not supported for this API. If meetingId is not specified, the operation returns an array of transcripts for all meetings of the current user.

  • host_email (str) – Email address for the meeting host. This parameter is only used if the user or application calling the API has the admin-level scopes. If set, the admin may specify the email of a user in a site they manage and the API will return details for a meeting that is hosted by that user. If meetingId is not specified, it can not support hostEmail.

  • site_url (str) – URL of the Webex site from which the API lists transcripts. If not specified, the API lists transcripts from user’s preferred site. All available Webex sites and the preferred site of the user can be retrieved by the Get Site List API.

  • from (str) – Starting date and time (inclusive) for transcripts to return, in any ISO 8601 compliant format. from cannot be after to.

  • to (str) – Ending date and time (exclusive) for List transcripts to return, in any ISO 8601 compliant format. to cannot be before from.

documentation: https://developer.webex.com/docs/api/v1/meeting-transcripts/list-meeting-transcripts

async list(meeting_id: str | None = None, host_email: str | None = None, site_url: str | None = None, from_: str | None = None, to_: str | None = None, **params) List[Transcript][source]

Lists available transcripts of an ended meeting instance. Use this operation to list transcripts of an ended meeting instance when they are ready. Please note that only meeting instances in state ended are supported for meetingId. Meeting series, scheduled meetings and in-progress meeting instances are not supported.

Parameters:
  • meeting_id (str) – Unique identifier for the meeting instance to which the transcript belongs. Please note that currently the meeting ID of a scheduled personal room meeting is not supported for this API. If meetingId is not specified, the operation returns an array of transcripts for all meetings of the current user.

  • host_email (str) – Email address for the meeting host. This parameter is only used if the user or application calling the API has the admin-level scopes. If set, the admin may specify the email of a user in a site they manage and the API will return details for a meeting that is hosted by that user. If meetingId is not specified, it can not support hostEmail.

  • site_url (str) – URL of the Webex site from which the API lists transcripts. If not specified, the API lists transcripts from user’s preferred site. All available Webex sites and the preferred site of the user can be retrieved by the Get Site List API.

  • from (str) – Starting date and time (inclusive) for transcripts to return, in any ISO 8601 compliant format. from cannot be after to.

  • to (str) – Ending date and time (exclusive) for List transcripts to return, in any ISO 8601 compliant format. to cannot be before from.

documentation: https://developer.webex.com/docs/api/v1/meeting-transcripts/list-meeting-transcripts

list_compliance_officer_gen(site_url: str, from_: str | None = None, to_: str | None = None, **params) AsyncGenerator[Transcript, None, None][source]

Lists available or deleted transcripts of an ended meeting instance for a specific site. The returned list is sorted in descending order by the date and time that the transcript was created.

Parameters:
  • site_url (str) – URL of the Webex site from which the API lists transcripts.

  • from (str) – Starting date and time (inclusive) for transcripts to return, in any ISO 8601 compliant format. from cannot be after to.

  • to (str) – Ending date and time (exclusive) for List transcripts to return, in any ISO 8601 compliant format. to cannot be before from.

documentation: https://developer.webex.com/docs/api/v1/meeting-transcripts/list-meeting-transcripts-for -compliance-officer

async list_compliance_officer(site_url: str, from_: str | None = None, to_: str | None = None, **params) List[Transcript][source]

Lists available or deleted transcripts of an ended meeting instance for a specific site. The returned list is sorted in descending order by the date and time that the transcript was created.

Parameters:
  • site_url (str) – URL of the Webex site from which the API lists transcripts.

  • from (str) – Starting date and time (inclusive) for transcripts to return, in any ISO 8601 compliant format. from cannot be after to.

  • to (str) – Ending date and time (exclusive) for List transcripts to return, in any ISO 8601 compliant format. to cannot be before from.

documentation: https://developer.webex.com/docs/api/v1/meeting-transcripts/list-meeting-transcripts-for -compliance-officer

async download(transcript_id: str, format: str | None = None, host_email: str | None = None)[source]

Download a meeting transcript from the meeting transcript specified by transcriptId.

Parameters:
  • transcript_id (str) – Unique identifier for the meeting transcript.

  • format (str) – Format for the downloaded meeting transcript. Possible values: vtt, txt

  • host_email (str) – Email address for the meeting host. This parameter is only used if the user or application calling the API has the admin-level scopes. If set, the admin may specify the email of a user in a site they manage and the API will return details for a meeting that is hosted by that user.

documentation: https://developer.webex.com/docs/api/v1/meeting-transcripts/download-a-meeting-transcript

list_snippets_gen(transcript_id: str, **params) AsyncGenerator[TranscriptSnippet, None, None][source]

Lists snippets of a meeting transcript specified by transcriptId. Use this operation to list snippets of a meeting transcript when they are ready.

Parameters:

transcript_id (str) – Unique identifier for the meeting transcript to which the snippets belong.

documentation: https://developer.webex.com/docs/api/v1/meeting-transcripts/list-snippets-of-a-meeting-transcript

async list_snippets(transcript_id: str, **params) List[TranscriptSnippet][source]

Lists snippets of a meeting transcript specified by transcriptId. Use this operation to list snippets of a meeting transcript when they are ready.

Parameters:

transcript_id (str) – Unique identifier for the meeting transcript to which the snippets belong.

documentation: https://developer.webex.com/docs/api/v1/meeting-transcripts/list-snippets-of-a-meeting-transcript

async snippet_detail(transcript_id: str, snippet_id: str) TranscriptSnippet[source]

Retrieves details for a transcript snippet specified by snippetId from the meeting transcript specified by transcriptId.

Parameters:
  • transcript_id (str) – Unique identifier for the meeting transcript to which the requested snippet belongs.

  • snippet_id (str) – Unique identifier for the snippet being requested.

documentation: https://developer.webex.com/docs/api/v1/meeting-transcripts/get-a-transcript-snippet

async update_snippet(transcript_id: str, snippet_id: str, text: str, reason: str | None = None) TranscriptSnippet[source]

Updates details for a transcript snippet specified by snippetId from the meeting transcript specified by transcriptId.

Parameters:
  • transcript_id (str) – Unique identifier for the meeting transcript to which the snippet to be updated belongs.

  • snippet_id (str) – Unique identifier for the snippet being updated.

  • text (str) – Text for the snippet.

  • reason (str) – Reason for snippet update; only required for Compliance Officers.

documentation: https://developer.webex.com/docs/api/v1/meeting-transcripts/update-a-transcript-snippet

async delete(transcript_id: str, reason: str | None = None, comment: str | None = None)[source]

Removes a transcript with a specified transcript ID. The deleted transcript cannot be recovered. If a Compliance Officer deletes another user’s transcript, the transcript will be inaccessible to regular users (host, attendees), but will be still available to the Compliance Officer.

Parameters:
  • transcript_id (str) – Unique identifier for the meeting transcript.

  • reason (str) – Reason for deleting a transcript. Only required when a Compliance Officer is operating on another user’s transcript.

  • comment (str) – Explanation for deleting a transcript. The comment can be a maximum of 255 characters long.

documentation: https://developer.webex.com/docs/api/v1/meeting-transcripts/delete-a-transcript

base = ''
class wxc_sdk.as_api.AsMeetingsApi(session: AsRestSession)[source]

Bases: AsApiChild

Meetings API

chats: AsMeetingChatsApi

meeting chats API

closed_captions: AsMeetingClosedCaptionsApi

closed captions API

invitees: AsMeetingInviteesApi

meeting invitees API

participants: AsMeetingParticipantsApi

meeting participants API

preferences: AsMeetingPreferencesApi

preferences API

qanda: AsMeetingQandAApi

Q and A API

qualities: AsMeetingQualitiesApi

qualities API

recordings: AsRecordingsApi
transcripts: AsMeetingTranscriptsApi

transcripts

async create(title: str | None = None, agenda: str | None = None, password: str | None = None, start: str | None = None, end: str | None = None, timezone: str | None = None, recurrence: str | None = None, enabled_auto_record_meeting: bool | None = None, allow_any_user_to_be_co_host: bool | None = None, enabled_join_before_host: bool | None = None, enable_connect_audio_before_host: bool | None = None, join_before_host_minutes: int | None = None, exclude_password: bool | None = None, public_meeting: bool | None = None, reminder_time: int | None = None, unlocked_meeting_join_security: UnlockedMeetingJoinSecurity | None = None, session_type_id: int | None = None, enabled_webcast_view: bool | None = None, panelist_password: str | None = None, enable_automatic_lock: bool | None = None, automatic_lock_minutes: int | None = None, allow_first_user_to_be_co_host: bool | None = None, allow_authenticated_devices: bool | None = None, send_email: bool | None = None, host_email: str | None = None, site_url: str | None = None, meeting_options: MeetingOptions | None = None, attendee_privileges: AttendeePrivileges | None = None, integration_tags: List[str] | None = None, enabled_breakout_sessions: bool | None = None, tracking_codes: TrackingCodeItem | None = None, audio_connection_options: AudioConnectionOptions | None = None, adhoc: bool | None = None, room_id: str | None = None, template_id: str | None = None, scheduled_type: ScheduledType | None = None, invitees: InviteeForCreateMeeting | None = None, registration: Registration | None = None, simultaneous_interpretation: SimultaneousInterpretation | None = None, breakout_sessions: BreakoutSession | None = None) Meeting[source]

Creates a new meeting. Regular users can schedule up to 100 meetings in 24 hours and admin users up to 3000.

Parameters:
  • title (str) – Meeting title. The title can be a maximum of 128 characters long.

  • agenda (str) – Meeting agenda. The agenda can be a maximum of 1300 characters long.

  • password (str) – Meeting password. Must conform to the site’s password complexity settings. Read password management for details.

  • start (str) – Date and time for the start of meeting in any ISO 8601 compliant format. start cannot be before current date and time or after end. Duration between start and end cannot be shorter than 10 minutes or longer than 24 hours. Refer to the Webex Meetings guide for more information about restrictions on updating date and time for a meeting. Please note that when a meeting is being updated, start of the meeting will be accurate to minutes, not seconds or milliseconds. Therefore, if start is within the same minute as the current time, start will be adjusted to the upcoming minute; otherwise, start will be adjusted with seconds and milliseconds stripped off. For instance, if the current time is 2022-03-01T10:32:16.657+08:00, start of 2022-03-01T10:32:28.076+08:00 or 2022-03-01T10:32:41+08:00 will be adjusted to 2022-03-01T10:33:00+08:00, and start of 2022-03-01T11:32:28.076+08:00 or 2022-03-01T11:32:41+08:00 will be adjusted to 2022-03-01T11:32:00+08:00.

  • end (str) – Date and time for the end of meeting in any ISO 8601 compliant format. end cannot be before current date and time or before start. Duration between start and end cannot be shorter than 10 minutes or longer than 24 hours. Refer to the Webex Meetings guide for more information about restrictions on updating date and time for a meeting. Please note that when a meeting is being updated, end of the meeting will be accurate to minutes, not seconds or milliseconds. Therefore, end will be adjusted with seconds and milliseconds stripped off. For instance, end of 2022-03-01T11:52:28.076+08:00 or 2022-03-01T11:52:41+08:00 will be adjusted to 2022-03-01T11:52:00+08:00.

  • timezone (str) – Time zone in which the meeting was originally scheduled (conforming with the IANA time zone database).

  • recurrence (str) – Meeting series recurrence rule (conforming with RFC 2445). Applies only to a recurring meeting series, not to a meeting series with only one scheduled meeting. Multiple days or dates for monthly or yearly recurrence rule are not supported, only the first day or date specified is taken. For example, “FREQ=MONTHLY;INTERVAL=1;COUNT=10;BYMONTHDAY=10,11,12” is not supported and it will be partially supported as “FREQ=MONTHLY;INTERVAL=1;COUNT=10;BYMONTHDAY=10”.

  • enabled_auto_record_meeting (bool) – Whether or not meeting is recorded automatically.

  • allow_any_user_to_be_co_host (bool) – Whether or not to allow any attendee with a host account on the target site to become a cohost when joining the meeting. The target site is specified by siteUrl parameter when creating the meeting; if not specified, it’s user’s preferred site.

  • enabled_join_before_host (bool) – Whether or not to allow any attendee to join the meeting before the host joins the meeting.

  • enable_connect_audio_before_host (bool) – Whether or not to allow any attendee to connect audio in the meeting before the host joins the meeting. This attribute is only applicable if the enabledJoinBeforeHost attribute is set to true.

  • join_before_host_minutes (int) – The number of minutes an attendee can join the meeting before the meeting start time and the host joins. This attribute is only applicable if the enabledJoinBeforeHost attribute is set to true. Valid options are 0, 5, 10 and 15. Default is 0 if not specified.

  • exclude_password (bool) – Whether or not to exclude the meeting password from the email invitation.

  • public_meeting (bool) – Whether or not to allow the meeting to be listed on the public calendar.

  • reminder_time (int) – The number of minutes before the meeting begins, that an email reminder is sent to the host.

  • unlocked_meeting_join_security (UnlockedMeetingJoinSecurity) – Specifies how the people who aren’t on the invite can join the unlocked meeting.

  • session_type_id (int) – Unique identifier for a meeting session type for the user. This attribute is required while scheduling webinar meeting. All available meeting session types enabled for the user can be retrieved by List Meeting Session Types API.

  • enabled_webcast_view (bool) – Whether or not webcast view is enabled.

  • panelist_password (str) – Password for panelists of a webinar meeting. Must conform to the site’s password complexity settings. Read password management for details. If not specified, a random password conforming to the site’s password rules will be generated automatically.

  • enable_automatic_lock (bool) – Whether or not to automatically lock the meeting after it starts.

  • automatic_lock_minutes (int) – The number of minutes after the meeting begins, for automatically locking it.

  • allow_first_user_to_be_co_host (bool) – Whether or not to allow the first attendee of the meeting with a host account on the target site to become a cohost. The target site is specified by siteUrl parameter when creating the meeting; if not specified, it’s user’s preferred site.

  • allow_authenticated_devices (bool) – Whether or not to allow authenticated video devices in the meeting’s organization to start or join the meeting without a prompt.

  • send_email (bool) – Whether or not to send emails to host and invitees. It is an optional field and default value is true.

  • host_email (str) – Email address for the meeting host. This attribute should only be set if the user or application calling the API has the admin-level scopes. When used, the admin may specify the email of a user in a site they manage to be the meeting host.

  • site_url (str) – URL of the Webex site which the meeting is updated on. If not specified, the meeting is created on user’s preferred site. All available Webex sites and preferred site of the user can be retrieved by Get Site List API.

  • meeting_options (MeetingOptions) – Meeting Options.

  • attendee_privileges (AttendeePrivileges) – Attendee Privileges.

  • integration_tags (List[str]) – External keys created by an integration application in its own domain, for example Zendesk ticket IDs, Jira IDs, Salesforce Opportunity IDs, etc. The integration application queries meetings by a key in its own domain. The maximum size of integrationTags is 3 and each item of integrationTags can be a maximum of 64 characters long. Please note that an empty or null integrationTags will delete all existing integration tags for the meeting implicitly. Developer can update integration tags for a meetingSeries but he cannot update it for a scheduledMeeting or a meeting instance.

  • enabled_breakout_sessions (bool) – Whether or not breakout sessions are enabled. If the value of enabledBreakoutSessions is false, users can not set breakout sessions. If the value of enabledBreakoutSessions is true, users can update breakout sessions using the Update Breakout Sessions API. Updating breakout sessions are not supported by this API.

  • tracking_codes (TrackingCodeItem) – Tracking codes information. All available tracking codes and their options for the specified site can be retrieved by List Meeting Tracking Codes API. If an optional tracking code is missing from the trackingCodes array and there’s a default option for this tracking code, the default option is assigned automatically. If the inputMode of a tracking code is select, its value must be one of the site-level options or the user-level value. Tracking code is not supported for a personal room meeting or an ad-hoc space meeting.

  • audio_connection_options (AudioConnectionOptions) – Audio connection options.

  • adhoc (bool) – Whether or not to create an ad-hoc meeting for the room specified by roomId. When true, roomId is required.

  • room_id (str) – Unique identifier for the Webex space which the meeting is to be associated with. It can be retrieved by List Rooms. roomId is required when adhoc is true. When roomId is specified, the parameter hostEmail will be ignored.

  • template_id (str) – Unique identifier for meeting template. Please note that start and end are optional when templateId is specified. The list of meeting templates that is available for the authenticated user can be retrieved from List Meeting Templates. This parameter is ignored for an ad-hoc meeting.

  • scheduled_type (ScheduledType) – When set as an attribute in a POST request body, specifies whether it’s a regular meeting, a webinar, or a meeting scheduled in the user’s personal room. If not specified, it’s a regular meeting by default. The default value for an ad-hoc meeting is meeting and the user’s input value will be ignored.

  • invitees (InviteeForCreateMeeting) – Invitees for meeting. The maximum size of invitees is 1000. If roomId is specified and invitees is missing, all the members in the space are invited implicitly. If both roomId and invitees are specified, only those in the invitees list are invited. coHost for each invitee is true by default if roomId is specified when creating a meeting, and anyone in the invitee list that is not qualified to be a cohost will be invited as a non-cohost invitee. The user’s input value will be ignored for an ad-hoc meeting and the the members of the room specified by roomId except “me” will be used by default.

  • registration (Registration) – Meeting registration. When this option is enabled, meeting invitees must register personal information to join the meeting. Meeting invitees will receive an email with a registration link for the registration. When the registration form has been submitted and approved, an email with a real meeting link will be received. By clicking that link the meeting invitee can join the meeting. Please note that meeting registration does not apply to a meeting when it’s a recurring meeting with a recurrence field or no password, or the Join Before Host option is enabled for the meeting. See Register for a Meeting in Cisco Webex Meetings for details. This parameter is ignored for an ad-hoc meeting.

  • simultaneous_interpretation (SimultaneousInterpretation) – Simultaneous interpretation information for a meeting.

  • breakout_sessions (BreakoutSession) – Breakout sessions are smaller groups that are split off from the main meeting or webinar. They allow a subset of participants to collaborate and share ideas over audio and video. Use breakout sessions for workshops, classrooms, or for when you need a moment to talk privately with a few participants outside of the main session. Please note that maximum number of breakout sessions in a meeting or webinar is 100. In webinars, if hosts preassign attendees to breakout sessions, the role of attendee will be changed to panelist. Breakout session is not supported for a meeting with simultaneous interpretation.

documentation: https://developer.webex.com/docs/api/v1/meetings/create-a-meeting

async get(meeting_id: str, current: bool | None = None, host_email: str | None = None) Meeting[source]

Retrieves details for a meeting with a specified meeting ID.

Parameters:
  • meeting_id (str) – Unique identifier for the meeting being requested.

  • current (bool) – Whether or not to retrieve only the current scheduled meeting of the meeting series, i.e. the meeting ready to join or start or the upcoming meeting of the meeting series. If it’s true, return details for the current scheduled meeting of the series, i.e. the scheduled meeting ready to join or start or the upcoming scheduled meeting of the meeting series. If it’s false or not specified, return details for the entire meeting series. This parameter only applies to meeting series.

  • host_email (str) – Email address for the meeting host. This parameter is only used if the user or application calling the API has the admin-level scopes. If set, the admin may specify the email of a user in a site they manage and the API will return details for a meeting that is hosted by that user.

documentation: https://developer.webex.com/docs/api/v1/meetings/get-a-meeting

list_gen(meeting_number: str | None = None, web_link: str | None = None, room_id: str | None = None, meeting_type: str | None = None, state: str | None = None, scheduled_type: str | None = None, current: bool | None = None, from_: str | None = None, to_: str | None = None, host_email: str | None = None, site_url: str | None = None, integration_tag: str | None = None, **params) AsyncGenerator[Meeting, None, None][source]

Retrieves details for meetings with a specified meeting number, web link, meeting type, etc. Please note that there are various products in the Webex Suite such as Meetings and Events. Currently, only meetings of the Meetings product are supported by this API, meetings of others in the suite are not supported. Ad-hoc meetings created by Create a Meeting with adhoc of true and a roomId will not be listed, but the ended and ongoing ad-hoc meeting instances will be listed.

Parameters:
  • meeting_number (str) – Meeting number for the meeting objects being requested. meetingNumber, webLink and roomId are mutually exclusive. If it’s an exceptional meeting from a meeting series, the exceptional meeting instead of the primary meeting series is returned.

  • web_link (str) – URL encoded link to information page for the meeting objects being requested. meetingNumber, webLink and roomId are mutually exclusive.

  • room_id (str) – Associated Webex space ID for the meeting objects being requested. meetingNumber, webLink and roomId are mutually exclusive.

  • meeting_type (str) – Meeting type for the meeting objects being requested. This parameter will be ignored if meetingNumber, webLink or roomId is specified. Possible values: meetingSeries, scheduledMeeting, meeting

  • state (str) – Meeting state for the meeting objects being requested. If not specified, return meetings of all states. This parameter will be ignored if meetingNumber, webLink or roomId is specified. Details of an ended meeting will only be available 15 minutes after the meeting has ended. inProgress meetings are not fully supported. The API will try to return details of an inProgress meeting 15 minutes after the meeting starts. However, it may take longer depending on the traffic. See the Webex Meetings guide for more information about the states of meetings. Possible values: active, scheduled, ready, lobby, inProgress, ended, missed, expired

  • scheduled_type (str) – Scheduled type for the meeting objects being requested. Possible values: meeting, webinar, personalRoomMeeting

  • current (bool) – Flag identifying to retrieve the current scheduled meeting of the meeting series or the entire meeting series. This parameter only applies to scenarios where meetingNumber is specified and the meeting is not an exceptional meeting from a meeting series. If it’s true, return the scheduled meeting of the meeting series which is ready to join or start or the upcoming scheduled meeting of the meeting series; if it’s false, return the entire meeting series.

  • from (str) – Start date and time (inclusive) in any ISO 8601 compliant format for the meeting objects being requested. from cannot be after to. This parameter will be ignored if meetingNumber, webLink or roomId is specified.

  • to (str) – End date and time (exclusive) in any ISO 8601 compliant format for the meeting objects being requested. to cannot be before from. This parameter will be ignored if meetingNumber, webLink or roomId is specified.

  • host_email (str) – Email address for the meeting host. This parameter is only used if the user or application calling the API has the admin-level scopes. If set, the admin may specify the email of a user in a site they manage and the API will return details for meetings that are hosted by that user.

  • site_url (str) – URL of the Webex site which the API lists meetings from. If not specified, the API lists meetings from user’s all sites. All available Webex sites of the user can be retrieved by Get Site List API.

  • integration_tag (str) – External key created by an integration application. This parameter is used by the integration application to query meetings by a key in its own domain such as a Zendesk ticket ID, a Jira ID, a Salesforce Opportunity ID, etc.

documentation: https://developer.webex.com/docs/api/v1/meetings/list-meetings

async list(meeting_number: str | None = None, web_link: str | None = None, room_id: str | None = None, meeting_type: str | None = None, state: str | None = None, scheduled_type: str | None = None, current: bool | None = None, from_: str | None = None, to_: str | None = None, host_email: str | None = None, site_url: str | None = None, integration_tag: str | None = None, **params) List[Meeting][source]

Retrieves details for meetings with a specified meeting number, web link, meeting type, etc. Please note that there are various products in the Webex Suite such as Meetings and Events. Currently, only meetings of the Meetings product are supported by this API, meetings of others in the suite are not supported. Ad-hoc meetings created by Create a Meeting with adhoc of true and a roomId will not be listed, but the ended and ongoing ad-hoc meeting instances will be listed.

Parameters:
  • meeting_number (str) – Meeting number for the meeting objects being requested. meetingNumber, webLink and roomId are mutually exclusive. If it’s an exceptional meeting from a meeting series, the exceptional meeting instead of the primary meeting series is returned.

  • web_link (str) – URL encoded link to information page for the meeting objects being requested. meetingNumber, webLink and roomId are mutually exclusive.

  • room_id (str) – Associated Webex space ID for the meeting objects being requested. meetingNumber, webLink and roomId are mutually exclusive.

  • meeting_type (str) – Meeting type for the meeting objects being requested. This parameter will be ignored if meetingNumber, webLink or roomId is specified. Possible values: meetingSeries, scheduledMeeting, meeting

  • state (str) – Meeting state for the meeting objects being requested. If not specified, return meetings of all states. This parameter will be ignored if meetingNumber, webLink or roomId is specified. Details of an ended meeting will only be available 15 minutes after the meeting has ended. inProgress meetings are not fully supported. The API will try to return details of an inProgress meeting 15 minutes after the meeting starts. However, it may take longer depending on the traffic. See the Webex Meetings guide for more information about the states of meetings. Possible values: active, scheduled, ready, lobby, inProgress, ended, missed, expired

  • scheduled_type (str) – Scheduled type for the meeting objects being requested. Possible values: meeting, webinar, personalRoomMeeting

  • current (bool) – Flag identifying to retrieve the current scheduled meeting of the meeting series or the entire meeting series. This parameter only applies to scenarios where meetingNumber is specified and the meeting is not an exceptional meeting from a meeting series. If it’s true, return the scheduled meeting of the meeting series which is ready to join or start or the upcoming scheduled meeting of the meeting series; if it’s false, return the entire meeting series.

  • from (str) – Start date and time (inclusive) in any ISO 8601 compliant format for the meeting objects being requested. from cannot be after to. This parameter will be ignored if meetingNumber, webLink or roomId is specified.

  • to (str) – End date and time (exclusive) in any ISO 8601 compliant format for the meeting objects being requested. to cannot be before from. This parameter will be ignored if meetingNumber, webLink or roomId is specified.

  • host_email (str) – Email address for the meeting host. This parameter is only used if the user or application calling the API has the admin-level scopes. If set, the admin may specify the email of a user in a site they manage and the API will return details for meetings that are hosted by that user.

  • site_url (str) – URL of the Webex site which the API lists meetings from. If not specified, the API lists meetings from user’s all sites. All available Webex sites of the user can be retrieved by Get Site List API.

  • integration_tag (str) – External key created by an integration application. This parameter is used by the integration application to query meetings by a key in its own domain such as a Zendesk ticket ID, a Jira ID, a Salesforce Opportunity ID, etc.

documentation: https://developer.webex.com/docs/api/v1/meetings/list-meetings

list_of_series_gen(meeting_series_id: str, from_: str | None = None, to_: str | None = None, meeting_type: str | None = None, state: str | None = None, is_modified: bool | None = None, host_email: str | None = None, **params) AsyncGenerator[ScheduledMeeting, None, None][source]

Lists scheduled meeting and meeting instances of a meeting series identified by meetingSeriesId. Scheduled meetings of an ad-hoc meeting created by Create a Meeting with adhoc of true and a roomId will not be listed, but the ended and ongoing meeting instances of it will be listed. Each scheduled meeting or meeting instance of a meeting series has its own start, end, etc. Thus, for example, when a daily meeting has been scheduled from 2019-04-01 to 2019-04-10, there are 10 scheduled meeting instances in this series, one instance for each day, and each one has its own attributes. When a scheduled meeting has been started and ended or is happening, there are even more ended or in-progress meeting instances. Use this operation to list scheduled meeting and meeting instances of a meeting series within a specific date range. Long result sets are split into pages. trackingCodes is not supported for ended meeting instances.

Parameters:
  • meeting_series_id (str) – Unique identifier for the meeting series. Please note that currently meeting ID of a scheduled personal room meeting is not supported for this API.

  • from (str) – Start date and time (inclusive) for the range for which meetings are to be returned in any ISO 8601 compliant format. from cannot be after to.

  • to (str) – End date and time (exclusive) for the range for which meetings are to be returned in any ISO 8601 compliant format. to cannot be before from.

  • meeting_type (str) – Meeting type for the meeting objects being requested. If not specified, return meetings of all types. Possible values: scheduledMeeting, meeting

  • state (str) – Meeting state for the meetings being requested. If not specified, return meetings of all states. Details of an ended meeting will only be available 15 minutes after the meeting has ended. inProgress meetings are not fully supported. The API will try to return details of an inProgress meeting 15 minutes after the meeting starts. However, it may take longer depending on the traffic. See the Webex Meetings guide for more information about the states of meetings. Possible values: scheduled, ready, lobby, inProgress, ended, missed

  • is_modified (bool) – Flag identifying whether or not only to retrieve scheduled meeting instances which have been modified. This parameter only applies to scheduled meetings. If it’s true, only return modified scheduled meetings; if it’s false, only return unmodified scheduled meetings; if not specified, all scheduled meetings will be returned.

  • host_email (str) – Email address for the meeting host. This parameter is only used if the user or application calling the API has the admin-level scopes. If set, the admin may specify the email of a user in a site they manage and the API will return meetings that are hosted by that user.

documentation: https://developer.webex.com/docs/api/v1/meetings/list-meetings-of-a-meeting-series

async list_of_series(meeting_series_id: str, from_: str | None = None, to_: str | None = None, meeting_type: str | None = None, state: str | None = None, is_modified: bool | None = None, host_email: str | None = None, **params) List[ScheduledMeeting][source]

Lists scheduled meeting and meeting instances of a meeting series identified by meetingSeriesId. Scheduled meetings of an ad-hoc meeting created by Create a Meeting with adhoc of true and a roomId will not be listed, but the ended and ongoing meeting instances of it will be listed. Each scheduled meeting or meeting instance of a meeting series has its own start, end, etc. Thus, for example, when a daily meeting has been scheduled from 2019-04-01 to 2019-04-10, there are 10 scheduled meeting instances in this series, one instance for each day, and each one has its own attributes. When a scheduled meeting has been started and ended or is happening, there are even more ended or in-progress meeting instances. Use this operation to list scheduled meeting and meeting instances of a meeting series within a specific date range. Long result sets are split into pages. trackingCodes is not supported for ended meeting instances.

Parameters:
  • meeting_series_id (str) – Unique identifier for the meeting series. Please note that currently meeting ID of a scheduled personal room meeting is not supported for this API.

  • from (str) – Start date and time (inclusive) for the range for which meetings are to be returned in any ISO 8601 compliant format. from cannot be after to.

  • to (str) – End date and time (exclusive) for the range for which meetings are to be returned in any ISO 8601 compliant format. to cannot be before from.

  • meeting_type (str) – Meeting type for the meeting objects being requested. If not specified, return meetings of all types. Possible values: scheduledMeeting, meeting

  • state (str) – Meeting state for the meetings being requested. If not specified, return meetings of all states. Details of an ended meeting will only be available 15 minutes after the meeting has ended. inProgress meetings are not fully supported. The API will try to return details of an inProgress meeting 15 minutes after the meeting starts. However, it may take longer depending on the traffic. See the Webex Meetings guide for more information about the states of meetings. Possible values: scheduled, ready, lobby, inProgress, ended, missed

  • is_modified (bool) – Flag identifying whether or not only to retrieve scheduled meeting instances which have been modified. This parameter only applies to scheduled meetings. If it’s true, only return modified scheduled meetings; if it’s false, only return unmodified scheduled meetings; if not specified, all scheduled meetings will be returned.

  • host_email (str) – Email address for the meeting host. This parameter is only used if the user or application calling the API has the admin-level scopes. If set, the admin may specify the email of a user in a site they manage and the API will return meetings that are hosted by that user.

documentation: https://developer.webex.com/docs/api/v1/meetings/list-meetings-of-a-meeting-series

async patch(meeting_id: str, title: str | None = None, agenda: str | None = None, password: str | None = None, start: str | None = None, end: str | None = None, timezone: str | None = None, recurrence: str | None = None, enabled_auto_record_meeting: bool | None = None, allow_any_user_to_be_co_host: bool | None = None, enabled_join_before_host: bool | None = None, enable_connect_audio_before_host: bool | None = None, join_before_host_minutes: int | None = None, exclude_password: bool | None = None, public_meeting: bool | None = None, reminder_time: int | None = None, unlocked_meeting_join_security: UnlockedMeetingJoinSecurity | None = None, session_type_id: int | None = None, enabled_webcast_view: bool | None = None, panelist_password: str | None = None, enable_automatic_lock: bool | None = None, automatic_lock_minutes: int | None = None, allow_first_user_to_be_co_host: bool | None = None, allow_authenticated_devices: bool | None = None, send_email: bool | None = None, host_email: str | None = None, site_url: str | None = None, meeting_options: MeetingOptions | None = None, attendee_privileges: AttendeePrivileges | None = None, integration_tags: List[str] | None = None, enabled_breakout_sessions: bool | None = None, tracking_codes: TrackingCodeItem | None = None, audio_connection_options: AudioConnectionOptions | None = None) PatchMeetingResponse[source]

Updates details for a meeting with a specified meeting ID. This operation applies to meeting series and scheduled meetings. It doesn’t apply to ended or in-progress meeting instances. Ad-hoc meetings created by Create a Meeting with adhoc of true and a roomId cannot be updated.

Parameters:
  • meeting_id (str) – Unique identifier for the meeting to be updated. This parameter applies to meeting series and scheduled meetings. It doesn’t apply to ended or in-progress meeting instances. Please note that currently meeting ID of a scheduled personal room meeting is not supported for this API.

  • title (str) – Meeting title. The title can be a maximum of 128 characters long.

  • agenda (str) – Meeting agenda. The agenda can be a maximum of 1300 characters long.

  • password (str) – Meeting password. Must conform to the site’s password complexity settings. Read password management for details.

  • start (str) – Date and time for the start of meeting in any ISO 8601 compliant format. start cannot be before current date and time or after end. Duration between start and end cannot be shorter than 10 minutes or longer than 24 hours. Refer to the Webex Meetings guide for more information about restrictions on updating date and time for a meeting. Please note that when a meeting is being updated, start of the meeting will be accurate to minutes, not seconds or milliseconds. Therefore, if start is within the same minute as the current time, start will be adjusted to the upcoming minute; otherwise, start will be adjusted with seconds and milliseconds stripped off. For instance, if the current time is 2022-03-01T10:32:16.657+08:00, start of 2022-03-01T10:32:28.076+08:00 or 2022-03-01T10:32:41+08:00 will be adjusted to 2022-03-01T10:33:00+08:00, and start of 2022-03-01T11:32:28.076+08:00 or 2022-03-01T11:32:41+08:00 will be adjusted to 2022-03-01T11:32:00+08:00.

  • end (str) – Date and time for the end of meeting in any ISO 8601 compliant format. end cannot be before current date and time or before start. Duration between start and end cannot be shorter than 10 minutes or longer than 24 hours. Refer to the Webex Meetings guide for more information about restrictions on updating date and time for a meeting. Please note that when a meeting is being updated, end of the meeting will be accurate to minutes, not seconds or milliseconds. Therefore, end will be adjusted with seconds and milliseconds stripped off. For instance, end of 2022-03-01T11:52:28.076+08:00 or 2022-03-01T11:52:41+08:00 will be adjusted to 2022-03-01T11:52:00+08:00.

  • timezone (str) – Time zone in which the meeting was originally scheduled (conforming with the IANA time zone database).

  • recurrence (str) – Meeting series recurrence rule (conforming with RFC 2445). Applies only to a recurring meeting series, not to a meeting series with only one scheduled meeting. Multiple days or dates for monthly or yearly recurrence rule are not supported, only the first day or date specified is taken. For example, “FREQ=MONTHLY;INTERVAL=1;COUNT=10;BYMONTHDAY=10,11,12” is not supported and it will be partially supported as “FREQ=MONTHLY;INTERVAL=1;COUNT=10;BYMONTHDAY=10”.

  • enabled_auto_record_meeting (bool) – Whether or not meeting is recorded automatically.

  • allow_any_user_to_be_co_host (bool) – Whether or not to allow any attendee with a host account on the target site to become a cohost when joining the meeting. The target site is specified by siteUrl parameter when creating the meeting; if not specified, it’s user’s preferred site.

  • enabled_join_before_host (bool) – Whether or not to allow any attendee to join the meeting before the host joins the meeting.

  • enable_connect_audio_before_host (bool) – Whether or not to allow any attendee to connect audio in the meeting before the host joins the meeting. This attribute is only applicable if the enabledJoinBeforeHost attribute is set to true.

  • join_before_host_minutes (int) – The number of minutes an attendee can join the meeting before the meeting start time and the host joins. This attribute is only applicable if the enabledJoinBeforeHost attribute is set to true. Valid options are 0, 5, 10 and 15. Default is 0 if not specified.

  • exclude_password (bool) – Whether or not to exclude the meeting password from the email invitation.

  • public_meeting (bool) – Whether or not to allow the meeting to be listed on the public calendar.

  • reminder_time (int) – The number of minutes before the meeting begins, that an email reminder is sent to the host.

  • unlocked_meeting_join_security (UnlockedMeetingJoinSecurity) – Specifies how the people who aren’t on the invite can join the unlocked meeting.

  • session_type_id (int) – Unique identifier for a meeting session type for the user. This attribute is required while scheduling webinar meeting. All available meeting session types enabled for the user can be retrieved by List Meeting Session Types API.

  • enabled_webcast_view (bool) – Whether or not webcast view is enabled.

  • panelist_password (str) – Password for panelists of a webinar meeting. Must conform to the site’s password complexity settings. Read password management for details. If not specified, a random password conforming to the site’s password rules will be generated automatically.

  • enable_automatic_lock (bool) – Whether or not to automatically lock the meeting after it starts.

  • automatic_lock_minutes (int) – The number of minutes after the meeting begins, for automatically locking it.

  • allow_first_user_to_be_co_host (bool) – Whether or not to allow the first attendee of the meeting with a host account on the target site to become a cohost. The target site is specified by siteUrl parameter when creating the meeting; if not specified, it’s user’s preferred site.

  • allow_authenticated_devices (bool) – Whether or not to allow authenticated video devices in the meeting’s organization to start or join the meeting without a prompt.

  • send_email (bool) – Whether or not to send emails to host and invitees. It is an optional field and default value is true.

  • host_email (str) – Email address for the meeting host. This attribute should only be set if the user or application calling the API has the admin-level scopes. When used, the admin may specify the email of a user in a site they manage to be the meeting host.

  • site_url (str) – URL of the Webex site which the meeting is updated on. If not specified, the meeting is created on user’s preferred site. All available Webex sites and preferred site of the user can be retrieved by Get Site List API.

  • meeting_options (MeetingOptions) – Meeting Options.

  • attendee_privileges (AttendeePrivileges) – Attendee Privileges.

  • integration_tags (List[str]) – External keys created by an integration application in its own domain, for example Zendesk ticket IDs, Jira IDs, Salesforce Opportunity IDs, etc. The integration application queries meetings by a key in its own domain. The maximum size of integrationTags is 3 and each item of integrationTags can be a maximum of 64 characters long. Please note that an empty or null integrationTags will delete all existing integration tags for the meeting implicitly. Developer can update integration tags for a meetingSeries but he cannot update it for a scheduledMeeting or a meeting instance.

  • enabled_breakout_sessions (bool) – Whether or not breakout sessions are enabled. If the value of enabledBreakoutSessions is false, users can not set breakout sessions. If the value of enabledBreakoutSessions is true, users can update breakout sessions using the Update Breakout Sessions API. Updating breakout sessions are not supported by this API.

  • tracking_codes (TrackingCodeItem) – Tracking codes information. All available tracking codes and their options for the specified site can be retrieved by List Meeting Tracking Codes API. If an optional tracking code is missing from the trackingCodes array and there’s a default option for this tracking code, the default option is assigned automatically. If the inputMode of a tracking code is select, its value must be one of the site-level options or the user-level value. Tracking code is not supported for a personal room meeting or an ad-hoc space meeting.

  • audio_connection_options (AudioConnectionOptions) – Audio connection options.

documentation: https://developer.webex.com/docs/api/v1/meetings/patch-a-meeting

async update(meeting_id: str, title: str | None = None, agenda: str | None = None, password: str | None = None, start: str | None = None, end: str | None = None, timezone: str | None = None, recurrence: str | None = None, enabled_auto_record_meeting: bool | None = None, allow_any_user_to_be_co_host: bool | None = None, enabled_join_before_host: bool | None = None, enable_connect_audio_before_host: bool | None = None, join_before_host_minutes: int | None = None, exclude_password: bool | None = None, public_meeting: bool | None = None, reminder_time: int | None = None, unlocked_meeting_join_security: UnlockedMeetingJoinSecurity | None = None, session_type_id: int | None = None, enabled_webcast_view: bool | None = None, panelist_password: str | None = None, enable_automatic_lock: bool | None = None, automatic_lock_minutes: int | None = None, allow_first_user_to_be_co_host: bool | None = None, allow_authenticated_devices: bool | None = None, send_email: bool | None = None, host_email: str | None = None, site_url: str | None = None, meeting_options: MeetingOptions | None = None, attendee_privileges: AttendeePrivileges | None = None, integration_tags: List[str] | None = None, enabled_breakout_sessions: bool | None = None, tracking_codes: TrackingCodeItem | None = None, audio_connection_options: AudioConnectionOptions | None = None) PatchMeetingResponse[source]

Updates details for a meeting with a specified meeting ID. This operation applies to meeting series and scheduled meetings. It doesn’t apply to ended or in-progress meeting instances. Ad-hoc meetings created by Create a Meeting with adhoc of true and a roomId cannot be updated.

Parameters:
  • meeting_id (str) – Unique identifier for the meeting to be updated. This parameter applies to meeting series and scheduled meetings. It doesn’t apply to ended or in-progress meeting instances. Please note that currently meeting ID of a scheduled personal room meeting is not supported for this API.

  • title (str) – Meeting title. The title can be a maximum of 128 characters long.

  • agenda (str) – Meeting agenda. The agenda can be a maximum of 1300 characters long.

  • password (str) – Meeting password. Must conform to the site’s password complexity settings. Read password management for details.

  • start (str) – Date and time for the start of meeting in any ISO 8601 compliant format. start cannot be before current date and time or after end. Duration between start and end cannot be shorter than 10 minutes or longer than 24 hours. Refer to the Webex Meetings guide for more information about restrictions on updating date and time for a meeting. Please note that when a meeting is being updated, start of the meeting will be accurate to minutes, not seconds or milliseconds. Therefore, if start is within the same minute as the current time, start will be adjusted to the upcoming minute; otherwise, start will be adjusted with seconds and milliseconds stripped off. For instance, if the current time is 2022-03-01T10:32:16.657+08:00, start of 2022-03-01T10:32:28.076+08:00 or 2022-03-01T10:32:41+08:00 will be adjusted to 2022-03-01T10:33:00+08:00, and start of 2022-03-01T11:32:28.076+08:00 or 2022-03-01T11:32:41+08:00 will be adjusted to 2022-03-01T11:32:00+08:00.

  • end (str) – Date and time for the end of meeting in any ISO 8601 compliant format. end cannot be before current date and time or before start. Duration between start and end cannot be shorter than 10 minutes or longer than 24 hours. Refer to the Webex Meetings guide for more information about restrictions on updating date and time for a meeting. Please note that when a meeting is being updated, end of the meeting will be accurate to minutes, not seconds or milliseconds. Therefore, end will be adjusted with seconds and milliseconds stripped off. For instance, end of 2022-03-01T11:52:28.076+08:00 or 2022-03-01T11:52:41+08:00 will be adjusted to 2022-03-01T11:52:00+08:00.

  • timezone (str) – Time zone in which the meeting was originally scheduled (conforming with the IANA time zone database).

  • recurrence (str) – Meeting series recurrence rule (conforming with RFC 2445). Applies only to a recurring meeting series, not to a meeting series with only one scheduled meeting. Multiple days or dates for monthly or yearly recurrence rule are not supported, only the first day or date specified is taken. For example, “FREQ=MONTHLY;INTERVAL=1;COUNT=10;BYMONTHDAY=10,11,12” is not supported and it will be partially supported as “FREQ=MONTHLY;INTERVAL=1;COUNT=10;BYMONTHDAY=10”.

  • enabled_auto_record_meeting (bool) – Whether or not meeting is recorded automatically.

  • allow_any_user_to_be_co_host (bool) – Whether or not to allow any attendee with a host account on the target site to become a cohost when joining the meeting. The target site is specified by siteUrl parameter when creating the meeting; if not specified, it’s user’s preferred site.

  • enabled_join_before_host (bool) – Whether or not to allow any attendee to join the meeting before the host joins the meeting.

  • enable_connect_audio_before_host (bool) – Whether or not to allow any attendee to connect audio in the meeting before the host joins the meeting. This attribute is only applicable if the enabledJoinBeforeHost attribute is set to true.

  • join_before_host_minutes (int) – The number of minutes an attendee can join the meeting before the meeting start time and the host joins. This attribute is only applicable if the enabledJoinBeforeHost attribute is set to true. Valid options are 0, 5, 10 and 15. Default is 0 if not specified.

  • exclude_password (bool) – Whether or not to exclude the meeting password from the email invitation.

  • public_meeting (bool) – Whether or not to allow the meeting to be listed on the public calendar.

  • reminder_time (int) – The number of minutes before the meeting begins, that an email reminder is sent to the host.

  • unlocked_meeting_join_security (UnlockedMeetingJoinSecurity) – Specifies how the people who aren’t on the invite can join the unlocked meeting.

  • session_type_id (int) – Unique identifier for a meeting session type for the user. This attribute is required while scheduling webinar meeting. All available meeting session types enabled for the user can be retrieved by List Meeting Session Types API.

  • enabled_webcast_view (bool) – Whether or not webcast view is enabled.

  • panelist_password (str) – Password for panelists of a webinar meeting. Must conform to the site’s password complexity settings. Read password management for details. If not specified, a random password conforming to the site’s password rules will be generated automatically.

  • enable_automatic_lock (bool) – Whether or not to automatically lock the meeting after it starts.

  • automatic_lock_minutes (int) – The number of minutes after the meeting begins, for automatically locking it.

  • allow_first_user_to_be_co_host (bool) – Whether or not to allow the first attendee of the meeting with a host account on the target site to become a cohost. The target site is specified by siteUrl parameter when creating the meeting; if not specified, it’s user’s preferred site.

  • allow_authenticated_devices (bool) – Whether or not to allow authenticated video devices in the meeting’s organization to start or join the meeting without a prompt.

  • send_email (bool) – Whether or not to send emails to host and invitees. It is an optional field and default value is true.

  • host_email (str) – Email address for the meeting host. This attribute should only be set if the user or application calling the API has the admin-level scopes. When used, the admin may specify the email of a user in a site they manage to be the meeting host.

  • site_url (str) – URL of the Webex site which the meeting is updated on. If not specified, the meeting is created on user’s preferred site. All available Webex sites and preferred site of the user can be retrieved by Get Site List API.

  • meeting_options (MeetingOptions) – Meeting Options.

  • attendee_privileges (AttendeePrivileges) – Attendee Privileges.

  • integration_tags (List[str]) – External keys created by an integration application in its own domain, for example Zendesk ticket IDs, Jira IDs, Salesforce Opportunity IDs, etc. The integration application queries meetings by a key in its own domain. The maximum size of integrationTags is 3 and each item of integrationTags can be a maximum of 64 characters long. Please note that an empty or null integrationTags will delete all existing integration tags for the meeting implicitly. Developer can update integration tags for a meetingSeries but he cannot update it for a scheduledMeeting or a meeting instance.

  • enabled_breakout_sessions (bool) – Whether or not breakout sessions are enabled. If the value of enabledBreakoutSessions is false, users can not set breakout sessions. If the value of enabledBreakoutSessions is true, users can update breakout sessions using the Update Breakout Sessions API. Updating breakout sessions are not supported by this API.

  • tracking_codes (TrackingCodeItem) – Tracking codes information. All available tracking codes and their options for the specified site can be retrieved by List Meeting Tracking Codes API. If an optional tracking code is missing from the trackingCodes array and there’s a default option for this tracking code, the default option is assigned automatically. If the inputMode of a tracking code is select, its value must be one of the site-level options or the user-level value. Tracking code is not supported for a personal room meeting or an ad-hoc space meeting.

  • audio_connection_options (AudioConnectionOptions) – Audio connection options.

documentation: https://developer.webex.com/docs/api/v1/meetings/update-a-meeting

async delete(meeting_id: str, host_email: str | None = None, send_email: bool | None = None)[source]

Deletes a meeting with a specified meeting ID. The deleted meeting cannot be recovered. This operation applies to meeting series and scheduled meetings. It doesn’t apply to ended or in-progress meeting instances. Ad-hoc meetings created by Create a Meeting with adhoc of true and a roomId cannot be deleted.

Parameters:
  • meeting_id (str) – Unique identifier for the meeting to be deleted. This parameter applies to meeting series and scheduled meetings. It doesn’t apply to ended or in-progress meeting instances.

  • host_email (str) – Email address for the meeting host. This parameter is only used if the user or application calling the API has the admin-level scopes. If set, the admin may specify the email of a user in a site they manage and the API will delete a meeting that is hosted by that user.

  • send_email (bool) – Whether or not to send emails to host and invitees. It is an optional field and default value is true.

documentation: https://developer.webex.com/docs/api/v1/meetings/delete-a-meeting

async join(meeting_id: str | None = None, meeting_number: str | None = None, web_link: str | None = None, join_directly: bool | None = None, email: str | None = None, display_name: str | None = None, password: str | None = None, expiration_minutes: int | None = None) JoinMeetingResponse[source]

Retrieves a meeting join link for a meeting with a specified meetingId, meetingNumber, or webLink that allows users to join the meeting directly without logging in and entering a password.

Parameters:
  • meeting_id (str) – Unique identifier for the meeting. This parameter applies to meeting series and scheduled meetings. It doesn’t apply to ended or in-progress meeting instances. Please note that currently meeting ID of a scheduled personal room meeting is also supported for this API.

  • meeting_number (str) – Meeting number. Applies to meeting series, scheduled meeting, and meeting instances, but not to meeting instances which have ended.

  • web_link (str) – Link to a meeting information page where the meeting client is launched if the meeting is ready to start or join.

  • join_directly (bool) – Whether or not to redirect to joinLink. It is an optional field and default value is true.

  • email (str) – Email address of meeting participant. If the user is a guest issuer, email is required.

  • display_name (str) – Display name of meeting participant. The maximum length of displayName is 128 characters. If the user is a guest issuer, displayName is required.

  • password (str) – It’s required when the meeting is protected by a password and the current user is not privileged to view it if they are not a host, cohost or invitee of the meeting.

  • expiration_minutes (int) – Expiration duration of joinLink in minutes. Must be between 1 and 60.

documentation: https://developer.webex.com/docs/api/v1/meetings/join-a-meeting

async update_simultaneous_interpretation(meeting_id: str, enabled: bool, interpreters: InterpreterForSimultaneousInterpretation | None = None) SimultaneousInterpretation[source]

Updates simultaneous interpretation options of a meeting with a specified meeting ID. This operation applies to meeting series and scheduled meetings. It doesn’t apply to ended or in-progress meeting instances.

Parameters:
  • meeting_id (str) – Unique identifier for the meeting. Does not support meeting IDs for a scheduled personal room meeting.

  • enabled (bool) – Whether or not simultaneous interpretation is enabled.

  • interpreters (InterpreterForSimultaneousInterpretation) – Interpreters for meeting.

documentation: https://developer.webex.com/docs/api/v1/meetings/update-meeting-simultaneous-interpretation

async survey(meeting_id: str) GetMeetingSurveyResponse[source]

Retrieves details for a meeting survey identified by meetingId.

Parameters:

meeting_id (str) – Unique identifier for the meeting. Please note that only the meeting ID of a scheduled webinar is supported for this API.

documentation: https://developer.webex.com/docs/api/v1/meetings/get-a-meeting-survey

list_survey_results_gen(meeting_id: str, meeting_start_time_from: str | None = None, meeting_start_time_to: str | None = None, **params) AsyncGenerator[SurveyResult, None, None][source]

Retrieves results for a meeting survey identified by meetingId.

Parameters:
  • meeting_id (str) – Unique identifier for the meeting. Please note that only the meeting ID of a scheduled webinar is supported for this API.

  • meeting_start_time_from (str) – Start date and time (inclusive) in any ISO 8601 compliant format for the meeting objects being requested. meetingStartTimeFrom cannot be after meetingStartTimeTo. This parameter will be ignored if meetingId is the unique identifier for the specific meeting instance. When meetingId is not the unique identifier for the specific meeting instance, the meetingStartTimeFrom, if not specified, equals meetingStartTimeTo minus 1 month; if meetingStartTimeTo is also not specified, the default value for meetingStartTimeFrom is 1 month before the current date and time.

  • meeting_start_time_to (str) – End date and time (exclusive) in any ISO 8601 compliant format for the meeting objects being requested. meetingStartTimeTo cannot be prior to meetingStartTimeFrom. This parameter will be ignored if meetingId is the unique identifier for the specific meeting instance. When meetingId is not the unique identifier for the specific meeting instance, if meetingStartTimeFrom is also not specified, the default value for meetingStartTimeTo is the current date and time;For example,if meetingStartTimeFrom is a month ago, the default value for meetingStartTimeTo is 1 month after meetingStartTimeFrom.Otherwise it is the current date and time.

documentation: https://developer.webex.com/docs/api/v1/meetings/list-meeting-survey-results

async list_survey_results(meeting_id: str, meeting_start_time_from: str | None = None, meeting_start_time_to: str | None = None, **params) List[SurveyResult][source]

Retrieves results for a meeting survey identified by meetingId.

Parameters:
  • meeting_id (str) – Unique identifier for the meeting. Please note that only the meeting ID of a scheduled webinar is supported for this API.

  • meeting_start_time_from (str) – Start date and time (inclusive) in any ISO 8601 compliant format for the meeting objects being requested. meetingStartTimeFrom cannot be after meetingStartTimeTo. This parameter will be ignored if meetingId is the unique identifier for the specific meeting instance. When meetingId is not the unique identifier for the specific meeting instance, the meetingStartTimeFrom, if not specified, equals meetingStartTimeTo minus 1 month; if meetingStartTimeTo is also not specified, the default value for meetingStartTimeFrom is 1 month before the current date and time.

  • meeting_start_time_to (str) – End date and time (exclusive) in any ISO 8601 compliant format for the meeting objects being requested. meetingStartTimeTo cannot be prior to meetingStartTimeFrom. This parameter will be ignored if meetingId is the unique identifier for the specific meeting instance. When meetingId is not the unique identifier for the specific meeting instance, if meetingStartTimeFrom is also not specified, the default value for meetingStartTimeTo is the current date and time;For example,if meetingStartTimeFrom is a month ago, the default value for meetingStartTimeTo is 1 month after meetingStartTimeFrom.Otherwise it is the current date and time.

documentation: https://developer.webex.com/docs/api/v1/meetings/list-meeting-survey-results

list_tracking_codes_gen(service: str, site_url: str | None = None, host_email: str | None = None) AsyncGenerator[TrackingCode, None, None][source]

Lists tracking codes on a site by a meeting host. The result indicates which tracking codes and what options can be used to create or update a meeting on the specified site.

Parameters:
  • service (str) – Service for schedule or sign-up pages.

  • site_url (str) – URL of the Webex site which the API retrieves the tracking code from. If not specified, the API retrieves the tracking code from the user’s preferred site. All available Webex sites and preferred sites of a user can be retrieved by Get Site List API.

  • host_email (str) – Email address for the meeting host. This parameter is only used if a user or application calling the API has the admin-level scopes. The admin may specify the email of a user on a site they manage and the API will return meeting participants of the meetings that are hosted by that user.

documentation: https://developer.webex.com/docs/api/v1/meetings/list-meeting-tracking-codes

async list_tracking_codes(service: str, site_url: str | None = None, host_email: str | None = None) List[TrackingCode][source]

Lists tracking codes on a site by a meeting host. The result indicates which tracking codes and what options can be used to create or update a meeting on the specified site.

Parameters:
  • service (str) – Service for schedule or sign-up pages.

  • site_url (str) – URL of the Webex site which the API retrieves the tracking code from. If not specified, the API retrieves the tracking code from the user’s preferred site. All available Webex sites and preferred sites of a user can be retrieved by Get Site List API.

  • host_email (str) – Email address for the meeting host. This parameter is only used if a user or application calling the API has the admin-level scopes. The admin may specify the email of a user on a site they manage and the API will return meeting participants of the meetings that are hosted by that user.

documentation: https://developer.webex.com/docs/api/v1/meetings/list-meeting-tracking-codes

base = 'meetings'
class wxc_sdk.as_api.AsMembershipApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Memberships represent a person’s relationship to a room. Use this API to list members of any room that you’re in or create memberships to invite someone to a room. Compliance Officers can now also list memberships for personEmails where the CO is not part of the room. Memberships can also be updated to make someone a moderator, or deleted, to remove someone from the room. Just like in the Webex client, you must be a member of the room in order to list its memberships or invite people.

list_gen(room_id: str | None = None, person_id: str | None = None, person_email: str | None = None, **params) AsyncGenerator[Membership, None, None][source]

Lists all room memberships. By default, lists memberships for rooms to which the authenticated user belongs. Use query parameters to filter the response. Use roomId to list memberships for a room, by ID. NOTE: For moderated team spaces, the list of memberships will include only the space moderators if the user is a team member but not a direct participant of the space. Use either personId or personEmail to filter the results. The roomId parameter is required when using these parameters. Long result sets will be split into pages.

Parameters:
  • room_id (str) – List memberships associated with a room, by ID.

  • person_id (str) – List memberships associated with a person, by ID. The roomId parameter is required when using this parameter.

  • person_email (str) – List memberships associated with a person, by email address. The roomId parameter is required when using this parameter.

async list(room_id: str | None = None, person_id: str | None = None, person_email: str | None = None, **params) List[Membership][source]

Lists all room memberships. By default, lists memberships for rooms to which the authenticated user belongs. Use query parameters to filter the response. Use roomId to list memberships for a room, by ID. NOTE: For moderated team spaces, the list of memberships will include only the space moderators if the user is a team member but not a direct participant of the space. Use either personId or personEmail to filter the results. The roomId parameter is required when using these parameters. Long result sets will be split into pages.

Parameters:
  • room_id (str) – List memberships associated with a room, by ID.

  • person_id (str) – List memberships associated with a person, by ID. The roomId parameter is required when using this parameter.

  • person_email (str) – List memberships associated with a person, by email address. The roomId parameter is required when using this parameter.

async create(room_id: str, person_id: str | None = None, person_email: str | None = None, is_moderator: bool | None = None) Membership[source]

Add someone to a room by Person ID or email address, optionally making them a moderator.

Parameters:
  • room_id (str) – The room ID.

  • person_id (str) – The person ID.

  • person_email (str) – The email address of the person.

  • is_moderator (bool) – Whether or not the participant is a room moderator.

async details(membership_id: str) Membership[source]

Get details for a membership by ID. Specify the membership ID in the membershipId URI parameter.

Parameters:

membership_id (str) – The unique identifier for the membership.

async update(update: Membership) Membership[source]

Updates properties for a membership by ID

Parameters:

update (Membership) –

new settings; ID has to be set in update.

These can be updated:

is_moderator: bool: Whether or not the participant is a room moderator.

is_room_hidden: bool: When set to true, hides direct spaces in the teams client. Any new message will make the room visible again.

async delete(membership_id: str)[source]

Deletes a membership by ID. Specify the membership ID in the membershipId URI parameter. The membership for the last moderator of a Team’s General space may not be deleted; promote another user to team moderator first.

Parameters:

membership_id (str) – The unique identifier for the membership.

base = 'memberships'
class wxc_sdk.as_api.AsMessagesApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

list_gen(room_id: str, parent_id: str | None = None, mentioned_people: List[str] | None = None, before: datetime | None = None, before_message: str | None = None, **params) AsyncGenerator[Message, None, None][source]

Lists all messages in a room. Each message will include content attachments if present. The list sorts the messages in descending order by creation date. Long result sets will be split into pages.

Parameters:
  • room_id (str) – List messages in a room, by ID.

  • parent_id (str) – List messages with a parent, by ID.

  • mentioned_people (List[str]) – List messages with these people mentioned, by ID. Use me as a shorthand for the current API user. Only me or the person ID of the current user may be specified. Bots must include this parameter to list messages in group rooms (spaces).

  • before (str) – List messages sent before a date and time.

  • before_message (str) – List messages sent before a message, by ID.

async list(room_id: str, parent_id: str | None = None, mentioned_people: List[str] | None = None, before: datetime | None = None, before_message: str | None = None, **params) List[Message][source]

Lists all messages in a room. Each message will include content attachments if present. The list sorts the messages in descending order by creation date. Long result sets will be split into pages.

Parameters:
  • room_id (str) – List messages in a room, by ID.

  • parent_id (str) – List messages with a parent, by ID.

  • mentioned_people (List[str]) – List messages with these people mentioned, by ID. Use me as a shorthand for the current API user. Only me or the person ID of the current user may be specified. Bots must include this parameter to list messages in group rooms (spaces).

  • before (str) – List messages sent before a date and time.

  • before_message (str) – List messages sent before a message, by ID.

list_direct_gen(parent_id: str | None = None, person_id: str | None = None, person_email: str | None = None, **params) AsyncGenerator[Message, None, None][source]

List all messages in a 1:1 (direct) room. Use the personId or personEmail query parameter to specify the room. Each message will include content attachments if present. The list sorts the messages in descending order by creation date.

Parameters:
  • parent_id (str) – List messages with a parent, by ID.

  • person_id (str) – List messages in a 1:1 room, by person ID.

  • person_email (str) – List messages in a 1:1 room, by person email.

async list_direct(parent_id: str | None = None, person_id: str | None = None, person_email: str | None = None, **params) List[Message][source]

List all messages in a 1:1 (direct) room. Use the personId or personEmail query parameter to specify the room. Each message will include content attachments if present. The list sorts the messages in descending order by creation date.

Parameters:
  • parent_id (str) – List messages with a parent, by ID.

  • person_id (str) – List messages in a 1:1 room, by person ID.

  • person_email (str) – List messages in a 1:1 room, by person email.

async create(room_id: str | None = None, parent_id: str | None = None, to_person_id: str | None = None, to_person_email: str | None = None, text: str | None = None, markdown: str | None = None, html: str | None = None, files: List[str] | None = None, attachments: List[dict | MessageAttachment] | None = None) Message[source]

Post a plain text, rich text or html message, and optionally, a file attachment, to a room.

The files parameter is an array, which accepts multiple values to allow for future expansion, but currently only one file may be included with the message. File previews are only rendered for attachments of 1MB or less.

html formatting is limited to the following markup h1,h2,h3,ul,ol,u,i,b and links.

Parameters:
  • room_id (str) – The room ID of the message.

  • parent_id (str) – The parent message to reply to.

  • to_person_id (str) – The person ID of the recipient when sending a private 1:1 message.

  • to_person_email (str) – The email address of the recipient when sending a private 1:1 message.

  • text (str) – The message, in plain text. If markdown is specified this parameter may be optionally used to provide alternate text for UI clients that do not support rich text. The maximum message length is 7439 bytes.

  • markdown (str) – The message, in Markdown format. The maximum message length is 7439 bytes.

  • html (str) – The message, in HTML format. The maximum message length is 7439 bytes.

  • files (List[str]) – The public URL to a binary file or a path to a local file to be posted into the room. Only one file is allowed per message. Uploaded files are automatically converted into a format that all Webex clients can render. For the supported media types and the behavior of uploads, see the Message Attachments Guide.

  • attachments (List[Attachment]) – Content attachments to attach to the message. Only one card per message is supported. See the Cards Guide for more information.

Return type:

Message

async edit(message: Message) Message[source]

Update a message you have posted not more than 10 times. Specify the messageId of the message you want to edit. Edits of messages containing files or attachments are not currently supported. If a user attempts to edit a message containing files or attachments a 400 Bad Request will be returned by the API with a message stating that the feature is currently unsupported. There is also a maximum number of times a user can edit a message. The maximum currently supported is 10 edits per message. If a user attempts to edit a message greater that the maximum times allowed the API will return 400 Bad Request with a message stating the edit limit has been reached. While only the roomId and text or markdown attributes are required in the request body, a common pattern for editing message is to first call GET /messages/{id} for the message you wish to edit and to then update the text or markdown attribute accordingly, passing the updated message object in the request body of the PUT /messages/{id} request.

Parameters:

message

the updated message, id has to be set in the message attributes supported for update:

  • room_id: str: The room ID of the message.

  • text: str: The message, in plain text. If markdown is specified this parameter may be optionally used to provide alternate text for UI clients that do not support rich text. The maximum message length is 7439 bytes.

  • markdown: str: The message, in Markdown format. If this attribute is set ensure that the request does NOT contain an html attribute.

  • html: str: The message, in HTML format. The maximum message length is 7439 bytes.

async details(message_id: str) Message[source]

Show details for a message, by message ID. Specify the message ID in the messageId parameter in the URI.

Parameters:

message_id (str) – The unique identifier for the message.

async delete(message_id: str)[source]

Delete a message, by message ID. Specify the message ID in the messageId parameter in the URI.

Parameters:

message_id (str) – The unique identifier for the message.

base = 'messages'
class wxc_sdk.as_api.AsMonitoringApi(*, session: AsRestSession, selector: ApiSelector = ApiSelector.person)[source]

Bases: AsPersonSettingsApiChild

API for person’s call monitoring settings

feature = 'monitoring'
async read(person_id: str, org_id: str | None = None) Monitoring[source]

Retrieve a Person’s Monitoring Settings

Retrieves the monitoring settings of the person, which shows specified people, places or, call park extensions under monitoring. Monitors the line status which indicates if a person or place is on a call and if a call has been parked on that extension.

This API requires a full, user, or read-only administrator auth token with a scope of spark-admin:people_read.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • org_id (str) – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

Returns:

monitoring settings

Return type:

Monitoring

async configure(person_id: str, settings: Monitoring, org_id: str | None = None)[source]

Configure Call Waiting Settings for a Person

Configure a Person’s Call Waiting Settings

With this feature, a person can place an active call on hold and answer an incoming call. When enabled, while you are on an active call, a tone alerts you of an incoming call and you can choose to answer or ignore the call.

This API requires a full or user administrator auth token with the spark-admin:people_write scope.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • settings (Monitoring) – settings for update

  • org_id (str) – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

base = ''
class wxc_sdk.as_api.AsNumbersApi(*, session: AsRestSession, selector: ApiSelector = ApiSelector.person)[source]

Bases: AsPersonSettingsApiChild

API for person’s numbers

feature = 'numbers'
async read(person_id: str, prefer_e164_format: bool | None = None, org_id: str | None = None) PersonNumbers[source]

Get a person’s phone numbers including alternate numbers.

A person can have one or more phone numbers and/or extensions via which they can be called.

This API requires a full or user administrator auth token with the spark-admin:people_read scope.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • prefer_e164_format (bool) – Return phone numbers in E.164 format.

  • org_id (str) – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

Returns:

Alternate numbers of the user

Return type:

PersonNumbers

async update(person_id: str, update: UpdatePersonNumbers, org_id: str | None = None)[source]

Assign or unassign alternate phone numbers to a person.

Each location has a set of phone numbers that can be assigned to people, workspaces, or features. Phone numbers must follow E.164 format for all countries, except for the United States, which can also follow the National format. Active phone numbers are in service.

Assigning or Unassigning an alternate phone number to a person requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • person_id (str) – Unique identifier of the person.

  • update (UpdatePersonNumbers) – Update to apply

  • org_id (str) – organization to work on

base = ''
class wxc_sdk.as_api.AsOrganisationVoicemailSettingsAPI(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

API for Organisation voicemail settings

async read(org_id: str | None = None) OrganisationVoicemailSettings[source]

Get Voicemail Settings

Retrieve the organization’s voicemail settings.

Organizational voicemail settings determines what voicemail features a person can configure and automatic message expiration.

Retrieving organization’s voicemail settings requires a full, user or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:

org_id (str) – Retrieve voicemail settings for this organization.

Returns:

VM settings

Return type:

OrganisationVoicemailSettings

async update(settings: OrganisationVoicemailSettings, org_id: str | None = None)[source]

Update the organization’s voicemail settings.

Organizational voicemail settings determines what voicemail features a person can configure and automatic message expiration.

Updating organization’s voicemail settings requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
base = 'telephony/config/voicemail/settings'
class wxc_sdk.as_api.AsOrganizationApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

async list(calling_data: bool | None = None) list[Organization][source]

List all organizations visible by your account. The results will not be paginated.

Parameters:

calling_data (bool) – Include XSI endpoint values in the response (if applicable) for the organization. Default: false

Returns:

list of Organizations

async details(org_id: str, calling_data: bool | None = None) Organization[source]

Get Organization Details

Shows details for an organization, by ID.

Parameters:
  • org_id (str) – The unique identifier for the organization.

  • calling_data (bool) – Include XSI endpoint values in the response (if applicable) for the organization. Default: false

Returns:

org details

Return type:

Organization

async delete(org_id: str)[source]

Delete Organization

Deletes an organization, by ID. It may take up to 10 minutes for the organization to be deleted after the response is returned.

Parameters:

org_id (str) – The unique identifier for the organization.

base = 'organizations'
class wxc_sdk.as_api.AsOutgoingPermissionsApi(*, session: AsRestSession, selector: ApiSelector = 'person')[source]

Bases: AsPersonSettingsApiChild

API for outgoing permissions settings

Also used for user, workspace, location, and virtual line outgoing permissions

feature = 'outgoingPermission'
transfer_numbers: AsTransferNumbersApi
access_codes: AsAccessCodesApi
digit_patterns: AsDigitPatternsApi
async read(entity_id: str, org_id: str | None = None) OutgoingPermissions[source]

Retrieve Outgoing Calling Permissions Settings

You can change the outgoing calling permissions for a person if you want them to be different from your organization’s default.

This API requires a full, user, or read-only administrator auth token with a scope of spark-admin:people_read.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • org_id (str) – Entity is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

Returns:

outgoing permission settings for specific user

Return type:

OutgoingPermissions

async configure(entity_id: str, settings: OutgoingPermissions, drop_call_types: set[str] | None = None, org_id: str | None = None)[source]

Configure Outgoing Calling Permissions Settings

Turn on outgoing call settings for this entity to override the calling settings from the location that are used by default.

This API requires a full or user administrator auth token with the spark-admin:people_write scope or a user auth token with spark:people_write scope can be used by a person to update their own settings.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • settings (OutgoingPermissions) – new setting to be applied

  • drop_call_types (set[str]) – set of call type names to be excluded from updates. Default is the set of call_types known to be not supported for updates

  • org_id – Entity is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

base = ''
class wxc_sdk.as_api.AsPagingApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

list_gen(location_id: str | None = None, name: str | None = None, phone_number: str | None = None, org_id: str | None = None, **params) AsyncGenerator[Paging, None, None][source]

Read the List of Paging Groups List all Paging Groups for the organization.

Group Paging allows a person to place a one-way call or group page to up to 75 people and/or workspaces by dialing a number or extension assigned to a specific paging group. The Group Paging service makes a simultaneous call to all the assigned targets.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Return only paging groups with matching location ID. Default is all locations

  • name (str) – Return only paging groups with the matching name.

  • phone_number (str) – Return only paging groups with matching primary phone number or extension.

  • org_id (str) – List paging groups for this organization.

Returns:

generator of class:Paging objects

async list(location_id: str | None = None, name: str | None = None, phone_number: str | None = None, org_id: str | None = None, **params) List[Paging][source]

Read the List of Paging Groups List all Paging Groups for the organization.

Group Paging allows a person to place a one-way call or group page to up to 75 people and/or workspaces by dialing a number or extension assigned to a specific paging group. The Group Paging service makes a simultaneous call to all the assigned targets.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Return only paging groups with matching location ID. Default is all locations

  • name (str) – Return only paging groups with the matching name.

  • phone_number (str) – Return only paging groups with matching primary phone number or extension.

  • org_id (str) – List paging groups for this organization.

Returns:

generator of class:Paging objects

async create(location_id: str, settings: Paging, org_id: str | None = None) str[source]

Create a new Paging Group Create a new Paging Group for the given location.

Group Paging allows a person to place a one-way call or group page to up to 75 people and/or workspaces by dialing a number or extension assigned to a specific paging group. The Group Paging service makes a simultaneous call to all the assigned targets.

Creating a paging group requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Create the paging group for this location.

  • settings (Paging) – new paging group

  • org_id (str) – Create the paging group for this organization.

Returns:

ID of the newly created paging group.

Return type:

str

async delete_paging(location_id: str, paging_id: str, org_id: str | None = None)[source]

Delete a Paging Group Delete the designated Paging Group.

Group Paging allows a person to place a one-way call or group page to up to 75 people and/or workspaces by dialing a number or extension assigned to a specific paging group. The Group Paging service makes a simultaneous call to all the assigned targets.

Deleting a paging group requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Location from which to delete a paging group.

  • paging_id – Delete the paging group with the matching ID.

  • org_id – Delete the paging group from this organization.

async details(location_id: str, paging_id: str, org_id: str | None = None) Paging[source]

Get Details for a Paging Group Retrieve Paging Group details.

Group Paging allows a person to place a one-way call or group page to up to 75 people and/or workspaces by dialing a number or extension assigned to a specific paging group. The Group Paging service makes a simultaneous call to all the assigned targets.

Retrieving paging group details requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read. :param location_id: Retrieve settings for a paging group in this location. :param paging_id: Retrieve settings for the paging group with this identifier. :param org_id: Retrieve paging group settings from this organization. :return: Paging object

async update(location_id: str, update: Paging, paging_id: str, org_id: str | None = None)[source]

Update the designated Paging Group.

Group Paging allows a person to place a one-way call or group page to up to 75 people and/or workspaces by dialing a number or extension assigned to a specific paging group. The Group Paging service makes a simultaneous call to all the assigned targets.

Updating a paging group requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Update settings for a paging group in this location.

  • update (Paging) – update parameters

  • paging_id (str) – Update settings for the paging group with this identifier.

  • org_id (str) – Update paging group settings from this organization.

base = 'telephony/config'
class wxc_sdk.as_api.AsPeopleApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

People

As of January 2024, the Webex APIs have been fully upgraded to support the industry-standard SCIM2.0 protocol, which is used for user and group management, provisioning, and maintenance. Developers are advised to use this API instead of the people API, due to its higher performance and readily available connectors. Users created via SCIM can be licensed using the /licenses API, even in large quantities, using the new PATCH method.

People are registered users of Webex. Searching and viewing People requires an auth token with a scope of spark:people_read. Viewing the list of all People in your organization requires an administrator auth token with spark-admin:people_read scope. Adding, updating, and removing People requires an administrator auth token with the spark-admin:people_write and spark-admin:people_read scope.

A person’s call settings are for Webex Calling and necessitate Webex Calling licenses.

To learn more about managing people in a room see the Memberships API. For information about how to allocate Hybrid Services licenses to people, see the Managing Hybrid Services guide.

list_gen(email: str | None = None, display_name: str | None = None, id_list: list[str] | None = None, org_id: str | None = None, roles: str | None = None, calling_data: bool | None = None, location_id: str | None = None, **params) AsyncGenerator[Person, None, None][source]

List people in your organization. For most users, either the email or displayName parameter is required. Admin users can omit these fields and list all users in their organization.

Response properties associated with a user’s presence status, such as status or lastActivity, will only be returned for people within your organization or an organization you manage. Presence information will not be returned if the authenticated user has disabled status sharing.

Admin users can include Webex Calling (BroadCloud) user details in the response by specifying callingData parameter as true. Admin users can list all users in a location or with a specific phone number. Admin users will receive an enriched payload with additional administrative fields like liceneses,roles etc. These fields are shown when accessing a user via GET /people/{id}, not when doing a GET /people?id=

Lookup by email is only supported for people within the same org or where a partner admin relationship is in place.

Lookup by roles is only supported for Admin users for the people within the same org.

Parameters:
  • email (str) – List people with this email address. For non-admin requests, either this or displayName are required.

  • display_name (str) – List people whose name starts with this string. For non-admin requests, either this or email are required.

  • id_list (list[str]) – List people by ID. Accepts up to 85 person IDs. If this parameter is provided then presence information (such as the last_activity or status properties) will not be included in the response.

  • org_id (str) – List people in this organization. Only admin users of another organization (such as partners) may use this parameter.

  • roles (str) – List of roleIds separated by commas.

  • calling_data (bool) – Include Webex Calling user details in the response. Default: False

  • location_id (str) – List people present in this location.

Returns:

yield Person instances

async list(email: str | None = None, display_name: str | None = None, id_list: list[str] | None = None, org_id: str | None = None, roles: str | None = None, calling_data: bool | None = None, location_id: str | None = None, **params) List[Person][source]

List people in your organization. For most users, either the email or displayName parameter is required. Admin users can omit these fields and list all users in their organization.

Response properties associated with a user’s presence status, such as status or lastActivity, will only be returned for people within your organization or an organization you manage. Presence information will not be returned if the authenticated user has disabled status sharing.

Admin users can include Webex Calling (BroadCloud) user details in the response by specifying callingData parameter as true. Admin users can list all users in a location or with a specific phone number. Admin users will receive an enriched payload with additional administrative fields like liceneses,roles etc. These fields are shown when accessing a user via GET /people/{id}, not when doing a GET /people?id=

Lookup by email is only supported for people within the same org or where a partner admin relationship is in place.

Lookup by roles is only supported for Admin users for the people within the same org.

Parameters:
  • email (str) – List people with this email address. For non-admin requests, either this or displayName are required.

  • display_name (str) – List people whose name starts with this string. For non-admin requests, either this or email are required.

  • id_list (list[str]) – List people by ID. Accepts up to 85 person IDs. If this parameter is provided then presence information (such as the last_activity or status properties) will not be included in the response.

  • org_id (str) – List people in this organization. Only admin users of another organization (such as partners) may use this parameter.

  • roles (str) – List of roleIds separated by commas.

  • calling_data (bool) – Include Webex Calling user details in the response. Default: False

  • location_id (str) – List people present in this location.

Returns:

yield Person instances

async create(settings: Person, calling_data: bool = False, min_response: bool | None = None) Person[source]

Create a Person

Create a new user account for a given organization. Only an admin can create a new user account.

At least one of the following body parameters is required to create a new user: displayName, firstName, lastName.

Currently, users may have only one email address associated with their account. The emails parameter is an array, which accepts multiple values to allow for future expansion, but currently only one email address will be used for the new user.

Admin users can include Webex calling (BroadCloud) user details in the response by specifying callingData parameter as true. It may happen that the POST request with calling data returns a 400 status, but the person was created still. One way to get into this state is if an invalid phone number is assigned to a user. The people API aggregates calls to several other microservices, and one may have failed. A best practice is to check if the user exists before retrying. This can be done with the user’s email address and a GET /people.

When doing attendee management, to make the new user an attendee for a site: append #attendee to the siteUrl parameter (eg: mysite.webex.com#attendee).

NOTES:

  • For creating a Webex Calling user, you must provide phoneNumbers or extension, locationId, and licenses string in the same request.

  • SipAddresses are assigned via an asynchronous process. This means that the POST response may not show the SIPAddresses immediately. Instead, you can verify them with a separate GET to /people, after they were newly configured.

Parameters:
  • settings (Person) – settings for new user

  • calling_data (bool) – Include Webex Calling user details in the response.

  • min_response (bool) – Set to true to improve performance by omitting person details and returning only the ID in the response when successful. If unsuccessful the response will have optional error details.

Returns:

new user

Return type:

Person

async details(person_id: str, calling_data: bool = False) Person[source]

Shows details for a person, by ID.

Response properties associated with a user’s presence status, such as status or last_activity, will only be displayed for people within your organization or an organization you manage. Presence information will not be shown if the authenticated user has disabled status sharing.

Admin users can include Webex Calling (BroadCloud) user details in the response by specifying calling_data parameter as True.

Parameters:
  • person_id (str) – A unique identifier for the person.

  • calling_data (bool) – Include Webex Calling user details in the response. Default: false

Returns:

person details

Return type:

Person

async delete_person(person_id: str)[source]

Remove a person from the system. Only an admin can remove a person.

Parameters:

person_id – A unique identifier for the person.

Returns:

async update(person: Person, calling_data: bool = False, show_all_types: bool = False, min_response: bool | None = None) Person[source]

Update details for a person, by ID.

Specify the person ID in the personId parameter in the URI. Only an admin can update a person details.

Include all details for the person. This action expects all user details to be present in the request. A common approach is to first GET the person’s details, make changes, then PUT both the changed and unchanged values.

Admin users can include Webex Calling (BroadCloud) user details in the response by specifying callingData parameter as true.

Note: The locationId can only be set when adding a calling license to a user. It cannot be changed if a user is already an existing calling user.

When doing attendee management, to update a user from host role to an attendee for a site append #attendee to the respective siteUrl and remove the meeting host license for this site from the license array.

To update a person from an attendee role to a host for a site, add the meeting license for this site in the meeting array, and remove that site from the siteurl parameter.

To remove the attendee privilege for a user on a meeting site, remove the sitename#attendee from the siteUrls array. The showAllTypes parameter must be set to true.

Parameters:
  • person (Person) – The person to update

  • calling_data (bool) – Include Webex Calling user details in the response. Default: False

  • show_all_types (bool) – Include additional user data like #attendee role

  • min_response (bool) – Set to true to improve performance by omitting person details in the response. If unsuccessful the response will have optional error details.

Returns:

Person details

Return type:

Person

async me(calling_data: bool = False) Person[source]

Show the profile for the authenticated user. This is the same as GET /people/{personId} using the Person ID associated with your Auth token.

Admin users can include Webex Calling (BroadCloud) user details in the response by specifying callingData parameter as true.

Parameters:

calling_data (bool) – True -> return calling data

Return type:

Person

Returns:

profile of authenticated user

base = 'people'
class wxc_sdk.as_api.AsPersonForwardingApi(*, session: AsRestSession, selector: ApiSelector = ApiSelector.person)[source]

Bases: AsPersonSettingsApiChild

API for person’s call forwarding settings

Also used for virtual lines, workspaces

feature = 'callForwarding'
async read(entity_id: str, org_id: str | None = None) PersonForwardingSetting[source]

Retrieve an entity’s Call Forwarding Settings

Three types of call forwarding are supported:

  • Always – forwards all incoming calls to the destination you choose.

  • When busy – forwards all incoming calls to the destination you chose while the phone is in use or the person is busy.

  • When no answer – forwarding only occurs when you are away or not answering your phone.

In addition, the Business Continuity feature will send calls to a destination of your choice if your phone is not connected to the network for any reason, such as power outage, failed Internet connection, or wiring problem

This API requires a full, user, or read-only administrator auth token with a scope of spark-admin:people_read or a user auth token with spark:people_read scope can be used by a person to read their own settings.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • org_id (str) – Entity is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

Returns:

user’s forwarding settings

Return type:

PersonForwardingSetting

async configure(entity_id: str, forwarding: PersonForwardingSetting, org_id: str | None = None)[source]

Configure an Entity’s Call Forwarding Settings

Three types of call forwarding are supported:

  • Always – forwards all incoming calls to the destination you choose.

  • When busy – forwards all incoming calls to the destination you chose while the phone is in use or the entity is busy.

  • When no answer – forwarding only occurs when you are away or not answering your phone.

In addition, the Business Continuity feature will send calls to a destination of your choice if your phone is not connected to the network for any reason, such as power outage, failed Internet connection, or wiring problem

This API requires a full or user administrator auth token with the spark-admin:people_write scope or a user auth token with spark:people_write scope can be used by a person to update their settings.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • forwarding (PersonForwardingSetting) – new forwarding settings

  • org_id (str) – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

Example

api = self.api.telephony.virtual_lines.forwarding

forwarding = api.read(entity_id=self.target.id)
always = CallForwardingAlways(
    enabled=True,
    destination='9999',
    destination_voicemail_enabled=True,
    ring_reminder_enabled=True)
forwarding.call_forwarding.always = always
api.configure(entity_id=self.target.id, forwarding=update)
base = ''
class wxc_sdk.as_api.AsPersonSettingsApi(session: AsRestSession)[source]

Bases: AsApiChild

API for all user level settings

agent_caller_id: AsAgentCallerIdApi

agent caller id Api

appservices: AsAppServicesApi

Person’s Application Services Settings

barge: AsBargeApi

Barge In Settings for a Person

dnd: AsDndApi

Do Not Disturb Settings for a Person

call_bridge: AsCallBridgeApi

Call bridge settings for a person

call_intercept: AsCallInterceptApi

Call Intercept Settings for a Person

call_recording: AsCallRecordingApi

Call Recording Settings for a Person

call_waiting: AsCallWaitingApi

Call Waiting Settings for a Person

calling_behavior: AsCallingBehaviorApi

Person’s Calling Behavior

caller_id: AsCallerIdApi

Caller ID Settings for a Person

exec_assistant: AsExecAssistantApi

Executive Assistant Settings for a Person

forwarding: AsPersonForwardingApi

Forwarding Settings for a Person

hoteling: AsHotelingApi

Hoteling Settings for a Person

monitoring: AsMonitoringApi

Person’s Monitoring Settings

numbers: AsNumbersApi

Phone Numbers for a Person

permissions_in: AsIncomingPermissionsApi

Incoming Permission Settings for a Person

permissions_out: AsOutgoingPermissionsApi

Person’s Outgoing Calling Permissions Settings

preferred_answer: AsPreferredAnswerApi

Preferred answer endpoint settings

privacy: AsPrivacyApi

Person’s Privacy Settings

push_to_talk: AsPushToTalkApi

Push-to-Talk Settings for a Person

receptionist: AsReceptionistApi

Receptionist Client Settings for a Person

schedules: AsScheduleApi

Schedules for a Person

voicemail: AsVoicemailApi

Voicemail Settings for a Person

async reset_vm_pin(person_id: str, org_id: str | None = None)[source]

Reset Voicemail PIN

Reset a voicemail PIN for a person.

The voicemail feature transfers callers to voicemail based on your settings. You can then retrieve voice messages via Voicemail. A voicemail PIN is used to retrieve your voicemail messages.

This API requires a full or user administrator auth token with the spark-admin:people_write scope.

Parameters:
  • person_id – Unique identifier for the person.

  • org_id – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

async devices(person_id: str, org_id: str | None = None) PersonDevicesResponse[source]

Get all devices for a person.

This requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • person_id (str) – Person to retrieve devices for

  • org_id (str) – organization that person belongs to

Returns:

device info for user

Return type:

PersonDevicesResponse

base = 'people'
class wxc_sdk.as_api.AsPersonSettingsApiChild(*, session: AsRestSession, selector: ApiSelector = ApiSelector.person)[source]

Bases: AsApiChild

Base class for all classes implementing person settings APIs

feature = None
base = ''
class wxc_sdk.as_api.AsPreferredAnswerApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

async read(person_id: str, org_id: str | None = None) PreferredAnswerResponse[source]

Get Preferred Answer Endpoint Get the person’s preferred answer endpoint (if any) and the list of endpoints available for selection. These endpoints can be used by the following Call Control API’s that allow the person to specify an endpointId to use for the call:

/v1/telephony/calls/dial

/v1/telephony/calls/retrieve

/v1/telephony/calls/pickup

/v1/telephony/calls/barge-in

/v1/telephony/calls/answer

This API requires spark:telephony_config_read or spark-admin:telephony_config_read scope.

Parameters:
  • person_id – A unique identifier for the person.

  • org_id – ID of the organization in which the person resides. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

Returns:

person’s preferred answer endpoint settings

Return type:

PreferredAnswerResponse

async modify(person_id: str, preferred_answer_endpoint_id: str, org_id: str | None = None)[source]

Modify Preferred Answer Endpoint Sets or clears the person’s preferred answer endpoint. To clear the preferred answer endpoint the p preferred_answer_endpoint_id parameter must be set to None. This API requires spark:telephony_config_write or spark-admin:telephony_config_write scope.

Parameters:
  • person_id – A unique identifier for the person.

  • preferred_answer_endpoint_id – Person’s preferred answer endpoint.

  • org_id – ID of the organization in which the person resides. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

base = 'telephony/config/people'
class wxc_sdk.as_api.AsPremisePstnApi(session: AsRestSession)[source]

Bases: AsApiChild

Premises PSTN API

dial_plan: AsDialPlanApi

dial plan configuration

trunk: AsTrunkApi

trunk configuration

route_group: AsRouteGroupApi

route group configuration

route_list: AsRouteListApi

route list configuration

async validate_pattern(dial_patterns: str | List[str], org_id: str | None = None) DialPatternValidationResult[source]

Validate a Dial Pattern.

Dial plans route calls to on-premises destinations by use of trunks or route groups. They are configured globally for an enterprise and apply to all users, regardless of location. A dial plan also specifies the routing choice (trunk or route group) for calls that match any of its dial patterns. Specific dial patterns can be defined as part of your dial plan.

Validating a dial pattern requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • dial_patterns (list[str] or str) – Array of dial patterns.

  • org_id – Organization to which dial plan belongs.

Returns:

validation result

Return type:

DialPatternValidationResult

base = 'telephony/config/premisePstn'
class wxc_sdk.as_api.AsPrivacyApi(*, session: AsRestSession, selector: ApiSelector = ApiSelector.person)[source]

Bases: AsPersonSettingsApiChild

API for person’s call monitoring settings

feature = 'privacy'
async read(person_id: str, org_id: str | None = None) Privacy[source]

Get a person’s Privacy Settings

Get a person’s privacy settings for the specified person id.

The privacy feature enables the person’s line to be monitored by others and determine if they can be reached by Auto Attendant services.

This API requires a full, user, or read-only administrator auth token with a scope of spark-admin:people_read.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • org_id (str) – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

Returns:

privacy settings

Return type:

Privacy

async configure(person_id: str, settings: Privacy, org_id: str | None = None)[source]

Configure Call Waiting Settings for a Person

Configure a Person’s Call Waiting Settings

With this feature, a person can place an active call on hold and answer an incoming call. When enabled, while you are on an active call, a tone alerts you of an incoming call and you can choose to answer or ignore the call.

This API requires a full or user administrator auth token with the spark-admin:people_write scope.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • settings (Monitoring) – settings for update

  • org_id (str) – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

base = ''
class wxc_sdk.as_api.AsPrivateNetworkConnectApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

API for location private network connect API settings

async read(location_id: str, org_id: str | None = None) NetworkConnectionType[source]

Get Private Network Connect

Retrieve the location’s network connection type.

Network Connection Type determines if the location’s network connection is public or private.

Retrieving location’s network connection type requires a full, user or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Retrieve network connection type for this location.

  • org_id (str) – Retrieve network connection type for this organization.

Returns:

location PNC settings

Return type:

NetworkConnectionType

async update(location_id: str, connection_type: NetworkConnectionType, org_id: str | None = None)[source]

Get Private Network Connect

Retrieve the location’s network connection type.

Network Connection Type determines if the location’s network connection is public or private.

Retrieving location’s network connection type requires a full, user or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Update network connection type for this location.

  • connection_type (NetworkConnectionType) – Network Connection Type for the location.

  • org_id (str) – Update network connection type for this organization.

base = 'telephony/config/locations'
class wxc_sdk.as_api.AsPushToTalkApi(*, session: AsRestSession, selector: ApiSelector = ApiSelector.person)[source]

Bases: AsPersonSettingsApiChild

API for person’s PTT settings

feature = 'pushToTalk'
async read(person_id: str, org_id: str | None = None) PushToTalkSettings[source]

Read Push-to-Talk Settings for a Person Retrieve a Person’s Push-to-Talk Settings

Push-to-Talk allows the use of desk phones as either a one-way or two-way intercom that connects people in different parts of your organization.

This API requires a full, user, or read-only administrator auth token with a scope of spark-admin:people_read.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • org_id (str) – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

Returns:

PTT settings for specific user

Return type:

PushToTalkSettings

async configure(person_id: str, settings: PushToTalkSettings, org_id: str | None = None)[source]

Configure Push-to-Talk Settings for a Person

Configure a Person’s Push-to-Talk Settings

Push-to-Talk allows the use of desk phones as either a one-way or two-way intercom that connects people in different parts of your organization.

This API requires a full or user administrator auth token with the spark-admin:people_write scope.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • settings (PushToTalkSettings) – new setting to be applied. For members only the ID needs to be set

  • org_id – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

base = ''
class wxc_sdk.as_api.AsRebuildPhonesJobsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

async rebuild_phones_configuration(location_id: str, org_id: str | None = None) StartJobResponse[source]

Rebuild Phones Configuration

Rebuild all phone configurations for the specified location.

Rebuild phones jobs are used when there is a change in the network configuration of phones in a location, i.e. a change in the network configuration of devices in a location from public to private and vice-versa.

This API requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Unique identifier of the location.

  • org_id (str) – Rebuild phones for this organization.

Return type:

RebuildPhonesJob

async list(org_id: str | None = None) list[StartJobResponse][source]

List Rebuild Phones Jobs

Get the list of all Rebuild Phones jobs in an organization.

Rebuild phones jobs are used when there is a change in the network configuration of phones in a location, i.e. a change in the network configuration of devices in a location from public to private and vice-versa.

This API requires a full administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:

org_id (str) – List of rebuild phones jobs in this organization.

Return type:

list[RebuildPhonesJob]

async status(job_id: str, org_id: str | None = None) StartJobResponse[source]

Get the Job Status of a Rebuild Phones Job

Get the details of a rebuild phones job by its job ID.

Rebuild phones jobs are used when there is a change in the network configuration of phones in a location, i.e. a change in the network configuration of devices in a location from public to private and vice-versa.

This API requires a full administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • job_id (str) – Retrieve job status for this jobId.

  • org_id (str) – Check a rebuild phones job status in this organization.

Return type:

RebuildPhonesJob

errors_gen(job_id: str, org_id: str | None = None) AsyncGenerator[JobErrorItem, None, None][source]

Get Job Errors for a Rebuild Phones Job

Get errors for a rebuild phones job in an organization.

Rebuild phones jobs are used when there is a change in the network configuration of phones in a location, i.e. a change in the network configuration of devices in a location from public to private and vice-versa.

This API requires a full administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • job_id (str) – Retrieve job errors for this jobId.

  • org_id (str) – Retrieve list of errors for a rebuild phones job in this organization.

Return type:

list[ItemObject]

async errors(job_id: str, org_id: str | None = None) List[JobErrorItem][source]

Get Job Errors for a Rebuild Phones Job

Get errors for a rebuild phones job in an organization.

Rebuild phones jobs are used when there is a change in the network configuration of phones in a location, i.e. a change in the network configuration of devices in a location from public to private and vice-versa.

This API requires a full administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • job_id (str) – Retrieve job errors for this jobId.

  • org_id (str) – Retrieve list of errors for a rebuild phones job in this organization.

Return type:

list[ItemObject]

base = 'telephony/config/jobs/devices/rebuildPhones'
class wxc_sdk.as_api.AsReceptionistApi(*, session: AsRestSession, selector: ApiSelector = ApiSelector.person)[source]

Bases: AsPersonSettingsApiChild

API for person’s receptionist client settings

feature = 'reception'
async read(person_id: str, org_id: str | None = None) ReceptionistSettings[source]

Read Receptionist Client Settings for a Person

Retrieve a Person’s Receptionist Client Settings

To help support the needs of your front-office personnel, you can set up people or workspaces as telephone attendants so that they can screen all incoming calls to certain numbers within your organization.

This API requires a full, user, or read-only administrator auth token with a scope of spark-admin:people_read.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • org_id (str) – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

Returns:

receptionist client settings

Return type:

ReceptionistSettings

async configure(person_id: str, settings: ReceptionistSettings, org_id: str | None = None)[source]

Modify Executive Assistant Settings for a Person

Modify the executive assistant settings for the specified personId.

People with the executive service enabled, can select from a pool of assistants who have been assigned the executive assistant service and who can answer or place calls on their behalf. Executive assistants can set the call forward destination and join or leave an executive’s pool.

This API requires a full or user administrator auth token with the spark-admin:people_write scope.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • settings (ReceptionistSettings) – New receptionist client settings

  • org_id (str) – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

base = ''
class wxc_sdk.as_api.AsReceptionistContactsDirectoryApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Webex Calling Location Receptionist Contacts supports creation of directories and assigning custom groups of users to directories for a location within an organization.

Receptionist Contact Directories are named custom groups of users.

Viewing these read-only directories requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read, as the current set of APIs is designed to provide supplemental information for administrators utilizing People Webex Calling APIs.

Modifying these directories requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

A partner administrator can retrieve or change settings in a customer’s organization using the optional OrgId query parameter.

async create(location_id: str, name: str, contacts: list[str], org_id: str | None = None) str[source]

Creates a new Receptionist Contact Directory for a location.

Receptionist Contact Directories can be used to create named directories of users.

Adding a directory requires a full or write-only administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Add a Receptionist Contact Directory to this location.

  • name (str) – Receptionist Contact Directory name.

  • contacts (list[str]) – Array of user or workspace ids assigned to this Receptionist Contact Directory

  • org_id (str) – Add a Receptionist Contact Directory to this organization.

Returns:

Receptionist Contact Directory ID.

list_gen(location_id: str, org_id: str | None = None) AsyncGenerator[IdAndName, None, None][source]

List all Receptionist Contact Directories for a location.

Receptionist Contact Directories can be used to create named directories of users.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – List Receptionist Contact Directories for this location.

  • org_id (str) – List Receptionist Contact Directories for this organization.

Returns:

Yields IdAndName instances

async list(location_id: str, org_id: str | None = None) List[IdAndName][source]

List all Receptionist Contact Directories for a location.

Receptionist Contact Directories can be used to create named directories of users.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – List Receptionist Contact Directories for this location.

  • org_id (str) – List Receptionist Contact Directories for this organization.

Returns:

Yields IdAndName instances

async delete(location_id: str, directory_id: str, org_id: str | None = None)[source]

Delete a Receptionist Contact Directory from a location.

Receptionist Contact Directories can be used to create named directories of users.

Deleting a directory requires a full or write-only administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id – Delete a Receptionist Contact Directory from this location.

  • directory_id – ID of directory to delete.

  • org_id – Delete a Receptionist Contact Directory from this organization.

base = 'telephony/config/locations'
class wxc_sdk.as_api.AsRecordingsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Recordings

Recordings are meeting content captured in a meeting or files uploaded via the upload page for your Webex site.

This API manages recordings. Recordings may be retrieved via download or playback links defined by downloadUrl or playbackUrl in the response body.

When the recording function is paused in the meeting the recording will not contain the pause. If the recording function is stopped and restarted in the meeting, several recordings will be created. These recordings will be consolidated and available all at once.

Refer to the Meetings API Scopes for the specific scopes required for each API.

list_recordings_gen(from_: str | datetime | None = None, to_: str | datetime | None = None, meeting_id: str | None = None, host_email: str | None = None, site_url: str | None = None, integration_tag: str | None = None, topic: str | None = None, format_: RecordingFormat | None = None, service_type: RecordingServiceType | None = None, status: RecordingStatus | None = None, **params) AsyncGenerator[Recording, None, None][source]

List Recordings

Lists recordings. You can specify a date range, a parent meeting ID, and the maximum number of recordings to return.

Only recordings of meetings hosted by or shared with the authenticated user will be listed.

The list returned is sorted in descending order by the date and time that the recordings were created.

  • If meetingId is specified, only recordings associated with the specified meeting will be listed. NOTE: when meetingId is specified, parameter of siteUrl will be ignored.

  • If siteUrl is specified, recordings of the specified site will be listed; otherwise, the API lists recordings of all the user’s sites. All available Webex sites and preferred site of the user can be retrieved by Get Site List API.

Parameters:
  • from (Union[str, datetime]) – Starting date and time (inclusive) for recordings to return, in any ISO 8601 compliant format. from cannot be after to.

  • to (Union[str, datetime]) –

    Ending date and time (exclusive) for List recordings to return, in any ISO 8601 compliant format. to cannot be before from.

  • meeting_id (str) – Unique identifier for the parent meeting series, scheduled meeting, or meeting instance for which recordings are being requested. If a meeting series ID is specified, the operation returns an array of recordings for the specified meeting series. If a scheduled meeting ID is specified, the operation returns an array of recordings for the specified scheduled meeting. If a meeting instance ID is specified, the operation returns an array of recordings for the specified meeting instance. If no ID is specified, the operation returns an array of recordings for all meetings of the current user. When meetingId is specified, the siteUrl parameter is ignored.

  • host_email (str) – Email address for the meeting host. This parameter is only used if the user or application calling the API has the required admin-level meeting scopes. If set, the admin may specify the email of a user in a site they manage and the API will return recordings of that user.

  • site_url (str) –

    URL of the Webex site from which the API lists recordings. If not specified, the API lists recordings from all of a user’s sites. All available Webex sites and the preferred site of the user can be retrieved by the Get Site List API.

  • integration_tag (str) – External key of the parent meeting created by an integration application. This parameter is used by the integration application to query recordings by a key in its own domain, such as a Zendesk ticket ID, a Jira ID, a Salesforce Opportunity ID, etc.

  • topic (str) – Recording’s topic. If specified, the API filters recordings by topic in a case-insensitive manner.

  • format (RecordingsFormat) – Recording’s file format. If specified, the API filters recordings by format.

  • service_type (RecordingServiceType) – The service type for recordings. If this item is specified, the API filters recordings by service-type.

  • status (ListRecordingsStatus) – Recording’s status. If not specified or available, retrieves recordings that are available. Otherwise, if specified as deleted, retrieves recordings that have been moved into the recycle bin.

Returns:

Generator yielding RecordingObject instances

async list_recordings(from_: str | datetime | None = None, to_: str | datetime | None = None, meeting_id: str | None = None, host_email: str | None = None, site_url: str | None = None, integration_tag: str | None = None, topic: str | None = None, format_: RecordingFormat | None = None, service_type: RecordingServiceType | None = None, status: RecordingStatus | None = None, **params) List[Recording][source]

List Recordings

Lists recordings. You can specify a date range, a parent meeting ID, and the maximum number of recordings to return.

Only recordings of meetings hosted by or shared with the authenticated user will be listed.

The list returned is sorted in descending order by the date and time that the recordings were created.

  • If meetingId is specified, only recordings associated with the specified meeting will be listed. NOTE: when meetingId is specified, parameter of siteUrl will be ignored.

  • If siteUrl is specified, recordings of the specified site will be listed; otherwise, the API lists recordings of all the user’s sites. All available Webex sites and preferred site of the user can be retrieved by Get Site List API.

Parameters:
  • from (Union[str, datetime]) –

    Starting date and time (inclusive) for recordings to return, in any ISO 8601 compliant format. from cannot be after to.

  • to (Union[str, datetime]) –

    Ending date and time (exclusive) for List recordings to return, in any ISO 8601 compliant format. to cannot be before from.

  • meeting_id (str) – Unique identifier for the parent meeting series, scheduled meeting, or meeting instance for which recordings are being requested. If a meeting series ID is specified, the operation returns an array of recordings for the specified meeting series. If a scheduled meeting ID is specified, the operation returns an array of recordings for the specified scheduled meeting. If a meeting instance ID is specified, the operation returns an array of recordings for the specified meeting instance. If no ID is specified, the operation returns an array of recordings for all meetings of the current user. When meetingId is specified, the siteUrl parameter is ignored.

  • host_email (str) –

    Email address for the meeting host. This parameter is only used if the user or application calling the API has the required admin-level meeting scopes. If set, the admin may specify the email of a user in a site they manage and the API will return recordings of that user.

  • site_url (str) –

    URL of the Webex site from which the API lists recordings. If not specified, the API lists recordings from all of a user’s sites. All available Webex sites and the preferred site of the user can be retrieved by the Get Site List API.

  • integration_tag (str) – External key of the parent meeting created by an integration application. This parameter is used by the integration application to query recordings by a key in its own domain, such as a Zendesk ticket ID, a Jira ID, a Salesforce Opportunity ID, etc.

  • topic (str) – Recording’s topic. If specified, the API filters recordings by topic in a case-insensitive manner.

  • format (RecordingsFormat) – Recording’s file format. If specified, the API filters recordings by format.

  • service_type (RecordingServiceType) – The service type for recordings. If this item is specified, the API filters recordings by service-type.

  • status (ListRecordingsStatus) – Recording’s status. If not specified or available, retrieves recordings that are available. Otherwise, if specified as deleted, retrieves recordings that have been moved into the recycle bin.

Returns:

Generator yielding RecordingObject instances

list_recordings_for_an_admin_or_compliance_officer_gen(from_: str | datetime | None = None, to_: str | datetime | None = None, meeting_id: str | None = None, site_url: str | None = None, integration_tag: str | None = None, topic: str | None = None, format_: RecordingFormat | None = None, service_type: RecordingServiceType | None = None, status: RecordingStatus | None = None, **params) AsyncGenerator[Recording, None, None][source]

List Recordings For an Admin or Compliance Officer

List recordings for an admin or compliance officer. You can specify a date range, a parent meeting ID, and the maximum number of recordings to return.

The list returned is sorted in descending order by the date and time that the recordings were created.

Long result sets are split into pages.

  • If meetingId is specified, only recordings associated with the specified meeting will be listed. Please note that when meetingId is specified, parameter of siteUrl will be ignored.

  • If siteUrl is specified, all the recordings on the specified site are listed; otherwise, all the recordings on the admin user’s or compliance officer’s preferred site are listed. All the available Webex sites and the admin user’s or compliance officer’s preferred site can be retrieved by the Get Site List API.

Parameters:
  • from (Union[str, datetime]) –

    Starting date and time (inclusive) for recordings to return, in any ISO 8601 compliant format. from cannot be after to. The interval between from and to must be within 30 days.

  • to (Union[str, datetime]) –

    Ending date and time (exclusive) for List recordings to return, in any ISO 8601 compliant format. to cannot be before from. The interval between from and to must be within 30 days.

  • meeting_id (str) – Unique identifier for the parent meeting series, scheduled meeting, or meeting instance for which recordings are being requested. If a meeting series ID is specified, the operation returns an array of recordings for the specified meeting series. If a scheduled meeting ID is specified, the operation returns an array of recordings for the specified scheduled meeting. If a meeting instance ID is specified, the operation returns an array of recordings for the specified meeting instance. If not specified, the operation returns an array of recordings for all the current user’s meetings. When meetingId is specified, the siteUrl parameter is ignored.

  • site_url (str) –

    URL of the Webex site which the API lists recordings from. If not specified, the API lists recordings from user’s preferred site. All available Webex sites and preferred site of the user can be retrieved by Get Site List API.

  • integration_tag (str) – External key of the parent meeting created by an integration application. This parameter is used by the integration application to query recordings by a key in its own domain such as a Zendesk ticket ID, a Jira ID, a Salesforce Opportunity ID, etc.

  • topic (str) – Recording topic. If specified, the API filters recordings by topic in a case-insensitive manner.

  • format (RecordingsFormat) – Recording’s file format. If specified, the API filters recordings by format.

  • service_type (RecordingServiceType) – The service type for recordings. If specified, the API filters recordings by service type.

  • status (ListRecordingsStatus) – Recording’s status. If not specified or available, retrieves recordings that are available. Otherwise, if specified as deleted, retrieves recordings that have been moved to the recycle bin.

Returns:

Generator yielding RecordingObjectForAdminAndCO instances

async list_recordings_for_an_admin_or_compliance_officer(from_: str | datetime | None = None, to_: str | datetime | None = None, meeting_id: str | None = None, site_url: str | None = None, integration_tag: str | None = None, topic: str | None = None, format_: RecordingFormat | None = None, service_type: RecordingServiceType | None = None, status: RecordingStatus | None = None, **params) List[Recording][source]

List Recordings For an Admin or Compliance Officer

List recordings for an admin or compliance officer. You can specify a date range, a parent meeting ID, and the maximum number of recordings to return.

The list returned is sorted in descending order by the date and time that the recordings were created.

Long result sets are split into pages.

  • If meetingId is specified, only recordings associated with the specified meeting will be listed. Please note that when meetingId is specified, parameter of siteUrl will be ignored.

  • If siteUrl is specified, all the recordings on the specified site are listed; otherwise, all the recordings on the admin user’s or compliance officer’s preferred site are listed. All the available Webex sites and the admin user’s or compliance officer’s preferred site can be retrieved by the Get Site List API.

Parameters:
  • from (Union[str, datetime]) –

    Starting date and time (inclusive) for recordings to return, in any ISO 8601 compliant format. from cannot be after to. The interval between from and to must be within 30 days.

  • to (Union[str, datetime]) –

    Ending date and time (exclusive) for List recordings to return, in any ISO 8601 compliant format. to cannot be before from. The interval between from and to must be within 30 days.

  • meeting_id (str) – Unique identifier for the parent meeting series, scheduled meeting, or meeting instance for which recordings are being requested. If a meeting series ID is specified, the operation returns an array of recordings for the specified meeting series. If a scheduled meeting ID is specified, the operation returns an array of recordings for the specified scheduled meeting. If a meeting instance ID is specified, the operation returns an array of recordings for the specified meeting instance. If not specified, the operation returns an array of recordings for all the current user’s meetings. When meetingId is specified, the siteUrl parameter is ignored.

  • site_url (str) –

    URL of the Webex site which the API lists recordings from. If not specified, the API lists recordings from user’s preferred site. All available Webex sites and preferred site of the user can be retrieved by Get Site List API.

  • integration_tag (str) – External key of the parent meeting created by an integration application. This parameter is used by the integration application to query recordings by a key in its own domain such as a Zendesk ticket ID, a Jira ID, a Salesforce Opportunity ID, etc.

  • topic (str) – Recording topic. If specified, the API filters recordings by topic in a case-insensitive manner.

  • format (RecordingsFormat) – Recording’s file format. If specified, the API filters recordings by format.

  • service_type (RecordingServiceType) – The service type for recordings. If specified, the API filters recordings by service type.

  • status (ListRecordingsStatus) – Recording’s status. If not specified or available, retrieves recordings that are available. Otherwise, if specified as deleted, retrieves recordings that have been moved to the recycle bin.

Returns:

Generator yielding RecordingObjectForAdminAndCO instances

async get_recording_details(recording_id: str, host_email: str | None = None) Recording[source]

Get Recording Details

Retrieves details for a recording with a specified recording ID.

Only recordings of meetings hosted by or shared with the authenticated user may be retrieved.

Parameters:
  • recording_id (str) – A unique identifier for the recording.

  • host_email (str) –

    Email address for the meeting host. Only used if the user or application calling the API has required admin-level meeting scopes. If set, the admin may specify the email of a user in a site they manage, and the API will return recording details of that user.

Return type:

RecordingObjectWithDirectDownloadLinks

async delete_a_recording(recording_id: str, reason: str, comment: str, host_email: str | None = None)[source]

Delete a Recording

Removes a recording with a specified recording ID. The deleted recording cannot be recovered. If a Compliance Officer deletes another user’s recording, the recording will be inaccessible to regular users (host, attendees and shared), but will be still available to the Compliance Officer.

Only recordings of meetings hosted by the authenticated user can be deleted.

Parameters:
  • recording_id (str) – A unique identifier for the recording.

  • reason (str) – Reason for deleting a recording. Only required when a Compliance Officer is operating on another user’s recording.

  • comment (str) – Compliance Officer’s explanation for deleting a recording. The comment can be a maximum of 255 characters long.

  • host_email (str) –

    Email address for the meeting host. Only used if the user or application calling the API has the required admin-level meeting scopes. If set, the admin may specify the email of a user in a site they manage and the API will delete a recording of that user.

Return type:

None

async move_recordings_into_the_recycle_bin(recording_ids: list[str], site_url: str, host_email: str | None = None)[source]

Move Recordings into the Recycle Bin

Move recordings into the recycle bin with recording IDs. Recordings in the recycle bin can be recovered by Restore Recordings from Recycle Bin API. If you’d like to empty recordings from the recycle bin, you can use Purge Recordings from Recycle Bin API to purge all or some of them.

Only recordings of meetings hosted by the authenticated user can be moved into the recycle bin.

  • recordingIds should not be empty and its maximum size is 100.

  • All the IDs of recordingIds should belong to the site of siteUrl or the user’s preferred site if

    siteUrl is not specified.

Parameters:
  • recording_ids (list[str]) – Recording IDs for removing recordings into the recycle bin in batch. Please note that all the recording IDs should belong to the site of siteUrl or the user’s preferred site if siteUrl is not specified.

  • site_url (str) –

    URL of the Webex site from which the API deletes recordings. If not specified, the API deletes recordings from the user’s preferred site. All available Webex sites and preferred sites of a user can be retrieved by the Get Site List API.

  • host_email (str) –

    Email address for the meeting host. Only used if the user or application calling the API has the required admin-level meeting scopes. If set, the admin may specify the email of a user in a site they manage and the API will move recordings into recycle bin of that user

Return type:

None

async restore_recordings_from_recycle_bin(restore_all: bool, recording_ids: list[str], site_url: str, host_email: str | None = None)[source]

Restore Recordings from Recycle Bin

Restore all or some recordings from the recycle bin. Only recordings of meetings hosted by the authenticated user can be restored from recycle bin.

  • If restoreAll is true, recordingIds should be empty.

  • If restoreAll is false, recordingIds should not be empty and its maximum size is 100.

  • All the IDs of recordingIds should belong to the site of siteUrl or the user’s preferred site if

    siteUrl is not specified.

Parameters:
  • restore_all (bool) – If not specified or false, restores the recordings specified by recordingIds. If true, restores all recordings from the recycle bin.

  • recording_ids (list[str]) – Recording IDs for recovering recordings from the recycle bin in batch. Note that all the recording IDs should belong to the site of siteUrl or the user’s preferred site if siteUrl is not specified.

  • site_url (str) –

    URL of the Webex site from which the API restores recordings. If not specified, the API restores recordings from a user’s preferred site. All available Webex sites and preferred sites of a user can be retrieved by Get Site List API.

  • host_email (str) –

    Email address for the meeting host. This parameter is only used if the user or application calling the API has the required admin-level meeting scopes. If set, the admin may specify the email of a user in a site they manage and the API will restore recordings of that user.

Return type:

None

async purge_recordings_from_recycle_bin(purge_all: bool, recording_ids: list[str], site_url: str, host_email: str | None = None)[source]

Purge Recordings from Recycle Bin

Purge recordings from recycle bin with recording IDs or purge all the recordings that are in the recycle bin.

Only recordings of meetings hosted by the authenticated user can be purged from recycle bin.

  • If purgeAll is true, recordingIds should be empty.

  • If purgeAll is false, recordingIds should not be empty and its maximum size is 100.

  • All the IDs of recordingIds should belong to the site of siteUrl or the user’s preferred site if

    siteUrl is not specified.

Parameters:
  • purge_all (bool) – If not specified or false, purges the recordings specified by recordingIds. If true, purges all recordings from the recycle bin.

  • recording_ids (list[str]) – Recording IDs for purging recordings from the recycle bin in batch. Note that all the recording IDs should belong to the site of siteUrl or the user’s preferred site if siteUrl is not specified.

  • site_url (str) –

    URL of the Webex site from which the API purges recordings. If not specified, the API purges recordings from user’s preferred site. All available Webex sites and preferred sites of the user can be retrieved by Get Site List API.

  • host_email (str) –

    Email address for the meeting host. Only used if the user or application calling the API has the required admin-level meeting scopes. If set, the admin may specify the email of a user in a site they manage and the API will purge recordings from recycle bin of that user.

Return type:

None

base = ''
class wxc_sdk.as_api.AsReportsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Reports

To access these endpoints, you must use an administrator token with the analytics:read_all scope. The authenticated user must be a read-only or full administrator of the organization to which the report belongs.

To use this endpoint the org needs to be licensed for the Pro Pack.

Reports available via Webex Control Hub may be generated and downloaded via the Reports API. To access this API, the authenticated user must be a read-only or full administrator of the organization to which the report belongs.

For more information about Reports, see the Admin API guide.

async list_templates() list[ReportTemplate][source]

List all the available report templates that can be generated.

CSV (comma separated value) reports for Webex services are only supported for organizations based in the North American region. Organizations based in other regions will return blank CSV files for any Webex reports.

Returns:

list of report templates

Return type:

list[ReportTemplate]

list_gen(report_id: str | None = None, service: str | None = None, template_id: str | None = None, from_date: date | None = None, to_date: date | None = None) AsyncGenerator[Report, None, None][source]

Lists all reports. Use query parameters to filter the response. The parameters are optional. However, from and to parameters should be provided together.

CSV reports for Teams services are only supported for organizations based in the North American region. Organizations based in a different region will return blank CSV files for any Teams reports.

Reports are usually provided in zip format. A Content-header application/zip or application/octet-stream does indicate the zip format. There is usually no .zip file extension.

Parameters:
  • report_id – List reports by ID.

  • service – List reports which use this service.

  • template_id – List reports with this report template ID.

  • from_date – List reports that were created on or after this date.

  • to_date – List reports that were created before this date.

Returns:

yields Report instances

async list(report_id: str | None = None, service: str | None = None, template_id: str | None = None, from_date: date | None = None, to_date: date | None = None) List[Report][source]

Lists all reports. Use query parameters to filter the response. The parameters are optional. However, from and to parameters should be provided together.

CSV reports for Teams services are only supported for organizations based in the North American region. Organizations based in a different region will return blank CSV files for any Teams reports.

Reports are usually provided in zip format. A Content-header application/zip or application/octet-stream does indicate the zip format. There is usually no .zip file extension.

Parameters:
  • report_id – List reports by ID.

  • service – List reports which use this service.

  • template_id – List reports with this report template ID.

  • from_date – List reports that were created on or after this date.

  • to_date – List reports that were created before this date.

Returns:

yields Report instances

async create(template_id: int, start_date: date | None = None, end_date: date | None = None, site_list: str | None = None) str[source]

Create a new report. For each templateId, there are a set of validation rules that need to be followed. For example, for templates belonging to Webex, the user needs to provide siteUrl. These validation rules can be retrieved via the Report Templates API.

CSV reports for Teams services are only supported for organizations based in the North American region. Organizations based in a different region will return blank CSV files for any Teams reports.

Parameters:
  • template_id (int) – Unique ID representing valid report templates.

  • start_date (date) – Data in the report will be from this date onwards.

  • end_date (date) – Data in the report will be until this date.

  • site_list (str) – Sites belonging to user’s organization. This attribute is needed for site-based templates.

Returns:

The unique identifier for the report.

Return type:

str

async details(report_id: str) Report[source]

Shows details for a report, by report ID.

Specify the report ID in the reportId parameter in the URI.

CSV reports for Teams services are only supported for organizations based in the North American region. Organizations based in a different region will return blank CSV files for any Teams reports.

Parameters:

report_id (str) – The unique identifier for the report.

Returns:

report details

Return type:

Report

async delete(report_id: str)[source]

Remove a report from the system.

Specify the report ID in the reportId parameter in the URI

CSV reports for Teams services are only supported for organizations based in the North American region. Organizations based in a different region will return blank CSV files for any Teams reports.

Parameters:

report_id (str) – The unique identifier for the report.

async download(url: str) List[dict][source]

Download a report from the given URL and yield the rows as dicts

Parameters:

url (str) – download URL

Returns:

list of dicts (one per row)

Return type:

list[dict]

base = 'devices'
class wxc_sdk.as_api.AsRestSession(*, tokens: Tokens, concurrent_requests: int, retry_429: bool = True)[source]

Bases: ClientSession

REST session used for API requests:
  • includes an Authorization header in reach request

  • implements retries on 429

  • loads deserializes JSON data if needed

BASE = 'https://webexapis.com/v1'

base URL for all Webex API requests

property access_token: str

access token used for all requests

Returns:

access token

Return type:

str

async rest_get(*args, **kwargs) str | dict[source]

GET request

Parameters:
  • args

  • kwargs

Returns:

deserialized JSON content or body text

async rest_post(*args, **kwargs) str | dict[source]

POST request

Parameters:
  • args

  • kwargs

Returns:

deserialized JSON content or body text

async rest_put(*args, **kwargs) str | dict[source]

PUT request

Parameters:
  • args

  • kwargs

Returns:

deserialized JSON content or body text

async rest_delete(*args, **kwargs) None[source]

DELETE request

Parameters:
  • args

  • kwargs

async rest_patch(*args, **kwargs) str | dict[source]

PATCH request

Parameters:
  • args

  • kwargs

async follow_pagination(url: str, model: Type[ApiModel] | None = None, params: dict | None = None, item_key: str | None = None, **kwargs) AsyncGenerator[ApiModel, None, None][source]

Handling RFC5988 pagination of list requests. Generator of parsed objects

Parameters:
  • url (str) – start url for 1st GET

  • model (ApiModel) – data type to return

  • params (Optional[dict]) – URL parameters, optional

  • item_key (str) – key to list of values

Returns:

yields parsed objects

class wxc_sdk.as_api.AsRoomTabsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

A Room Tab represents a URL shortcut that is added as a persistent tab to a Webex room (space) tab row. Use this API to list tabs of any Webex room that you belong to. Room Tabs can also be updated to point to a different content URL, or deleted to remove the tab from the room. Just like in the Webex app, you must be a member of the room in order to list its Room Tabs.

list_tabs_gen(room_id: str, **params) AsyncGenerator[RoomTab, None, None][source]

Lists all Room Tabs of a room specified by the roomId query parameter.

Parameters:

room_id (str) – ID of the room for which to list room tabs.

async list_tabs(room_id: str, **params) List[RoomTab][source]

Lists all Room Tabs of a room specified by the roomId query parameter.

Parameters:

room_id (str) – ID of the room for which to list room tabs.

async create_tab(room_id: str, content_url: str, display_name: str) RoomTab[source]

Add a tab with a specified URL to a room.

Parameters:
  • room_id (str) – A unique identifier for the room.

  • content_url (str) – URL of the Room Tab. Must use https protocol.

  • display_name (str) – User-friendly name for the room tab.

async tab_details(tab_id: str) RoomTab[source]

Get details for a Room Tab with the specified room tab ID.

Parameters:

tab_id (str) – The unique identifier for the Room Tab.

async update_tab(tab_id: str, room_id: str, content_url: str, display_name: str) RoomTab[source]

Updates the content URL of the specified Room Tab ID.

Parameters:
  • tab_id (str) – The unique identifier for the Room Tab.

  • room_id (str) – ID of the room that contains the room tab in question.

  • content_url (str) – Content URL of the Room Tab. URL must use https protocol.

  • display_name (str) – User-friendly name for the room tab.

async delete_tab(tab_id: str)[source]

Deletes a Room Tab with the specified ID.

Parameters:

tab_id (str) – The unique identifier for the Room Tab to delete.

base = 'room/tabs'
class wxc_sdk.as_api.AsRoomsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Rooms are virtual meeting places where people post messages and collaborate to get work done. This API is used to manage the rooms themselves. Rooms are created and deleted with this API. You can also update a room to change its title, for example. To create a team room, specify the a teamId in the POST payload. Note that once a room is added to a team, it cannot be moved. To learn more about managing teams, see the Teams API. To manage people in a room see the Memberships API. To post content see the Messages API.

list_gen(team_id: str | None = None, type_: RoomType | None = None, org_public_spaces: bool | None = None, from_: datetime | None = None, to_: datetime | None = None, sort_by: str | None = None, **params) AsyncGenerator[Room, None, None][source]

List rooms. The title of the room for 1:1 rooms will be the display name of the other person. By default, lists rooms to which the authenticated user belongs. Long result sets will be split into pages. Known Limitations: The underlying database does not support natural sorting by lastactivity and will only sort on limited set of results, which are pulled from the database in order of roomId. For users or bots in more than 3000 spaces this can result in anomalies such as spaces that have had recent activity not being returned in the results when sorting by lastacivity.

Parameters:
  • team_id (str) – List rooms associated with a team, by ID.

  • type (RoomType) – List rooms by type. Possible values: direct, group

  • org_public_spaces (bool) – Shows the org’s public spaces joined and unjoined. When set the result list is sorted by the madePublic timestamp.

  • from (datetime) – Filters rooms, that were made public after this time. See madePublic timestamp

  • to (datetime) – Filters rooms, that were made public before this time. See maePublic timestamp

  • sort_by (str) – Sort results. Possible values: id, lastactivity, created

async list(team_id: str | None = None, type_: RoomType | None = None, org_public_spaces: bool | None = None, from_: datetime | None = None, to_: datetime | None = None, sort_by: str | None = None, **params) List[Room][source]

List rooms. The title of the room for 1:1 rooms will be the display name of the other person. By default, lists rooms to which the authenticated user belongs. Long result sets will be split into pages. Known Limitations: The underlying database does not support natural sorting by lastactivity and will only sort on limited set of results, which are pulled from the database in order of roomId. For users or bots in more than 3000 spaces this can result in anomalies such as spaces that have had recent activity not being returned in the results when sorting by lastacivity.

Parameters:
  • team_id (str) – List rooms associated with a team, by ID.

  • type (RoomType) – List rooms by type. Possible values: direct, group

  • org_public_spaces (bool) – Shows the org’s public spaces joined and unjoined. When set the result list is sorted by the madePublic timestamp.

  • from (datetime) – Filters rooms, that were made public after this time. See madePublic timestamp

  • to (datetime) – Filters rooms, that were made public before this time. See maePublic timestamp

  • sort_by (str) – Sort results. Possible values: id, lastactivity, created

async create(title: str, team_id: str | None = None, classification_id: str | None = None, is_locked: bool | None = None, is_public: bool | None = None, description: str | None = None, is_announcement_only: bool | None = None) Room[source]

Creates a room. The authenticated user is automatically added as a member of the room. See the Memberships API to learn how to add more people to the room.

To create a 1:1 room, use the Create Messages endpoint to send a message directly to another person by using the toPersonId or toPersonEmail parameters. Bots are not able to create and simultaneously classify a room. A bot may update a space classification after a person of the same owning organization joined the space as the first human user.

A space can only be put into announcement mode when it is locked.

Parameters:
  • title (str) – A user-friendly name for the room.

  • team_id (str) – The ID for the team with which this room is associated.

  • classification_id (str) – The classificationId for the room.

  • is_locked (bool) – Set the space as locked/moderated and the creator becomes a moderator

  • is_public (bool) – The room is public and therefore discoverable within the org. Anyone can find and join that room. When true the description must be filled in.

  • description (str) – The description of the space.

  • is_announcement_only (bool) – Sets the space into announcement Mode.

async details(room_id: str) Room[source]

Shows details for a room, by ID. The title of the room for 1:1 rooms will be the display name of the other person. Specify the room ID in the roomId parameter in the URI.

Parameters:

room_id (str) – The unique identifier for the room.

async meeting_details(room_id: str) GetRoomMeetingDetailsResponse[source]

Shows Webex meeting details for a room such as the SIP address, meeting URL, toll-free and toll dial-in numbers. Specify the room ID in the roomId parameter in the URI.

Parameters:

room_id (str) – The unique identifier for the room.

async update(update: Room) Room[source]

Updates details for a room, by ID.

Specify the room ID in the roomId parameter in the URI.

A space can only be put into announcement mode when it is locked.

Any space participant or compliance officer can convert a space from public to private. Only a compliance officer can convert a space from private to public and only if the space is classified with the lowest category (usually public), and the space has a description.

To remove a description please use a space character by itself.

Update:

update to apply. ID and title have to be set. Only can update:

  • title: str: A user-friendly name for the room.

  • classification_id: str: The classificationId for the room.

  • team_id: str: The teamId to which this space should be assigned. Only unowned spaces can be assigned to a team. Assignment between teams is unsupported.

  • is_locked: bool: Set the space as locked/moderated and the creator becomes a moderator

  • is_announcement_only: bool: Sets the space into announcement mode or clears the anouncement Mode (false)

  • is_read_only: bool: A compliance officer can set a direct room as read-only, which will disallow any new information exchanges in this space, while maintaining historical data.

async delete(room_id: str)[source]

Deletes a room, by ID. Deleted rooms cannot be recovered. As a security measure to prevent accidental deletion, when a non moderator deletes the room they are removed from the room instead. Deleting a room that is part of a team will archive the room instead. Specify the room ID in the roomId parameter in the URI.

Parameters:

room_id (str) – The unique identifier for the room.

base = 'rooms'
class wxc_sdk.as_api.AsRouteGroupApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

API for everything route groups

list_gen(name: str | None = None, order: str | None = None, org_id: str | None = None, **params) AsyncGenerator[RouteGroup, None, None][source]

List all Route Groups for an organization. A Route Group is a group of trunks that allows further scale and redundancy with the connection to the premises.

Retrieving this route group list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • name (st) – Return the list of route groups matching the route group name.

  • order (str) – Order the route groups according to designated fields. Available sort orders: asc, desc.

  • org_id (str) – List route groups for this organization.

Returns:

generator of RouteGroup instances

async list(name: str | None = None, order: str | None = None, org_id: str | None = None, **params) List[RouteGroup][source]

List all Route Groups for an organization. A Route Group is a group of trunks that allows further scale and redundancy with the connection to the premises.

Retrieving this route group list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • name (st) – Return the list of route groups matching the route group name.

  • order (str) – Order the route groups according to designated fields. Available sort orders: asc, desc.

  • org_id (str) – List route groups for this organization.

Returns:

generator of RouteGroup instances

async create(route_group: RouteGroup, org_id: str | None = None) str[source]

Creates a Route Group for the organization.

A Route Group is a collection of trunks that allows further scale and redundancy with the connection to the premises. Route groups can include up to 10 trunks from different locations.

Creating a Route Group requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • route_group (RouteGroup) –

    settings for new route group. name and local_gateways need to be set. For each LGW id and priority need to be set. Example:

    rg = RouteGroup(name=rg_name,
            local_gateways=[RGTrunk(trunk_id=trunk.trunk_id,
                                    priority=1)])
    rg_id = api.telephony.prem_pstn.route_group.create(route_group=rg)
    

  • org_id (str)

Returns:

id of new route group

Return type:

str

async details(rg_id: str, org_id: str | None = None) RouteGroup[source]

Reads a Route Group for the organization based on id.

A Route Group is a collection of trunks that allows further scale and redundancy with the connection to the premises. Route groups can include up to 10 trunks from different locations.

Reading a Route Group requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • rg_id (str) – Route Group for which details are being requested.

  • org_id (str) – Organization of the Route Group.

Returns:

route group details

Return type:

RouteGroup

async update(rg_id: str, update: RouteGroup, org_id: str | None = None)[source]

Modifies an existing Route Group for an organization based on id.

A Route Group is a collection of trunks that allows further scale and redundancy with the connection to the premises. Route groups can include up to 10 trunks from different locations.

Modifying a Route Group requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • rg_id (str) – route group to be modified

  • update (RouteGroup) – new settings

  • org_id (str) – Organization of the Route Group.

async delete_route_group(rg_id: str, org_id: str | None = None)[source]

Remove a Route Group from an Organization based on id.

A Route Group is a collection of trunks that allows further scale and redundancy with the connection to the premises. Route groups can include up to 10 trunks from different locations.

Removing a Route Group requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • rg_id (str) – Route Group to be deleted

  • org_id (str) – Organization of the Route Group.

async usage(rg_id: str, org_id: str | None = None) RouteGroupUsage[source]

List the number of “Call to” on-premises Extensions, Dial Plans, PSTN Connections, and Route Lists used by a specific Route Group. Users within Call to Extension locations are registered to a PBX which allows you to route unknown extensions (calling number length of 2-6 digits) to the PBX using an existing Trunk or Route Group. PSTN Connections may be cisco PSTN, cloud-connected PSTN, or premises-based PSTN (local gateway). Dial Plans allow you to route calls to on-premises extensions via your trunk or route group. Route Lists are a list of numbers that can be reached via a route group. It can be used to provide cloud PSTN connectivity to Webex Calling Dedicated Instance.

Retrieving usage information requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • rg_id (str) – Route group requested for information.

  • org_id (str) – Organization associated with specific route group

Returns:

usage information

Return type:

RouteGroupUsage

usage_call_to_extension_gen(rg_id: str, org_id: str | None = None, **params) AsyncGenerator[IdAndName, None, None][source]

List “Call to” on-premises Extension Locations for a specific route group. Users within these locations are registered to a PBX which allows you to route unknown extensions (calling number length of 2-6 digits) to the PBX using an existing trunk or route group.

Retrieving this location list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • rg_id – Route group requested for information.

  • org_id – Organization associated with specific route group.

Returns:

generator of instances

Return type:

wxc_sdk.common.IdAndName

async usage_call_to_extension(rg_id: str, org_id: str | None = None, **params) List[IdAndName][source]

List “Call to” on-premises Extension Locations for a specific route group. Users within these locations are registered to a PBX which allows you to route unknown extensions (calling number length of 2-6 digits) to the PBX using an existing trunk or route group.

Retrieving this location list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • rg_id – Route group requested for information.

  • org_id – Organization associated with specific route group.

Returns:

generator of instances

Return type:

wxc_sdk.common.IdAndName

usage_dial_plan_gen(rg_id: str, org_id: str | None = None, **params) AsyncGenerator[IdAndName, None, None][source]

List Dial Plan Locations for a specific route group.

Dial Plans allow you to route calls to on-premises destinations by use of trunks or route groups. They are configured globally for an enterprise and apply to all users, regardless of location. A Dial Plan also specifies the routing choice (trunk or route group) for calls that match any of its dial patterns. Specific dial patterns can be defined as part of your dial plan.

Retrieving this location list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • rg_id – Route group requested for information.

  • org_id – Organization associated with specific route group.

Returns:

generator of instances

Return type:

wxc_sdk.common.IdAndName

async usage_dial_plan(rg_id: str, org_id: str | None = None, **params) List[IdAndName][source]

List Dial Plan Locations for a specific route group.

Dial Plans allow you to route calls to on-premises destinations by use of trunks or route groups. They are configured globally for an enterprise and apply to all users, regardless of location. A Dial Plan also specifies the routing choice (trunk or route group) for calls that match any of its dial patterns. Specific dial patterns can be defined as part of your dial plan.

Retrieving this location list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • rg_id – Route group requested for information.

  • org_id – Organization associated with specific route group.

Returns:

generator of instances

Return type:

wxc_sdk.common.IdAndName

usage_location_pstn_gen(rg_id: str, org_id: str | None = None, **params) AsyncGenerator[IdAndName, None, None][source]

List PSTN Connection Locations for a specific route group. This solution lets you configure users to use Cloud PSTN (CCP or Cisco PSTN) or Premises-based PSTN.

Retrieving this Location list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • rg_id – Route group requested for information.

  • org_id – Organization associated with specific route group.

Returns:

generator of instances

Return type:

wxc_sdk.common.IdAndName

async usage_location_pstn(rg_id: str, org_id: str | None = None, **params) List[IdAndName][source]

List PSTN Connection Locations for a specific route group. This solution lets you configure users to use Cloud PSTN (CCP or Cisco PSTN) or Premises-based PSTN.

Retrieving this Location list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • rg_id – Route group requested for information.

  • org_id – Organization associated with specific route group.

Returns:

generator of instances

Return type:

wxc_sdk.common.IdAndName

usage_route_lists_gen(rg_id: str, org_id: str | None = None, **params) AsyncGenerator[UsageRouteLists, None, None][source]

List Route Lists for a specific route group. Route Lists are a list of numbers that can be reached via a Route Group. It can be used to provide cloud PSTN connectivity to Webex Calling Dedicated Instance.

Retrieving this list of Route Lists requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • rg_id – Route group requested for information.

  • org_id – Organization associated with specific route group.

Returns:

generator of instances

Return type:

wxc_sdk.common.IdAndName

async usage_route_lists(rg_id: str, org_id: str | None = None, **params) List[UsageRouteLists][source]

List Route Lists for a specific route group. Route Lists are a list of numbers that can be reached via a Route Group. It can be used to provide cloud PSTN connectivity to Webex Calling Dedicated Instance.

Retrieving this list of Route Lists requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • rg_id – Route group requested for information.

  • org_id – Organization associated with specific route group.

Returns:

generator of instances

Return type:

wxc_sdk.common.IdAndName

base = 'telephony/config/premisePstn/routeGroups'
class wxc_sdk.as_api.AsRouteListApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

API for everything route lists

list_gen(name: list[str] | None = None, location_id: list[str] | None = None, order: str | None = None, org_id: str | None = None, **params) AsyncGenerator[RouteList, None, None][source]

List all Route Lists for the organization.

A Route List is a list of numbers that can be reached via a Route Group. It can be used to provide cloud PSTN connectivity to Webex Calling Dedicated Instance.

Retrieving the Route List requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • name (str) – Return the list of Route List matching the route list name.

  • location_id (str) – Return the list of Route Lists matching the location id.

  • order (str) – Order the Route List according to the designated fields.Available sort fields: name, locationId. Sort order is ascending by default

  • org_id (str) – List all Route List for this organization.

Returns:

generator yielding RouteList instances

async list(name: list[str] | None = None, location_id: list[str] | None = None, order: str | None = None, org_id: str | None = None, **params) List[RouteList][source]

List all Route Lists for the organization.

A Route List is a list of numbers that can be reached via a Route Group. It can be used to provide cloud PSTN connectivity to Webex Calling Dedicated Instance.

Retrieving the Route List requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • name (str) – Return the list of Route List matching the route list name.

  • location_id (str) – Return the list of Route Lists matching the location id.

  • order (str) – Order the Route List according to the designated fields.Available sort fields: name, locationId. Sort order is ascending by default

  • org_id (str) – List all Route List for this organization.

Returns:

generator yielding RouteList instances

async create(name: str, location_id: str, rg_id: str, org_id: str | None = None) str[source]

Create a Route List for the organization.

A Route List is a list of numbers that can be reached via a Route Group. It can be used to provide cloud PSTN connectivity to Webex Calling Dedicated Instance.

Creating a Route List requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • name (str) – Name of the Route List

  • location_id (str) – Location associated with the Route List.

  • rg_id (str) – UUID of the route group associated with Route List.

  • org_id (str) – Organization to which Route List belongs.

Returns:

ID of the newly route list created.

Return type:

str

async details(rl_id: str, org_id: str | None = None) RouteListDetail[source]

Get Route List Details.

A Route List is a list of numbers that can be reached via a Route Group. It can be used to provide cloud PSTN connectivity to Webex Calling Dedicated Instance.

Retrieving a Route List requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • rl_id (str) – ID of the Route List.

  • org_id (str) – Organization to which Route List belongs.

Returns:

route list details

Return type:

RouteListDetail

async update(rl_id: str, name: str, rg_id: str, org_id: str | None = None)[source]

Modify the details for a Route List.

A Route List is a list of numbers that can be reached via a Route Group. It can be used to provide cloud PSTN connectivity to Webex Calling Dedicated Instance.

Retrieving a Route List requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • rl_id (str) – ID of the Route List.

  • name (str) – Route List new name.

  • rg_id (str) – New route group id.

  • org_id (str) – Organization to which Route List belongs.

async delete_route_list(rl_id: str, org_id: str | None = None)[source]

Delete Route List for a Customer

A Route List is a list of numbers that can be reached via a Route Group. It can be used to provide cloud PSTN connectivity to Webex Calling Dedicated Instance.

Deleting a Route List requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • rl_id (str) – ID of the Route List.

  • org_id (str) – Organization to which Route List belongs.

numbers_gen(rl_id: str, order: str | None = None, number: str | None = None, org_id: str | None = None, **params) AsyncGenerator[str, None, None][source]

Get numbers assigned to a Route List

A Route List is a list of numbers that can be reached via a Route Group. It can be used to provide cloud PSTN connectivity to Webex Calling Dedicated Instance.

Retrieving a Route List requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • rl_id (str) – ID of the Route List.

  • order (str) – Order the Route Lists according to number.

  • number (str) – Number assigned to the route list.

  • org_id (str) – Organization to which Route List belongs.

Returns:

generator yielding str

async numbers(rl_id: str, order: str | None = None, number: str | None = None, org_id: str | None = None, **params) List[str][source]

Get numbers assigned to a Route List

A Route List is a list of numbers that can be reached via a Route Group. It can be used to provide cloud PSTN connectivity to Webex Calling Dedicated Instance.

Retrieving a Route List requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • rl_id (str) – ID of the Route List.

  • order (str) – Order the Route Lists according to number.

  • number (str) – Number assigned to the route list.

  • org_id (str) – Organization to which Route List belongs.

Returns:

generator yielding str

async update_numbers(rl_id: str, numbers: List[NumberAndAction], org_id: str | None = None) List[UpdateNumbersResponse][source]

Modify numbers for a specific Route List of a Customer.

A Route List is a list of numbers that can be reached via a Route Group. It can be used to provide cloud PSTN connectivity to Webex Calling Dedicated Instance.

Retrieving a Route List requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • rl_id (str) – ID of the Route List.

  • numbers (list[NumberAndAction]) – Array of the numbers to be deleted/added.

  • org_id (str) – Organization to which Route List belongs.

Returns:

list of update number status

Return type:

list[UpdateNumbersResponse]

async delete_all_numbers(rl_id: str, org_id: str | None = None)[source]
base = 'telephony/config/premisePstn/routeLists'
class wxc_sdk.as_api.AsSCIM2BulkApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsScimApiChild

Bulk Manage SCIM 2 Users and Groups

The bulk API allows you to create, update, and remove multiple users and groups in Webex. The number of Bulk operations in a single request is limited to 100.

Bulk deletion of Users is irreversible. Please test in a test org or sandbox before running the command in your production system.

async bulk_request(org_id: str, fail_on_errors: int, operations: list[BulkOperation]) BulkResponse[source]

User bulk API

Authorization

OAuth token rendered by Identity Broker.

One of the following OAuth scopes is required:

  • identity:people_rw

  • Identity:SCIM

Usage:

  1. The input JSON must conform to the following schema: ‘urn:ietf:params:scim:api:messages:2.0:BulkRequest’.

  2. The request must be accompanied with a body in JSON format according to the standard SCIM schema definition. The maximum number of operations in a request is 100; an error is thrown if the limit is exceeded.

  3. failOnErrors parameter

    An integer specifies the number of errors that the service provider will accept before the operation is terminated and an error response is returned. It is OPTIONAL in a request. Maximum number of operations allowed to fail before the server stops processing the request. The value must be between 1 and 100.

  4. operations parameter

    Contains a list of bulk operations for POST/PATCH/DELETE operations. (REQUIRED)

    • operations.method

      The HTTP method of the current operation. Possible values are POST, PATCH or DELETE.

    • `operations.path

      The Resource’s relative path. If the method is POST the value must specify a Resource type endpoint; e.g., /Users or /Groups whereas all other method values must specify the path to a specific Resource; e.g., /Users/2819c223-7f76-453a-919d-413861904646.

    • operations.data

      The Resource data as it would appear for a single POST or PATCH Resource operation. It is REQUIRED in a request when method is POST and PATCH. Refer to corresponding wiki for SCIM 2.0 POST, PATCH and DELETE API.

    • operations.bulkId

      The transient identifier of a newly created resource, unique within a bulk request and created by the client. The bulkId serves as a surrogate resource id enabling clients to uniquely identify newly created resources in the response and cross-reference new resources in and across operations within a bulk request. It is REQUIRED when “method” is “POST”.

Parameters:
  • org_id (str) – Webex Identity assigned organization identifier for user’s organization.

  • fail_on_errors (int) – An integer specifying the maximum number of errors that the service provider will accept before the operation is terminated and an error response is returned.

  • operations (list[BulkOperation]) – Contains a list of bulk operations for POST/PATCH/DELETE operations.

Return type:

BulkResponse

Example

# bulk operations to create a bunch of users from a list of ScimUser instances
new_scim_users: list[ScimUser]
operations = [BulkOperation(method=BulkMethod.post, path='/Users',
                            bulk_id=str(uuid.uuid4()),
                            data=scim_user.create_update())
              for scim_user in new_scim_users]
bulk_response = self.api.scim.bulk.bulk_request(org_id=org_id, fail_on_errors=1,
                                                operations=operations)
base = 'identity/scim'
class wxc_sdk.as_api.AsSCIM2UsersApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsScimApiChild

SCIM 2 Users

Implementation of the SCIM 2.0 user part for user management in a standards based manner. Please also see the SCIM Specification. The schema and API design follows the standard SCIM 2.0 definition with detailed in SCIM 2.0 schema and SCIM 2.0 Protocol

async create(org_id: str, user: ScimUser) ScimUser[source]

Create a user

The SCIM 2 /Users API provides a programmatic way to manage users in Webex Identity using The Internet Engineering Task Force standard SCIM 2.0 standard as specified by RFC 7643 SCIM 2.0 Core Schema and RFC 7644 SCIM 2.0 Core Protocol. The WebEx SCIM 2.0 APIs allow clients supporting the SCIM 2.0 standard to manage users, and groups within Webex. Webex supports the following SCIM 2.0 Schemas:

Authorization

OAuth token rendered by Identity Broker.

One of the following OAuth scopes is required:

  • identity:people_rw

  • Identity:SCIM

The following administrators can use this API:

  • id_full_admin

  • id_user_admin

Usage:

  1. Input JSON must contain schema: “urn:ietf:params:scim:schemas:core:2.0:User”.

1. Support 3 schemas : - “urn:ietf:params:scim:schemas:core:2.0:User” - “urn:ietf:params:scim:schemas:extension:enterprise:2.0:User” - “urn:scim:schemas:extension:cisco:webexidentity:2.0:User

  1. Unrecognized schemas (ID/section) are ignored.

  1. Read-only attributes provided as input values are ignored.

Parameters:
  • org_id (str) – Webex Identity assigned organization identifier for user’s organization.

  • user (ScimUser) – User settings

Return type:

ScimUser

async details(org_id: str, user_id: str) ScimUser[source]

Get a user

Authorization

OAuth token rendered by Identity Broker.

One of the following OAuth scopes is required:

  • identity:people_rw

  • identity:people_read

  • Identity:SCIM

  • Identity:SCIM_read

The following administrators can use this API:

  • id_full_admin

  • id_user_admin

  • id_readonly_admin

  • id_device_admin

Parameters:
  • org_id (str) – Webex Identity assigned organization identifier for user’s organization.

  • user_id (str) – Webex Identity assigned user identifier.

Return type:

ScimUser

async search(org_id: str, filter: str | None = None, attributes: str | None = None, excluded_attributes: str | None = None, sort_by: str | None = None, sort_order: str | None = None, start_index: int | None = None, count: int | None = None, return_groups: bool | None = None, include_group_details: bool | None = None, group_usage_types: str | None = None) SearchUserResponse[source]

Search users

Authorization

OAuth token rendered by Identity Broker.

One of the following OAuth scopes is required:

  • identity:people_rw

  • identity:people_read

  • Identity:SCIM

  • Identity:SCIM_read

The following administrators can use this API:

  • id_full_admin

  • id_user_admin

  • id_readonly_admin

  • id_device_admin

Parameters:
  • org_id (str) – Webex Identity assigned organization identifier for user’s organization.

  • filter (str) –

    The url encoded filter. If the value is empty, the API will return all users under the organization.

    The examples below show some search filters:

  • attributes (str) – A multi-valued list of strings indicating the names of resource attributes to return in the response, like ‘userName,department,emails’. It supports the SCIM id ‘urn:ietf:params:scim:schemas:extension:enterprise:2.0:User,userName’. The default is empty, all attributes will be returned

  • excluded_attributes (str) – A multi-valued list of strings indicating the names of resource attributes to be removed from the default set of attributes to return. The default is empty, all attributes will be returned

  • sort_by (str) – A string indicating the attribute whose value be used to order the returned responses. Now we only allow ‘userName, id, meta.lastModified’ to sort.

  • sort_order (str) – A string indicating the order in which the ‘sortBy’ parameter is applied. Allowed values are ‘ascending’ and ‘descending’.

  • start_index (int) – An integer indicating the 1-based index of the first query result. The default is 1.

  • count (int) – An integer indicating the desired maximum number of query results per page. The default is 100.

  • return_groups (str) – Define whether the group information needs to be returned. The default is false.

  • include_group_details (str) – Define whether the group information with details need been returned. The default is false.

  • group_usage_types (str) – Returns groups with details of the specified group type

Return type:

SearchUserResponse

async search_all_gen(org_id: str, filter: str | None = None, attributes: str | None = None, excluded_attributes: str | None = None, sort_by: str | None = None, sort_order: str | None = None, count: int | None = None, return_groups: str | None = None, include_group_details: str | None = None, group_usage_types: str | None = None) AsyncGenerator[ScimUser, None, None][source]
async search_all(org_id: str, filter: str | None = None, attributes: str | None = None, excluded_attributes: str | None = None, sort_by: str | None = None, sort_order: str | None = None, count: int | None = None, return_groups: str | None = None, include_group_details: str | None = None, group_usage_types: str | None = None) AsyncGenerator[ScimUser, None, None][source]
async update(org_id: str, user: ScimUser) ScimUser[source]

Update a user with PUT

Authorization

OAuth token rendered by Identity Broker.

One of the following OAuth scopes is required:

  • identity:people_rw

  • Identity:SCIM

The following administrators can use this API:

  • id_full_admin

  • id_user_admin

Usage:

  1. Input JSON must contain schema: “urn:ietf:params:scim:schemas:core:2.0:User”.

  2. Support 3 schemas:

  1. Unrecognized schemas (ID/section) are ignored.

  2. Read-only attributes provided as input values are ignored.

  3. User id will not be changed.

  4. meta.`created` will not be changed.

7. The PUT API replaces the contents of the user’s data with the data in the request body. All attributes specified in the request body will replace all existing attributes for the userId specified in the URL. Should you wish to replace or change some attributes as opposed to all attributes please refer to the SCIM PATCH operation https://developer.webex.com/docs/api/v1/scim2-user/update-a-user-with-patch .

Parameters:
  • org_id (str) – Webex Identity assigned organization identifier for user’s organization.

  • user – user to be updates

Return type:

ScimUser

async patch(org_id: str, user_id: str, operations: list[PatchUserOperation]) ScimUser[source]

Update a user with PATCH

Authorization

OAuth token rendered by Identity Broker.

One of the following OAuth scopes is required:

  • identity:people_rw

  • Identity:SCIM

The following administrators can use this API:

  • id_full_admin

  • id_user_admin

Usage:

1. The PATCH API replaces individual attributes of the user’s data in the request body. The PATCH api supports add, remove and replace operations on any individual attribute allowing only specific attributes of the user’s object to be modified.

  1. Each operation against an attribute must be compatible with the attribute’s mutability.

3. Each PATCH operation represents a single action to be applied to the same SCIM resource specified by the request URI. Operations are applied sequentially in the order they appear in the array. Each operation in the sequence is applied to the target resource; the resulting resource becomes the target of the next operation. Evaluation continues until all operations are successfully applied or until an error condition is encountered.

Add operations:

The add operation is used to add a new attribute value to an existing resource. The operation must contain a value member whose content specifies the value to be added. The value may be a quoted value, or it may be a JSON object containing the sub-attributes of the complex attribute specified in the operation’s path. The result of the add operation depends upon the target location indicated by path references:

  • If omitted, the target location is assumed to be the resource itself. The value parameter contains a set of attributes to be added to the resource.

  • If the target location does not exist, the attribute and value are added.

  • If the target location specifies a complex attribute, a set of sub-attributes shall be specified in the value parameter.

  • If the target location specifies a multi-valued attribute, a new value is added to the attribute.

  • If the target location specifies a single-valued attribute, the existing value is replaced.

  • If the target location specifies an attribute that does not exist (has no value), the attribute is added with the new value.

  • If the target location exists, the value is replaced.

  • If the target location already contains the value specified, no changes should be made to the resource.

Replace operations:

The replace operation replaces the value at the target location specified by the path. The operation performs the following functions, depending on the target location specified by path:

  • If the path parameter is omitted, the target is assumed to be the resource itself. In this case, the value attribute shall contain a list of one or more attributes that are to be replaced.

  • If the target location is a single-value attribute, the value of the attribute is replaced.

  • If the target location is a multi-valued attribute and no filter is specified, the attribute and all values are replaced.

  • If the target location path specifies an attribute that does not exist, the service provider shall treat the operation as an “add”.

  • If the target location specifies a complex attribute, a set of sub-attributes SHALL be specified in the value parameter, which replaces any existing values or adds where an attribute did not previously exist. Sub-attributes that are not specified in the value parameters are left unchanged.

  • If the target location is a multi-valued attribute and a value selection (“valuePath”) filter is specified that matches one or more values of the multi-valued attribute, then all matching record values will be replaced.

  • If the target location is a complex multi-valued attribute with a value selection filter (“valuePath”) and a specific sub-attribute (e.g., “addresses[type eq “work”].streetAddress”), the matching sub-attribute of all matching records is replaced.

  • If the target location is a multi-valued attribute for which a value selection filter (“valuePath”) has been supplied and no record match was made, the service provider will indicate the failure by returning HTTP status code 400 and a scimType error code of “noTarget”.

Remove operations:

The remove operation removes the value at the target location specified by the required attribute path. The operation performs the following functions, depending on the target location specified by path:

  • If path is unspecified, the operation fails with HTTP status code 400 and a “scimType” error code of “noTarget”.

  • If the target location is a single-value attribute, the attribute and its associated value is removed, and the attribute will be considered unassigned.

  • If the target location is a multi-valued attribute and no filter is specified, the attribute and all values are removed, and the attribute SHALL be considered unassigned.

  • If the target location is a multi-valued attribute and a complex filter is specified comparing a value, the values matched by the filter are removed. If no other values remain after the removal of the selected values, the multi-valued attribute will be considered unassigned.

  • If the target location is a complex multi-valued attribute and a complex filter is specified based on the attribute’s sub-attributes, the matching records are removed. Sub-attributes whose values have been removed will be considered unassigned. If the complex multi-valued attribute has no remaining records, the attribute will be considered unassigned.

Parameters:
  • org_id (str) – Webex Identity assigned organization identifier for user’s organization.

  • user_id (str) – Webex Identity assigned user identifier.

  • operations (list[PatchUserOperation]) – A list of patch operations.

Return type:

ScimUser

async delete(org_id: str, user_id: str)[source]

Delete a user

Authorization

OAuth token rendered by Identity Broker.

One of the following OAuth scopes is required:

  • identity:people_rw

  • Identity:SCIM

The following administrators can use this API:

  • id_full_admin

  • id_user_admin

Parameters:
  • org_id (str) – Webex Identity assigned organization identifier for user’s organization.

  • user_id (str) – Webex Identity assigned user identifier.

Return type:

None

base = 'identity/scim'
class wxc_sdk.as_api.AsScheduleApi(*, session: AsRestSession, base: ScheduleApiBase)[source]

Bases: AsApiChild

Schedules API

list_gen(obj_id: str, org_id: str | None = None, schedule_type: ScheduleType | None = None, name: str | None = None, **params) AsyncGenerator[Schedule, None, None][source]

List of Schedules for a Person or location

List schedules for a person or location in an organization.

Schedules are used to support calling features and can be defined at the location or person level. businessHours schedules allow you to apply specific call settings at different times of the day or week by defining one or more events. holidays schedules define exceptions to normal business hours by defining one or more events.

This API requires a full, user, or read-only administrator auth token with a scope of spark-admin:people_read.

Parameters:
  • obj_id (str) – Return the list of schedules for this location or user

  • org_id (str) – List schedules for this organization.

  • schedule_type – Type of the schedule. businessHours - Business hours schedule type. holidays - Holidays schedule type.

  • name – Only return schedules with the matching name.

Returns:

yields schedules

async list(obj_id: str, org_id: str | None = None, schedule_type: ScheduleType | None = None, name: str | None = None, **params) List[Schedule][source]

List of Schedules for a Person or location

List schedules for a person or location in an organization.

Schedules are used to support calling features and can be defined at the location or person level. businessHours schedules allow you to apply specific call settings at different times of the day or week by defining one or more events. holidays schedules define exceptions to normal business hours by defining one or more events.

This API requires a full, user, or read-only administrator auth token with a scope of spark-admin:people_read.

Parameters:
  • obj_id (str) – Return the list of schedules for this location or user

  • org_id (str) – List schedules for this organization.

  • schedule_type – Type of the schedule. businessHours - Business hours schedule type. holidays - Holidays schedule type.

  • name – Only return schedules with the matching name.

Returns:

yields schedules

async details(obj_id: str, schedule_type: str | ScheduleType, schedule_id: str, org_id: str | None = None) Schedule[source]

Get Details for a Schedule

Retrieve Schedule details.

A time schedule establishes a set of times during the day or holidays in the year in which a feature, for example auto attendants, can perform a specific action.

Retrieving schedule details requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • obj_id (str) – Retrieve schedule details in this location or user

  • schedule_type (ScheduleTypeOrStr) – Type of the schedule. businessHours - Business hours schedule type. holidays - Holidays schedule type.

  • schedule_id (str) – Retrieve the schedule with the matching ID.

  • org_id (str) – Retrieve schedule details from this organization.

Returns:

async create(obj_id: str, schedule: Schedule, org_id: str | None = None) str[source]

Create a Schedule

Create new Schedule for the given location.

A time schedule establishes a set of times during the day or holidays in the year in which a feature, for example auto attendants, can perform a specific action.

Creating a schedule requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • obj_id (str) – Create the schedule for this location or user

  • schedule (Schedule) – Schedule to be created

  • org_id (str) – Create the schedule for this organization.

Returns:

ID of the newly created schedule.

Return type:

str

async update(obj_id: str, schedule: Schedule, schedule_type: str | ScheduleType | None = None, schedule_id: str | None = None, org_id: str | None = None) str[source]

Update a Schedule

Update the designated Schedule.

A time schedule establishes a set of times during the day or holidays in the year in which a feature, for example auto attendants, can perform a specific action.

Updating a schedule requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

NOTE: The Schedule ID will change upon modification of the Schedule name

Parameters:
  • obj_id (str) – Location or user for which this schedule exists

  • schedule (Schedule) – data for the update

  • schedule_type (ScheduleTypeOrStr) – Type of the schedule. Default: schedule_type from schedule businessHours - Business hours schedule type. holidays - Holidays schedule type.

  • schedule_id (str) – Update schedule with the matching ID. Default: schedule_id from schedule

  • org_id (str) – Update schedule from this organization.

Returns:

schedule id

async delete_schedule(obj_id: str, schedule_type: str | ScheduleType, schedule_id: str, org_id: str | None = None)[source]

Delete a Schedule

Delete the designated Schedule.

A time schedule establishes a set of times during the day or holidays in the year in which a feature, for example auto attendants, can perform a specific action.

Deleting a schedule requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • obj_id (str) – Location or user from which to delete a schedule.

  • schedule_type (ScheduleTypeOrStr) – Type of the schedule. businessHours - Business hours schedule type. holidays - Holidays schedule type.

  • schedule_id (str) – Delete the schedule with the matching ID.

  • org_id (str) – Retrieve schedule details from this organization.

Returns:

async event_details(obj_id: str, schedule_type: str | ScheduleType, schedule_id: str, event_id: str, org_id: str | None = None) Event[source]

Get Details for a Schedule Event

Retrieve Schedule Event details.

A time schedule establishes a set of times during the day or holidays in the year in which a feature, for example auto attendants, can perform a specific action.

Retrieving schedule event details requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • obj_id (str) – Retrieve schedule event details for this location or user

  • schedule_type (ScheduleTypeOrStr) – Type of the schedule. businessHours - Business hours schedule type. holidays - Holidays schedule type.

  • schedule_id (str) – Retrieve schedule event details for schedule with the matching ID.

  • event_id (str) – Retrieve the schedule event with the matching schedule event ID.

  • org_id (str) – Retrieve schedule event details from this organization.

Returns:

async event_create(obj_id: str, schedule_type: str | ScheduleType, schedule_id: str, event: Event, org_id: str | None = None) str[source]

Create a Schedule Event

Create new Event for the given location or user Schedule.

A time schedule establishes a set of times during the day or holidays in the year in which a feature, for example auto attendants, can perform a specific action.

Creating a schedule event requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • obj_id (str) – Create the schedule for this location.

  • schedule_type (ScheduleTypeOrStr) – Type of the schedule. businessHours - Business hours schedule type. holidays - Holidays schedule type.

  • schedule_id (str) – Create event for a given schedule ID.

  • event (Event) – event data

  • org_id (str) – Retrieve schedule event details from this organization.

Returns:

event id

Return type:

str

async event_update(obj_id: str, schedule_type: str | ScheduleType, schedule_id: str, event: Event, event_id: str | None = None, org_id: str | None = None) str[source]

Update a Schedule Event

Update the designated Schedule Event.

A time schedule establishes a set of times during the day or holidays in the year in which a feature, for example auto attendants, can perform a specific action.

Updating a schedule event requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

NOTE: The Schedule Event ID will change upon modification of the Schedule event name.

Parameters:
  • obj_id (str) – Location or user for which this schedule event exists.

  • schedule_type (ScheduleTypeOrStr) – Type of the schedule. businessHours - Business hours schedule type. holidays - Holidays schedule type.

  • schedule_id (str) – Update schedule event with the matching schedule ID.

  • event (Event) – update settings

  • event_id (str) – Update the schedule event with the matching schedule event ID. Default: event id from event

  • org_id (str) – Update schedule from this organization.

Returns:

event id; changed if name changed

async event_delete(obj_id: str, schedule_type: str | ScheduleType, schedule_id: str, event_id: str, org_id: str | None = None)[source]

Delete a Schedule Event

Delete the designated Schedule Event.

A time schedule establishes a set of times during the day or holidays in the year in which a feature, for example auto attendants, can perform a specific action.

Deleting a schedule event requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • obj_id (str) – Location or user from which to delete a schedule.

  • schedule_type (ScheduleTypeOrStr) – Type of the schedule. businessHours - Business hours schedule type. holidays - Holidays schedule type.

  • schedule_id (str) – Delete schedule event with the matching schedule ID.

  • event_id (str) – Delete the schedule event with the matching schedule event ID. Default: event id from event

  • org_id (str) – Delete schedule from this organization.

base = 'telephony/config/locations'
class wxc_sdk.as_api.AsScimApiChild(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

base = 'identity/scim'
class wxc_sdk.as_api.AsScimV2Api(*, session: wxc_sdk.as_rest.AsRestSession)[source]

Bases: AsApiChild

users: AsSCIM2UsersApi
bulk: AsSCIM2BulkApi
base = ''
class wxc_sdk.as_api.AsStatusAPI(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Webex Status API as described at https://status.webex.com/api

async summary() StatusSummary[source]

Get a summary of the status page, including a status indicator, component statuses, unresolved incidents, and any upcoming or in-progress scheduled maintenances.

Returns:

Status summary

Return type:

StatusSummary

async status() str[source]

Get the status rollup for the whole page. This response includes an indicator - one of green (operational), yellow (under_maintenance/degraded_performance/partial_outage), red (major_outage).

Returns:

Webex status

Return type:

str

async components() list[Component][source]

Get the components for the status page. Each component is listed along with its status - one of operational, under_maintenance,degraded_performance, partial_outage, or major_outage.

Returns:

list of components

Return type:

list[Component]

async unresolved_incidents() list[Incident][source]

Get a list of any unresolved incidents. This response will only return incidents in the Investigating, Identified, or Monitoring state.

Returns:

list of incidents

Return type:

list[Incident]

async all_incidents() list[Incident][source]

Get a list of the 50 most recent incidents. This includes all unresolved incidents as described above, as well as those in the Resolved state.

Returns:

list of incidents

Return type:

list[Incident]

async upcoming_scheduled_maintenances() list[Incident][source]

Scheduled maintenances are planned outages, upgrades, or general notices that you’re working on infrastructure and disruptions may occurr. A close sibling of Incidents, each usually goes through a progression of statuses listed below, with an impact calculated from a blend of component statuses (or an optional override).

Status: Scheduled, In Progress, or Completed

Impact: Maintenance

Returns:

list of incidents

Return type:

list[Incident]

async active_scheduled_maintenances() list[Incident][source]

Get a list of any active maintenances. This response will only return scheduled maintenances in the In Progress state.

Returns:

list of incidents

Return type:

list[Incident]

async all_scheduled_maintenances() list[Incident][source]

Get a list of the 50 most recent scheduled maintenances. This includes scheduled maintenances in Scheduled , In Progress or Completed state.

Returns:

list of incidents

Return type:

list[Incident]

base = 'status'
class wxc_sdk.as_api.AsTeamMembershipsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Team Memberships represent a person’s relationship to a team. Use this API to list members of any team that you’re in or create memberships to invite someone to a team. Team memberships can also be updated to make someone a moderator or deleted to remove them from the team. Just like in the Webex app, you must be a member of the team in order to list its memberships or invite people.

list_gen(team_id: str, **params) AsyncGenerator[TeamMembership, None, None][source]

Lists all team memberships for a given team, specified by the teamId query parameter. Use query parameters to filter the response.

Parameters:

team_id (str) – List memberships for a team, by ID.

async list(team_id: str, **params) List[TeamMembership][source]

Lists all team memberships for a given team, specified by the teamId query parameter. Use query parameters to filter the response.

Parameters:

team_id (str) – List memberships for a team, by ID.

async create(team_id: str, person_id: str | None = None, person_email: str | None = None, is_moderator: bool | None = None) TeamMembership[source]

Add someone to a team by Person ID or email address, optionally making them a moderator.

Parameters:
  • team_id (str) – The team ID.

  • person_id (str) – The person ID.

  • person_email (str) – The email address of the person.

  • is_moderator (bool) – Whether or not the participant is a team moderator.

async details(membership_id: str) TeamMembership[source]

Shows details for a team membership, by ID. Specify the team membership ID in the membershipId URI parameter.

Parameters:

membership_id (str) – The unique identifier for the team membership.

async membership(membership_id: str, is_moderator: bool) TeamMembership[source]

Updates a team membership, by ID. Specify the team membership ID in the membershipId URI parameter.

Parameters:
  • membership_id (str) – The unique identifier for the team membership.

  • is_moderator (bool) – Whether or not the participant is a team moderator.

async delete(membership_id: str)[source]

Deletes a team membership, by ID. Specify the team membership ID in the membershipId URI parameter. The team membership for the last moderator of a team may not be deleted; promote another user to team moderator first.

Parameters:

membership_id (str) – The unique identifier for the team membership.

base = 'team/memberships'
class wxc_sdk.as_api.AsTeamsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Teams are groups of people with a set of rooms that are visible to all members of that team. This API is used to manage the teams themselves. Teams are created and deleted with this API. You can also update a team to change its name, for example. To manage people in a team see the Team Memberships API. To manage team rooms see the Rooms API.

list_gen() AsyncGenerator[Team, None, None][source]

Lists teams to which the authenticated user belongs.

async list() List[Team][source]

Lists teams to which the authenticated user belongs.

async create(name: str) Team[source]

Creates a team. The authenticated user is automatically added as a member of the team. See the Team Memberships API to learn how to add more people to the team.

Parameters:

name (str) – A user-friendly name for the team.

async details(team_id: str) Team[source]

Shows details for a team, by ID. Specify the team ID in the teamId parameter in the URI.

Parameters:

team_id (str) – The unique identifier for the team.

async update(team_id: str, name: str) Team[source]

Updates details for a team, by ID. Specify the team ID in the teamId parameter in the URI.

Parameters:
  • team_id (str) – The unique identifier for the team.

  • name (str) – A user-friendly name for the team.

async delete(team_id: str)[source]

Deletes a team, by ID. Specify the team ID in the teamId parameter in the URI.

Parameters:

team_id (str) – The unique identifier for the team.

base = 'teams'
class wxc_sdk.as_api.AsTelephonyApi(session: AsRestSession)[source]

Bases: AsApiChild

The telephony settings (features) API.

access_codes: AsLocationAccessCodesApi

access or authentication codes at location level

announcements_repo: AsAnnouncementsRepositoryApi
auto_attendant: AsAutoAttendantApi
call_intercept: AsLocationInterceptApi

location call intercept settings

call_recording: AsCallRecordingSettingsApi
calls: AsCallsApi
callpark: AsCallParkApi
callpark_extension: AsCallparkExtensionApi
callqueue: AsCallQueueApi
dect_devices: AsDECTDevicesApi
devices: AsTelephonyDevicesApi

WxC device operations

huntgroup: AsHuntGroupApi
jobs: AsJobsApi
location: AsTelephonyLocationApi

location specific settings

locations: AsTelephonyLocationApi
organisation_voicemail: AsOrganisationVoicemailSettingsAPI

organisation voicemail settings

paging: AsPagingApi
permissions_out: AsOutgoingPermissionsApi
pickup: AsCallPickupApi
pnc: AsPrivateNetworkConnectApi
prem_pstn: AsPremisePstnApi
schedules: AsScheduleApi
virtual_lines: AsVirtualLinesApi
voicemail_groups: AsVoicemailGroupsApi
voicemail_rules: AsVoicemailRulesApi
voice_messaging: AsVoiceMessagingApi
voiceportal: AsVoicePortalApi
phone_numbers_gen(location_id: str | None = None, phone_number: str | None = None, available: bool | None = None, order: str | None = None, owner_name: str | None = None, owner_id: str | None = None, owner_type: OwnerType | None = None, extension: str | None = None, number_type: NumberType | None = None, phone_number_type: NumberListPhoneNumberType | None = None, state: NumberState | None = None, details: bool | None = None, toll_free_numbers: bool | None = None, restricted_non_geo_numbers: bool | None = None, included_telephony_type: TelephonyType | None = None, org_id: str | None = None, **params) AsyncGenerator[NumberListPhoneNumber, None, None][source]

Get Phone Numbers for an Organization with given criteria.

List all the phone numbers for the given organization along with the status and owner (if any).

PSTN phone numbers are associated with a specific location and can be active/inactive and assigned/unassigned. The owner is the person, workspace, or feature to which the number is assigned. Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Return the list of phone numbers for this location within the given organization.

  • phone_number (str) – Search for this phone number.

  • available (bool) – Search among the available phone numbers. This parameter cannot be used along with owner_type parameter when set to true.

  • order (str) – Sort the list of phone numbers based on the following:lastName,dn,extension. Default sort will be based on number and extension in an Ascending order

  • owner_name (str) – Return the list of phone numbers that is owned by given owner name. Maximum length is 255.

  • owner_id (str) – Returns only the matched number/extension entries assigned to the feature with specified uuid/broadsoftId.

  • owner_type (OwnerType) – Returns the list of phone numbers that are of given owner_type.

  • extension (str) – Returns the list of PSTN phone numbers with given extension.

  • number_type (NumberType) – Returns the filtered list of PSTN phone numbers that contains given type of numbers. This parameter cannot be used along with available or state.

  • phone_number_type (NumberListPhoneNumberType) – Returns the filtered list of PSTN phone numbers that are of given phoneNumberType.

  • state (NumberState) – Returns the list of PSTN phone numbers with matching state.

  • details (bool) – Returns the overall count of the PSTN phone numbers along with other details for given organization.

  • toll_free_numbers (bool) – Returns the list of toll free phone numbers.

  • restricted_non_geo_numbers (bool) – Returns the list of restricted non geographical numbers.

  • included_telephony_type (TelephonyType) – Returns the list of phone numbers that are of given includedTelephonyType. By default if this query parameter is not provided, it will list both PSTN and Mobile Numbers. Possible input values are PSTN_NUMBER, MOBILE_NUMBER.

  • org_id (str) – List numbers for this organization.

Returns:

yields NumberListPhoneNumber instances

async phone_numbers(location_id: str | None = None, phone_number: str | None = None, available: bool | None = None, order: str | None = None, owner_name: str | None = None, owner_id: str | None = None, owner_type: OwnerType | None = None, extension: str | None = None, number_type: NumberType | None = None, phone_number_type: NumberListPhoneNumberType | None = None, state: NumberState | None = None, details: bool | None = None, toll_free_numbers: bool | None = None, restricted_non_geo_numbers: bool | None = None, included_telephony_type: TelephonyType | None = None, org_id: str | None = None, **params) List[NumberListPhoneNumber][source]

Get Phone Numbers for an Organization with given criteria.

List all the phone numbers for the given organization along with the status and owner (if any).

PSTN phone numbers are associated with a specific location and can be active/inactive and assigned/unassigned. The owner is the person, workspace, or feature to which the number is assigned. Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Return the list of phone numbers for this location within the given organization.

  • phone_number (str) – Search for this phone number.

  • available (bool) – Search among the available phone numbers. This parameter cannot be used along with owner_type parameter when set to true.

  • order (str) – Sort the list of phone numbers based on the following:lastName,dn,extension. Default sort will be based on number and extension in an Ascending order

  • owner_name (str) – Return the list of phone numbers that is owned by given owner name. Maximum length is 255.

  • owner_id (str) – Returns only the matched number/extension entries assigned to the feature with specified uuid/broadsoftId.

  • owner_type (OwnerType) – Returns the list of phone numbers that are of given owner_type.

  • extension (str) – Returns the list of PSTN phone numbers with given extension.

  • number_type (NumberType) – Returns the filtered list of PSTN phone numbers that contains given type of numbers. This parameter cannot be used along with available or state.

  • phone_number_type (NumberListPhoneNumberType) – Returns the filtered list of PSTN phone numbers that are of given phoneNumberType.

  • state (NumberState) – Returns the list of PSTN phone numbers with matching state.

  • details (bool) – Returns the overall count of the PSTN phone numbers along with other details for given organization.

  • toll_free_numbers (bool) – Returns the list of toll free phone numbers.

  • restricted_non_geo_numbers (bool) – Returns the list of restricted non geographical numbers.

  • included_telephony_type (TelephonyType) – Returns the list of phone numbers that are of given includedTelephonyType. By default if this query parameter is not provided, it will list both PSTN and Mobile Numbers. Possible input values are PSTN_NUMBER, MOBILE_NUMBER.

  • org_id (str) – List numbers for this organization.

Returns:

yields NumberListPhoneNumber instances

base = 'telephony/config'
async phone_number_details(org_id: str | None = None) NumberDetails[source]

get summary (counts) of phone numbers

Parameters:

org_id (str) – detaild for numbers in this organization.

Returns:

phone number details

Return type:

NumberDetails

async validate_extensions(extensions: list[str]) ValidateExtensionsResponse[source]

Validate the List of Extensions

Validate the List of Extensions. Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:

extensions (list[str]) – Array of Strings of ID of Extensions.

Returns:

validation response

Return type:

wxc_sdk.common.ValidateExtensionsResponse

async validate_phone_numbers(phone_numbers: list[str], org_id: str | None = None) ValidatePhoneNumbersResponse[source]

Validate the list of phone numbers in an organization. Each phone number’s availability is indicated in the response.

Each location has a set of phone numbers that can be assigned to people, workspaces, or features. Phone numbers must follow E.164 format for all countries, except for the United States, which can also follow the National format. Active phone numbers are in service.

Validating a phone number in an organization requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • phone_numbers (list[str]) – List of phone numbers to be validated.

  • org_id (str) – Organization of the Route Group.

Returns:

validation result

Return type:

wxc_sdk.common.ValidatePhoneNumbersResponse

async ucm_profiles(org_id: str | None = None) list[UCMProfile][source]

Read the List of UC Manager Profiles

List all calling UC Manager Profiles for the organization.

UC Manager Profiles are applicable if your organization uses Jabber in Team Messaging mode or Calling in Webex Teams (Unified CM).

The UC Manager Profile has an organization-wide default and may be overridden for individual persons, although currently only setting at a user level is supported by Webex APIs.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:people_read as this API is designed to be used in conjunction with calling behavior at the user level.

Parameters:

org_id (str) – List manager profiles in this organization.

Returns:

list of UCMProfile

route_choices_gen(route_group_name: str | None = None, trunk_name: str | None = None, order: str | None = None, org_id: str | None = None) AsyncGenerator[RouteIdentity, None, None][source]

List all Routes for the organization.

Trunk and Route Group qualify as Route. Trunks and Route Groups provide you the ability to configure Webex Calling to manage calls between Webex Calling hosted users and premises PBX(s) users. This solution lets you configure users to use Cloud PSTN (CCP or Cisco PSTN) or Premises-based PSTN.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • route_group_name – Return the list of route identities matching the route group name.

  • trunk_name – Return the list of route identities matching the trunk name.

  • order – Order the route identities according to the designated fields. Available sort fields: routeName, routeType.

  • org_id – List route identities for this organization.

Returns:

async route_choices(route_group_name: str | None = None, trunk_name: str | None = None, order: str | None = None, org_id: str | None = None) List[RouteIdentity][source]

List all Routes for the organization.

Trunk and Route Group qualify as Route. Trunks and Route Groups provide you the ability to configure Webex Calling to manage calls between Webex Calling hosted users and premises PBX(s) users. This solution lets you configure users to use Cloud PSTN (CCP or Cisco PSTN) or Premises-based PSTN.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • route_group_name – Return the list of route identities matching the route group name.

  • trunk_name – Return the list of route identities matching the trunk name.

  • order – Order the route identities according to the designated fields. Available sort fields: routeName, routeType.

  • org_id – List route identities for this organization.

Returns:

async test_call_routing(originator_id: str, originator_type: OriginatorType, destination: str, originator_number: str | None = None, org_id: str | None = None) TestCallRoutingResult[source]

Validates that an incoming call can be routed.

Dial plans route calls to on-premises destinations by use of trunks or route groups. They are configured globally for an enterprise and apply to all users, regardless of location. A dial plan also specifies the routing choice (trunk or route group) for calls that match any of its dial patterns. Specific dial patterns can be defined as part of your dial plan.

Test call routing requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • originator_id (str) – This element is used to identify the originating party. It can be a person ID or a trunk ID.

  • originator_type (OriginatorType) – This element is used to identify if the originatorId is of type PEOPLE or TRUNK.

  • destination (str) – This element specifies called party. It can be any dialable string, for example, an ESN number, E.164 number, hosted user DN, extension, extension with location code, URL, FAC code.

  • originator_number (str) – Only used when originatorType is TRUNK. The originatorNumber can be a phone number or URI.

  • org_id (str) – Organization in which we are validating a call routing.

Returns:

call routing test result

Return type:

TestCallRoutingResult

async supported_devices(org_id: str | None = None) SupportedDevices[source]

Gets the list of supported devices for an organization location.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:

org_id – List supported devices for an organization

Returns:

List of supported devices

async device_settings(org_id: str | None = None) DeviceCustomization[source]

Get device override settings for an organization.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:

org_id (str) – List supported devices for an organization location.

Returns:

device customization response

Return type:

DeviceCustomization

async read_list_of_announcement_languages() list[AnnouncementLanguage][source]

List all languages supported by Webex Calling for announcements and voice prompts. Retrieving announcement languages requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

documentation: https://developer.webex.com/docs/api/v1/webex-calling-organization-settings/read-the-list-of -announcement-languages

class wxc_sdk.as_api.AsTelephonyDevicesApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Telephony devices API

async details(device_id: str, org_id: str | None = None) TelephonyDeviceDetails[source]

Get Webex Calling Device Details

Retrieves Webex Calling device details that include information needed for third-party device management.

Webex calling devices are associated with a specific user Workspace or Virtual Line.

Webex Calling devices share the location with the entity that owns them.

This API requires a full, location, user, or read-only admin auth token with the scope of spark-admin:telephony_config_read.

Parameters:
  • device_id (str) – Unique identifier for the device.

  • org_id (str) – ID of the organization in which the device resides.

Return type:

TelephonyDeviceDetails

async members(device_id: str, org_id: str | None = None) DeviceMembersResponse[source]

Get Device Members

Get the list of all the members of the device including primary and secondary users.

A device member can be either a person or a workspace. An admin can access the list of member details, modify member details and search for available members on a device.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • device_id (str) – Unique identifier for the device.

  • org_id (str) – Retrieves the list of all members of the device in this Organization.

Returns:

Device model, line count, and members

Return type:

DeviceMembersResponse

async update_members(device_id: str, members: list[DeviceMember | AvailableMember] | None, org_id: str | None = None)[source]

Modify member details on the device.

A device member can be either a person or a workspace. An admin can access the list of member details, modify member details and search for available members on a device.

Modifying members on the device requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • device_id (str) – Unique identifier for the device.

  • members (list[Union[DeviceMember, AvailableMember]) – New member details for the device. If the member’s list is missing then all the users are removed except the primary user.

  • org_id (str) – Modify members on the device in this organization.

available_members_gen(device_id: str, location_id: str | None = None, member_name: str | None = None, phone_number: str | None = None, extension: str | None = None, org_id: str | None = None, **params) AsyncGenerator[AvailableMember, None, None][source]

Search members that can be assigned to the device.

A device member can be either a person or a workspace. A admin can access the list of member details, modify member details and search for available members on a device.

This requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • device_id (str) – Unique identifier for the device.

  • location_id (str) – Search (Contains) based on number.

  • member_name (str) – Search (Contains) numbers based on member name.

  • phone_number (str) – Search (Contains) based on number.

  • extension (str) – Search (Contains) based on extension.

  • org_id (str) – Retrieves the list of available members on the device in this Organization.

Returns:

list of available members

async available_members(device_id: str, location_id: str | None = None, member_name: str | None = None, phone_number: str | None = None, extension: str | None = None, org_id: str | None = None, **params) List[AvailableMember][source]

Search members that can be assigned to the device.

A device member can be either a person or a workspace. A admin can access the list of member details, modify member details and search for available members on a device.

This requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • device_id (str) – Unique identifier for the device.

  • location_id (str) – Search (Contains) based on number.

  • member_name (str) – Search (Contains) numbers based on member name.

  • phone_number (str) – Search (Contains) based on number.

  • extension (str) – Search (Contains) based on extension.

  • org_id (str) – Retrieves the list of available members on the device in this Organization.

Returns:

list of available members

async apply_changes(device_id: str, org_id: str | None = None)[source]

Apply Changes for a specific device

Issues request to the device to download and apply changes to the configuration.

Applying changes for a specific device requires a full administrator auth token with a scope of spark-admin:telephony_config_write. :param device_id: Unique identifier for the device. :type device_id: str :param org_id: Apply changes for a device in this Organization. :type org_id: str

async device_settings(device_id: str, device_model: str, org_id: str | None = None) DeviceCustomization[source]

Get override settings for a device.

Device settings lists all the applicable settings for an MPP and an ATA devices at the device level. An admin can also modify the settings. DECT devices do not support settings at the device level.

This requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • device_id (str) – Unique identifier for the device.

  • device_model (str) – Model type of the device.

  • org_id (str) – Settings on the device in this organization.

Returns:

Device settings

Return type:

DeviceCustomization

async update_device_settings(device_id: str, device_model: str, customization: DeviceCustomization, org_id: str | None = None)[source]

Modify override settings for a device.

Device settings list all the applicable settings for an MPP and an ATA devices at the device level. Admins can also modify the settings. NOTE: DECT devices do not support settings at the device level.

Updating settings on the device requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • device_id (str) – Unique identifier for the device.

  • device_model (str) – Device model name.

  • customization (DeviceCustomization) – Indicates the customization object of the device settings.

  • org_id (str) – Organization in which the device resides..

Example :

# target_device is a TelephonyDevice object
target_device: TelephonyDevice

# get device level settings
settings = api.telephony.devices.device_settings(device_id=target_device.device_id,
                                                 device_model=target_device.model)

# update settings (display name format) and enable device level customization
settings.customizations.mpp.display_name_format = DisplayNameSelection.person_last_then_first_name
settings.custom_enabled = True

# update the device level settings
api.telephony.devices.update_device_settings(device_id=target_device.device_id,
                                             device_model=target_device.model,
                                             customization=settings)

# apply changes to device
api.telephony.devices.apply_changes(device_id=target_device.device_id)
async dect_devices(org_id: str | None = None) list[DectDevice][source]

Read the DECT device type list

Get DECT device type list with base stations and line ports supported count. This is a static list.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:

org_id

Returns:

async validate_macs(macs: list[str], org_id: str | None = None) MACValidationResponse[source]

Validate a list of MAC addresses.

Validating this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • macs (list[str]) – MAC addresses to be validated.

  • org_id (str) – Validate the mac address(es) for this organization.

Returns:

validation response

Return type:

MACValidationResponse

async create_line_key_template(template: LineKeyTemplate, org_id: str | None = None) str[source]

Create a Line Key Template

Create a Line Key Template in this organization.

Line Keys also known as Programmable Line Keys (PLK) are the keys found on either sides of a typical desk phone display. A Line Key Template is a definition of actions that will be performed by each of the Line Keys for a particular device model. This API allows customers to create a Line Key Template for a device model.

Creating a Line Key Template requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • template (LineKeyTemplate) – Line key template to create

  • org_id (str) – id of organization to create the line key template in

Returns:

id of new line key template

Return type:

str

async list_line_key_templates(org_id: str | None = None) list[LineKeyTemplate][source]

Read the list of Line Key Templates

List all Line Key Templates available for this organization.

Line Keys also known as Programmable Line Keys (PLK) are the keys found on either sides of a typical desk phone display. A Line Key Template is a definition of actions that will be performed by each of the Line Keys for a particular device model. This API allows users to retrieve the list of Line Key Templates that are available for the organization.

Retrieving this list requires a full, user or read-only administrator or location administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:

org_id (str) – List line key templates for this organization.

Return type:

list[LineKeyTemplate]

async line_key_template_details(template_id: str, org_id: str | None = None) LineKeyTemplate[source]

Get details of a Line Key Template

Get detailed information about a Line Key Template by template ID in an organization.

Line Keys also known as Programmable Line Keys (PLK) are the keys found on either sides of a typical desk phone display. A Line Key Template is a definition of actions that will be performed by each of the Line Keys for a particular device model. This API allows users to retrieve a line key template by its ID in an organization.

Retrieving a line key template requires a full, user or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • template_id (str) – Get line key template for this template ID.

  • org_id (str) – Retrieve a line key template for this organization.

Return type:

GetLineKeyTemplateResponse

async modify_line_key_template(template: LineKeyTemplate, org_id: str | None = None)[source]

Modify a Line Key Template

Modify a line key template by its template ID in an organization.

Line Keys also known as Programmable Line Keys (PLK) are the keys found on either sides of a typical desk phone display. A Line Key Template is a definition of actions that will be performed by each of the Line Keys for a particular device model. This API allows users to modify an existing Line Key Template by its ID in an organization.

Modifying an existing line key template requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • template (LineKeyTemplate) – new line key template settings

  • org_id (str) – Modify a line key template for this organization.

async delete_line_key_template(template_id: str, org_id: str | None = None)[source]

Delete a Line Key Template

Delete a Line Key Template by its template ID in an organization.

Line Keys also known as Programmable Line Keys (PLK) are the keys found on either sides of a typical desk phone display. A Line Key Template is a definition of actions that will be performed by each of the Line Keys for a particular device model. This API allows users to delete an existing Line Key Templates by its ID in an organization.

Deleting an existing line key template requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • template_id (str) – Delete line key template with this template ID.

  • org_id (str) – Delete a line key template for this organization.

Return type:

None

async preview_apply_line_key_template(action: ApplyLineKeyTemplateAction, template_id: str | None = None, location_ids: list[str] | None = None, exclude_devices_with_custom_layout: bool | None = None, include_device_tags: list[str] | None = None, exclude_device_tags: list[str] | None = None, more_shared_appearances_enabled: bool | None = None, few_shared_appearances_enabled: bool | None = None, more_monitor_appearances_enabled: bool | None = None, org_id: str | None = None) int[source]

Preview Apply Line Key Template

Preview the number of devices that will be affected by the application of a Line Key Template or when resetting devices to their factory Line Key settings.

Line Keys also known as Programmable Line Keys (PLK) are the keys found on either sides of a typical desk phone display. A Line Key Template is a definition of actions that will be performed by each of the Line Keys for a particular device model. This API allows users to preview the number of devices that will be affected if a customer were to apply a Line Key Template or apply factory default Line Key settings to devices.

Retrieving the number of devices affected requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • action (ApplyLineKeyTemplateAction) – Line key Template action to perform.

  • template_id (str) – templateId is required for APPLY_TEMPLATE action.

  • location_ids (list[str]) – Used to search for devices only in the given locations.

  • exclude_devices_with_custom_layout (bool) – Indicates whether to exclude devices with custom layout.

  • include_device_tags (list[str]) – Include devices only with these tags.

  • exclude_device_tags (list[str]) – Exclude devices with these tags.

  • more_shared_appearances_enabled (bool) – Refine search by warnings for More shared appearances than shared users.

  • few_shared_appearances_enabled (bool) – Refine search by warnings for Fewer shared appearances than shared users.

  • more_monitor_appearances_enabled (bool) – Refine search by warnings for more monitor appearances than monitors.

  • org_id (str) – Preview Line Key Template for this organization.

Return type:

int

async get_device_layout(device_id: str, org_id: str | None = None) DeviceLayout[source]

Get Device Layout by Device ID

Get layout information of a device by device ID in an organization.

Device layout customizes a user’s programmable line keys (PLK) on the phone and any attached Key Expansion Modules (KEM) with the existing configured line members and the user’s monitoring list.

This API requires a full or location administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • device_id (str) – Get device layout for this device ID.

  • org_id (str) – Retrieve a device layout for the device in this organization.

Return type:

DeviceLayout

async modify_device_layout(device_id: str, layout: DeviceLayout, org_id: str | None = None)[source]

Modify Device Layout by Device ID

Modify the layout of a device by device ID in an organization.

Device layout customizes a user’s programmable line keys (PLK) on the phone and any attached Key Expansion Modules (KEM) with the existing configured line members and the user’s monitoring list.

This API requires a full or location administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • device_id (str) – Modify device layout for this device ID.

  • layout – New layout

  • org_id (str) – Modify a device layout for the device in this organization.

Return type:

None

async get_person_device_settings(person_id: str, org_id: str | None = None) DeviceSettings[source]

Get Device Settings for a Person

Device settings list the compression settings for a person.

Device settings customize a device’s behavior and performance. The compression field optimizes call quality for inbound and outbound calls.

This API requires a full, location, user, or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • person_id (str) – ID of the person to retrieve device settings.

  • org_id (str) – Retrieves the device settings for a person in this organization.

Return type:

Compression

async update_person_device_settings(person_id: str, settings: DeviceSettings, org_id: str | None = None)[source]

Update Device Settings for a Person

Update device settings modifies the compression settings for a person.

Device settings customize a device’s behavior and performance. The compression field optimizes call quality for inbound and outbound calls.

This API requires a full, location, or user administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • person_id (str) – ID of the person to update device settings.

  • settings (DeviceSettings) – New device settings

  • org_id (str) – Modify device settings for a person in this organization.

Return type:

None

async get_workspace_device_settings(workspace_id: str, org_id: str | None = None) DeviceSettings[source]

Get Device Settings for a Workspace

Device settings list the compression settings for a workspace.

Device settings customize a device’s behavior and performance. The compression field optimizes call quality for inbound and outbound calls.

This API requires a full, location, user, or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • workspace_id (str) – ID of the workspace for which to retrieve device settings.

  • org_id (str) – Retrieves the device settings for a workspace in this organization.

Return type:

Compression

async update_workspace_device_settings(workspace_id: str, settings: DeviceSettings, org_id: str | None = None)[source]

Update Device Settings for a Workspace

Update device settings modifies the compression settings for a workspace.

Device settings customize a device’s behavior and performance. The compression field optimizes call quality for inbound and outbound calls.

This API requires a full, location, or user administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • workspace_id (str) – ID of the workspace for which to update device settings.

  • settings (DeviceSettings) – New device settings

  • org_id (str) – Modify the device settings for a workspace in this organization.

Return type:

None

base = 'telephony/config'
class wxc_sdk.as_api.AsTelephonyLocationApi(session: AsRestSession)[source]

Bases: AsApiChild

intercept: AsLocationInterceptApi

call intercept settings

internal_dialing: AsInternalDialingApi

internal dialing settings

moh: AsLocationMoHApi

moh settings

number: AsLocationNumbersApi

number settings

voicemail: AsLocationVoicemailSettingsApi

Location VM settings (only enable/disable transcription for now)

receptionist_contacts_directory: AsReceptionistContactsDirectoryApi

Receptionist contacts directories

async generate_password(location_id: str, generate: list[str] | None = None, org_id: str | None = None)[source]

Generates an example password using the effective password settings for the location. If you don’t specify anything in the generate field or don’t provide a request body, then you will receive a SIP password by default.

It’s used while creating a trunk and shouldn’t be used anywhere else.

Generating an example password requires a full or write-only administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Location for which example password has to be generated.

  • generate (list[str]) – password settings array.

  • org_id (str) – Organization to which location belongs.

Returns:

new password

Return type:

str

async validate_extensions(location_id: str, extensions: list[str], org_id: str | None = None) ValidateExtensionsResponse[source]

Validate extensions for a specific location.

Validating extensions requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Validate extensions for this location.

  • extensions (list[str]) – Array of extensions that will be validated.

  • org_id (str) – Validate extensions for this organization.

Returns:

Validation result

Return type:

wxc_sdk.common.ValidateExtensionsResponse

async details(location_id: str, org_id: str | None = None) TelephonyLocation[source]

Shows Webex Calling details for a location, by ID.

Specify the location ID in the locationId parameter in the URI.

Searching and viewing location in your organization requires an administrator auth token with the spark-admin:telephony_config_read scope.

Parameters:
  • location_id (str) – Retrieve Webex Calling location attributes for this location.

  • org_id (str) – Retrieve Webex Calling location attributes for this organization.

Returns:

Webex Calling details for location

Return type:

TelephonyLocation

async enable_for_calling(location: Location, org_id: str | None = None) str[source]

Enable a location by adding it to Webex Calling. This add Webex Calling support to a location created using the POST /v1/locations API.

Locations are used to support calling features which can be defined at the location level.

This API requires a full administrator auth token with a scope of spark-admin:telephony_config_write. :return: A unique identifier for the location. :rtype: str

list_gen(name: str | None = None, order: str | None = None, org_id: str | None = None) AsyncGenerator[TelephonyLocation, None, None][source]

Lists Webex Calling locations for an organization with Webex Calling details.

Searching and viewing locations with Webex Calling details in your organization require an administrator auth token with the spark-admin:telephony_config_read scope. :param name: List locations whose name contains this string. :type name: str :param order: Sort the list of locations based on name, either asc or desc. :type order: str :param org_id: List locations for this organization. :type org_id: str :return: generator of TelephonyLocation instances

async list(name: str | None = None, order: str | None = None, org_id: str | None = None) List[TelephonyLocation][source]

Lists Webex Calling locations for an organization with Webex Calling details.

Searching and viewing locations with Webex Calling details in your organization require an administrator auth token with the spark-admin:telephony_config_read scope. :param name: List locations whose name contains this string. :type name: str :param order: Sort the list of locations based on name, either asc or desc. :type order: str :param org_id: List locations for this organization. :type org_id: str :return: generator of TelephonyLocation instances

async update(location_id: str, settings: TelephonyLocation, org_id: str | None = None)[source]

Update Webex Calling details for a location, by ID.

Specify the location ID in the locationId parameter in the URI.

Modifying the connection via API is only supported for the local PSTN types of TRUNK and ROUTE_GROUP.

Updating a location in your organization requires an administrator auth token with the spark-admin:telephony_config_write scope.

Example :

api.telephony.location.update(location_id=location_id,
                              settings=TelephonyLocation(
                                  calling_line_id=CallingLineId(
                                      phone_number=tn),
                                  routing_prefix=routing_prefix,
                                  outside_dial_digit='9'))
Parameters:
  • location_id (str) – Updating Webex Calling location attributes for this location.

  • settings (TelephonyLocation) – settings to update

  • org_id (str) – Updating Webex Calling location attributes for this organization.

Returns:

async change_announcement_language(location_id: str, language_code: str, agent_enabled: bool | None = None, service_enabled: bool | None = None, org_id: str | None = None)[source]

Change Announcement Language

Change announcement language for the given location.

Change announcement language for current people/workspaces and/or existing feature configurations. This does not change the default announcement language which is applied to new users/workspaces and new feature configurations.

Changing announcement language for the given location requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Change announcement language for this location.

  • language_code (str) – Language code.

  • agent_enabled (bool) – Set to true to change announcement language for existing people and workspaces.

  • service_enabled (bool) – Set to true to change announcement language for existing feature configurations.

  • org_id (str) – Change announcement language for this organization.

async device_settings(location_id: str, org_id: str | None = None) DeviceCustomization[source]

Get device override settings for a location.

This requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Unique identifier for the location

  • org_id (str) – Settings on the device in this organization

Returns:

device customization response

Return type:

DeviceCustomization

base = 'telephony/config/locations'
class wxc_sdk.as_api.AsTransferNumbersApi(*, session: AsRestSession, selector: ApiSelector = ApiSelector.person)[source]

Bases: AsPersonSettingsApiChild

API for outgoing permission auto transfer numbers

feature = 'outgoingPermission/autoTransferNumbers'
async read(entity_id: str, org_id: str | None = None) AutoTransferNumbers[source]

Retrieve Transfer Numbers Settings .

When calling a specific call type, this entity will be automatically transferred to another number. The person assigned the Auto Transfer Number can then approve the call and send it through or reject the call type. You can add up to 3 numbers.

This API requires a full or read-only administrator auth token with a scope of spark-admin:workspaces_read or a user auth token with spark:workspaces_read scope can be used to read entity settings.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • org_id (str) – entity is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

Returns:

auto transfer numbers

Return type:

AutoTransferNumbers

async configure(entity_id: str, settings: AutoTransferNumbers, org_id: str | None = None)[source]

Modify Transfer Numbers Settings for a Place.

When calling a specific call type, this entity will be automatically transferred to another number. The person assigned the Auto Transfer Number can then approve the call and send it through or reject the call type. You can add up to 3 numbers.

This API requires a full or user administrator auth token with the spark-admin:workspaces_write scope or a user auth token with spark:workspaces_write scope can be used to update entity settings.

Parameters:
  • entity_id (str) – Unique identifier for the entity.

  • settings (AutoTransferNumbers) – new auto transfer numbers

  • org_id (str) – entity is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

base = ''
class wxc_sdk.as_api.AsTrunkApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

API for everything trunks

list_gen(name: str | None = None, location_name: str | None = None, trunk_type: str | None = None, order: str | None = None, org_id: str | None = None, **params) AsyncGenerator[Trunk, None, None][source]

List all Trunks for the organization.

A Trunk is a connection between Webex Calling and the premises, which terminates on the premises with a local gateway or other supported device. The trunk can be assigned to a Route Group - a group of trunks that allow ebex Calling to distribute calls over multiple trunks or to provide redundancy.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • name (str) – Return the list of trunks matching the local gateway names.

  • location_name (str) – Return the list of trunks matching the location names.

  • trunk_type (str) – Return the list of trunks matching the trunk type.

  • order (str) – Order the trunks according to the designated fields. Available sort fields: name, locationName. Sort order is ascending by default

  • org_id (str)

Returns:

generator of Trunk instances

Return type:

Trunk

async list(name: str | None = None, location_name: str | None = None, trunk_type: str | None = None, order: str | None = None, org_id: str | None = None, **params) List[Trunk][source]

List all Trunks for the organization.

A Trunk is a connection between Webex Calling and the premises, which terminates on the premises with a local gateway or other supported device. The trunk can be assigned to a Route Group - a group of trunks that allow ebex Calling to distribute calls over multiple trunks or to provide redundancy.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • name (str) – Return the list of trunks matching the local gateway names.

  • location_name (str) – Return the list of trunks matching the location names.

  • trunk_type (str) – Return the list of trunks matching the trunk type.

  • order (str) – Order the trunks according to the designated fields. Available sort fields: name, locationName. Sort order is ascending by default

  • org_id (str)

Returns:

generator of Trunk instances

Return type:

Trunk

async create(name: str, location_id: str, password: str, trunk_type: ~wxc_sdk.telephony.prem_pstn.trunk.TrunkType = <TrunkType.registering: 'REGISTERING'>, dual_identity_support_enabled: bool | None = None, device_type: ~wxc_sdk.telephony.prem_pstn.trunk.TrunkDeviceType | None = None, address: str | None = None, domain: str | None = None, port: int | None = None, max_concurrent_calls: int | None = None, org_id: str | None = None) str[source]

Create a Trunk for the organization.

A Trunk is a connection between Webex Calling and the premises, which terminates on the premises with a local gateway or other supported device. The trunk can be assigned to a Route Group - a group of trunks that allow Webex Calling to distribute calls over multiple trunks or to provide redundancy.

Creating a trunk requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • name (str) – A unique name for the trunk.

  • location_id (str) – ID of location associated with the trunk.

  • password (str) – A password to use on the trunk.

  • trunk_type (TrunkType) – Trunk Type associated with the trunk.

  • dual_identity_support_enabled (bool) – Dual Identity Support setting impacts the handling of the From header and P-Asserted-Identity header when sending an initial SIP INVITE to the trunk for an outbound call.

  • device_type (TrunkDeviceType) – Device type associated with trunk.

  • address (str) – FQDN or SRV address. Required to create a static certificate-based trunk.

  • domain (str) – Domain name. Required to create a static certificate based trunk.

  • port (int) – FQDN port. Required to create a static certificate-based trunk.

  • max_concurrent_calls (int) – Max Concurrent call. Required to create a static certificate based trunk.

  • org_id (str) – Organization to which trunk belongs.

Returns:

id of new trunk

Return type:

str

async details(trunk_id: str, org_id: str | None = None) TrunkDetail[source]

Get a Trunk for the organization.

A Trunk is a connection between Webex Calling and the premises, which terminates on the premises with a local gateway or other supported device. The trunk can be assigned to a Route Group - a group of trunks that allow Webex Calling to distribute calls over multiple trunks or to provide redundancy.

Retrieving a trunk requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • trunk_id (str) – ID of the trunk.

  • org_id (str) – Organization to which trunk belongs.

Returns:

trunk details

Return type:

TrunkDetail

async update(trunk_id: str, name: str, location_id: str, password: str, trunk_type: TrunkType, dual_identity_support_enabled: bool | None = None, max_concurrent_calls: int | None = None, org_id: str | None = None)[source]

Modify a Trunk for the organization.

A Trunk is a connection between Webex Calling and the premises, which terminates on the premises with a local gateway or other supported device. The trunk can be assigned to a Route Group - a group of trunks that allow Webex Calling to distribute calls over multiple trunks or to provide redundancy.

Modifying a trunk requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • trunk_id

  • location_id (str) – ID of location associated with the trunk.

  • password (str) – A password to use on the trunk.

  • trunk_type (TrunkType) – Trunk Type associated with the trunk.

  • dual_identity_support_enabled (bool) – Dual Identity Support setting impacts the handling of the From header and P-Asserted-Identity header when sending an initial SIP INVITE to the trunk for an outbound call.

  • max_concurrent_calls (int) – Max Concurrent call. Required to create a static certificate based trunk.

  • org_id (str:return:) – Organization to which trunk belongs.

async delete_trunk(trunk_id: str, org_id: str | None = None)[source]

Delete a Trunk for the organization.

A Trunk is a connection between Webex Calling and the premises, which terminates on the premises with a local gateway or other supported device. The trunk can be assigned to a Route Group - a group of trunks that allow Webex Calling to distribute calls over multiple trunks or to provide redundancy.

Deleting a trunk requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • trunk_id (str) – ID of the trunk.

  • org_id (str) – Organization to which trunk belongs.

async trunk_types(org_id: str | None = None) List[TrunkTypeWithDeviceType][source]

List all TrunkTypes with DeviceTypes for the organization.

A Trunk is a connection between Webex Calling and the premises, which terminates on the premises with a local gateway or other supported device. The trunk can be assigned to a Route Group - a group of trunks that allow Webex Calling to distribute calls over multiple trunks or to provide redundancy. Trunk Types are Registering or Certificate Based and are configured in CallManager.

Retrieving trunk types requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:

org_id

Returns:

trunk types

Return type:

list[TrunkTypeWithDeviceType]

async usage(trunk_id: str, org_id: str | None = None) TrunkUsage[source]

Get Local Gateway Usage Count

A trunk is a connection between Webex Calling and the premises, which terminates on the premises with a local gateway or other supported device. The trunk can be assigned to a Route Group - a group of trunks that allow Webex Calling to distribute calls over multiple trunks or to provide redundancy.

Retrieving this information requires a full administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • trunk_id (str) – ID of the trunk.

  • org_id (str) – Organization to which trunk belongs.

Returns:

usage counts

Return type:

TrunkUsage

usage_dial_plan_gen(trunk_id: str, org_id: str | None = None) AsyncGenerator[IdAndName, None, None][source]

Get Local Gateway Dial Plan Usage for a Trunk.

A Trunk is a connection between Webex Calling and the premises, which terminates on the premises with a local gateway or other supported device. The trunk can be assigned to a Route Group - a group of trunks that allow Webex Calling to distribute calls over multiple trunks or to provide redundancy.

Retrieving this information requires a full administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • trunk_id (str) – ID of the trunk.

  • org_id (str) – Organization to which trunk belongs.

Returns:

id and name objects

async usage_dial_plan(trunk_id: str, org_id: str | None = None) List[IdAndName][source]

Get Local Gateway Dial Plan Usage for a Trunk.

A Trunk is a connection between Webex Calling and the premises, which terminates on the premises with a local gateway or other supported device. The trunk can be assigned to a Route Group - a group of trunks that allow Webex Calling to distribute calls over multiple trunks or to provide redundancy.

Retrieving this information requires a full administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • trunk_id (str) – ID of the trunk.

  • org_id (str) – Organization to which trunk belongs.

Returns:

id and name objects

usage_location_pstn_gen(trunk_id: str, org_id: str | None = None) AsyncGenerator[IdAndName, None, None][source]

Get Local Gateway Dial Plan Usage for a Trunk.

A Trunk is a connection between Webex Calling and the premises, which terminates on the premises with a local gateway or other supported device. The trunk can be assigned to a Route Group - a group of trunks that allow Webex Calling to distribute calls over multiple trunks or to provide redundancy.

Retrieving this information requires a full administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • trunk_id (str) – ID of the trunk.

  • org_id (str) – Organization to which trunk belongs.

Returns:

id and name objects

async usage_location_pstn(trunk_id: str, org_id: str | None = None) List[IdAndName][source]

Get Local Gateway Dial Plan Usage for a Trunk.

A Trunk is a connection between Webex Calling and the premises, which terminates on the premises with a local gateway or other supported device. The trunk can be assigned to a Route Group - a group of trunks that allow Webex Calling to distribute calls over multiple trunks or to provide redundancy.

Retrieving this information requires a full administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • trunk_id (str) – ID of the trunk.

  • org_id (str) – Organization to which trunk belongs.

Returns:

id and name objects

usage_route_group_gen(trunk_id: str, org_id: str | None = None) AsyncGenerator[IdAndName, None, None][source]

Get Local Gateway Dial Plan Usage for a Trunk.

A Trunk is a connection between Webex Calling and the premises, which terminates on the premises with a local gateway or other supported device. The trunk can be assigned to a Route Group - a group of trunks that allow Webex Calling to distribute calls over multiple trunks or to provide redundancy.

Retrieving this information requires a full administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • trunk_id (str) – ID of the trunk.

  • org_id (str) – Organization to which trunk belongs.

Returns:

id and name objects

async usage_route_group(trunk_id: str, org_id: str | None = None) List[IdAndName][source]

Get Local Gateway Dial Plan Usage for a Trunk.

A Trunk is a connection between Webex Calling and the premises, which terminates on the premises with a local gateway or other supported device. The trunk can be assigned to a Route Group - a group of trunks that allow Webex Calling to distribute calls over multiple trunks or to provide redundancy.

Retrieving this information requires a full administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • trunk_id (str) – ID of the trunk.

  • org_id (str) – Organization to which trunk belongs.

Returns:

id and name objects

usage_call_to_extension_gen(trunk_id: str, org_id: str | None = None, order: str | None = None, name: List[str] | None = None, **params) AsyncGenerator[IdAndName, None, None][source]

Get local gateway call to on-premises extension usage for a trunk.

A trunk is a connection between Webex Calling and the premises, which terminates on the premises with a local gateway or other supported device. The trunk can be assigned to a Route Group which is a group of trunks that allow Webex Calling to distribute calls over multiple trunks or to provide redundancy.

Retrieving this information requires a full administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • trunk_id – ID of the trunk.

  • org_id – Organization to which the trunk belongs.

  • order – Order the trunks according to the designated fields. Available sort fields are name, and locationName. Sort order is ascending by default

  • name – Return the list of trunks matching the local gateway names

Returns:

generator of wxc_sdk.common.IdAndName instances

async usage_call_to_extension(trunk_id: str, org_id: str | None = None, order: str | None = None, name: List[str] | None = None, **params) List[IdAndName][source]

Get local gateway call to on-premises extension usage for a trunk.

A trunk is a connection between Webex Calling and the premises, which terminates on the premises with a local gateway or other supported device. The trunk can be assigned to a Route Group which is a group of trunks that allow Webex Calling to distribute calls over multiple trunks or to provide redundancy.

Retrieving this information requires a full administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • trunk_id – ID of the trunk.

  • org_id – Organization to which the trunk belongs.

  • order – Order the trunks according to the designated fields. Available sort fields are name, and locationName. Sort order is ascending by default

  • name – Return the list of trunks matching the local gateway names

Returns:

generator of wxc_sdk.common.IdAndName instances

async validate_fqdn_and_domain(address: str, domain: str, port: int | None = None, org_id: str | None = None)[source]

Validate Local Gateway FQDN and Domain for the organization trunks.

A Trunk is a connection between Webex Calling and the premises, which terminates on the premises with a local gateway or other supported device. The trunk can be assigned to a Route Group - a group of trunks that allow Webex Calling to distribute calls over multiple trunks or to provide redundancy.

Validating Local Gateway FQDN and Domain requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • address (str) – FQDN or SRV address of the trunk.

  • domain (str) – Domain name of the trunk.

  • port (int) – FQDN port of the trunk

  • org_id (str) – Organization to which trunk types belongs.

base = 'telephony/config/premisePstn/trunks'
class wxc_sdk.as_api.AsVirtualLinesApi(session)[source]

Bases: AsApiChild

call_bridge: AsCallBridgeApi

Call bridge settings

call_intercept: AsCallInterceptApi

call intercept settings

call_recording: AsCallRecordingApi

call recording settings

call_waiting: AsCallWaitingApi

call waiting settings

caller_id: AsCallerIdApi

caller id settings

forwarding: AsPersonForwardingApi

forwarding settings

permissions_in: AsIncomingPermissionsApi

incoming permissions

permissions_out: AsOutgoingPermissionsApi

outgoing permissions

async create(first_name: str, last_name: str, location_id: str, display_name: str | None = None, phone_number: str | None = None, extension: str | None = None, caller_id_last_name: str | None = None, caller_id_first_name: str | None = None, caller_id_number: str | None = None, org_id: str | None = None) str[source]

Create a Virtual Line

Create new Virtual Line for the given location.

Virtual line is a capability in Webex Calling that allows administrators to configure multiple lines to Webex Calling users.

Creating a virtual line requires a full or user administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • first_name (str) – First name defined for a virtual line. Minimum length is 1. Maximum length is 30.

  • last_name (str) – Last name defined for a virtual line. Minimum length is 1. Maximum length is 30.

  • location_id (str) – ID of location for virtual line.

  • display_name (str) – Display name defined for a virtual line.

  • phone_number (str) – Phone number of a virtual line. Minimum length is 1. Maximum length is 23. Either phoneNumber or extension is mandatory.

  • extension (str) – Extension of a virtual line. Minimum length is 2. Maximum length is 10. Either phoneNumber or extension is mandatory.

  • caller_id_last_name (str) – Last name used in the Calling Line ID and for dial-by-name functions. Minimum length is 1. Maximum length is 30.

  • caller_id_first_name (str) – First name used in the Calling Line ID and for dial-by-name functions. Minimum length is 1. Maximum length is 30.

  • caller_id_number (str) – Phone number to appear as the CLID for all calls. Minimum length is 1. Maximum length is 23.

  • org_id (str) – Create the virtual line for this organization.

Return type:

str

async delete(virtual_line_id: str, org_id: str | None = None)[source]

Delete a Virtual Line

Delete the designated Virtual Line.

Virtual line is a capability in Webex Calling that allows administrators to configure multiple lines to Webex Calling users.

Deleting a virtual line requires a full or user administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • virtual_line_id (str) – Delete the virtual line with the matching ID.

  • org_id (str) – Delete the virtual line from this organization.

Return type:

None

async details(virtual_line_id: str, org_id: str | None = None) VirtualLine[source]

Get Details for a Virtual Line

Retrieve Virtual Line details.

Virtual line is a capability in Webex Calling that allows administrators to configure multiple lines to Webex Calling users.

Retrieving virtual line details requires a full or user or read-only administrator or location administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • virtual_line_id (str) – Retrieve settings for a virtual line with the matching ID.

  • org_id (str) – Retrieve virtual line settings from this organization.

Return type:

GetVirtualLineObject

async update(virtual_line_id: str, first_name: str | None = None, last_name: str | None = None, display_name: str | None = None, phone_number: str | None = None, extension: str | None = None, announcement_language: str | None = None, caller_id_last_name: str | None = None, caller_id_first_name: str | None = None, caller_id_number: str | None = None, time_zone: str | None = None, org_id: str | None = None)[source]

Update a Virtual Line

Update the designated Virtual Line.

Virtual line is a capability in Webex Calling that allows administrators to configure multiple lines to Webex Calling users.

Updating a virtual line requires a full or user or location administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • virtual_line_id (str) – Update settings for a virtual line with the matching ID.

  • first_name (str) – First name defined for a virtual line. Minimum length is 1. Maximum length is 30.

  • last_name (str) – Last name defined for a virtual line. Minimum length is 1. Maximum length is 30.

  • display_name (str) – Display name defined for a virtual line.

  • phone_number (str) – Phone number of a virtual line. Minimum length is 1. Maximum length is 23. Either phoneNumber or extension is mandatory.

  • extension (str) – Extension of a virtual line. Minimum length is 2. Maximum length is 10. Either phoneNumber or extension is mandatory.

  • announcement_language (str) – Virtual Line’s announcement language.

  • caller_id_last_name (str) – Last name used in the Calling Line ID and for dial-by-name functions. Minimum length is 1. Maximum length is 30.

  • caller_id_first_name (str) – First name used in the Calling Line ID and for dial-by-name functions. Minimum length is 1. Maximum length is 30.

  • caller_id_number (str) – Phone number to appear as the CLID for all calls. Minimum length is 1. Maximum length is 23.

  • time_zone (str) – Time zone defined for the virtual line.

  • org_id (str) – Update virtual line settings from this organization.

Return type:

None

async get_phone_number(virtual_line_id: str, org_id: str | None = None) VirtualLineNumberPhoneNumber[source]

Get Phone Number assigned for a Virtual Line

Get details on the assigned phone number and extension for the virtual line.

Retrieving virtual line phone number details requires a full or user or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • virtual_line_id (str) – Retrieve settings for a virtual line with the matching ID.

  • org_id (str) – Retrieve virtual line settings from this organization.

Return type:

GetVirtualLineNumberObjectPhoneNumber

Update Directory search for a Virtual Line

Update the directory search for a designated Virtual Line.

Virtual line is a capability in Webex Calling that allows administrators to configure multiple lines to Webex Calling users.

Updating Directory search for a virtual line requires a full or user administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • virtual_line_id (str) – Update settings for a virtual line with the matching ID.

  • enabled (bool) – Whether or not the directory search for a virtual line is enabled.

  • org_id (str) – Update virtual line settings from this organization.

Return type:

None

async assigned_devices(virtual_line_id: str, org_id: str | None = None) VirtualLineDevices[source]

Get List of Devices assigned for a Virtual Line

Retrieve Device details assigned for a virtual line.

Virtual line is a capability in Webex Calling that allows administrators to configure multiple lines to Webex Calling users.

Retrieving the assigned device detials for a virtual line requires a full or user or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • virtual_line_id (str) – Retrieve settings for a virtual line with the matching ID.

  • org_id (str) – Retrieve virtual line settings from this organization.

Return type:

VirtualLineDevices

async dect_networks(virtual_line_id: str, org_id: str | None = None) list[AssignedDectNetwork][source]

Get List of Dect Networks Handsets for a Virtual Line

Retrieve DECT Network details assigned for a virtual line.

Virtual line is a capability in Webex Calling that allows administrators to configure multiple lines to Webex Calling users.

Retrieving the assigned device detials for a virtual line requires a full or user or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • virtual_line_id (str) – Retrieve settings for a virtual line with the matching ID.

  • org_id (str) – Retrieve virtual line settings from this organization.

Return type:

list[AssignedDectNetwork]

list_gen(org_id: str | None = None, location_id: list[str] | None = None, id: list[str] | None = None, owner_name: list[str] | None = None, phone_number: list[str] | None = None, location_name: list[str] | None = None, order: list[str] | None = None, has_device_assigned: bool | None = None, has_extension_assigned: bool | None = None, has_dn_assigned: bool | None = None, **params) AsyncGenerator[VirtualLine, None, None][source]

List all Virtual Lines for the organization. Virtual line is a capability in Webex Calling that allows administrators to configure multiple lines to Webex Calling users. Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • org_id (str) – List virtual lines for this organization.

  • location_id (List[str]) – Return the list of virtual lines matching these location ids. Example for multiple values - ?locationId=locId1&locationId=locId2.

  • id (List[str]) – Return the list of virtual lines matching these virtualLineIds.

  • owner_name (List[str]) – Return the list of virtual lines matching these owner names.

  • phone_number (List[str]) – Return the list of virtual lines matching these phone numbers.

  • location_name (List[str]) – Return the list of virtual lines matching the location names.

  • order (List[str]) – Return the list of virtual lines based on the order. Default sort will be in an Ascending order. Maximum 3 orders allowed at a time.

  • has_device_assigned (bool) – If true, includes only virtual lines with devices assigned. When not explicitly specified, the default includes both virtual lines with devices assigned and not assigned.

  • has_extension_assigned (bool) – If true, includes only virtual lines with an extension assigned. When not explicitly specified, the default includes both virtual lines with extension assigned and not assigned.

  • has_dn_assigned (bool) – If true, includes only virtual lines with an assigned directory number, also known as a Dn. When not explicitly specified, the default includes both virtual lines with a Dn assigned and not assigned.

async list(org_id: str | None = None, location_id: list[str] | None = None, id: list[str] | None = None, owner_name: list[str] | None = None, phone_number: list[str] | None = None, location_name: list[str] | None = None, order: list[str] | None = None, has_device_assigned: bool | None = None, has_extension_assigned: bool | None = None, has_dn_assigned: bool | None = None, **params) List[VirtualLine][source]

List all Virtual Lines for the organization. Virtual line is a capability in Webex Calling that allows administrators to configure multiple lines to Webex Calling users. Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • org_id (str) – List virtual lines for this organization.

  • location_id (List[str]) – Return the list of virtual lines matching these location ids. Example for multiple values - ?locationId=locId1&locationId=locId2.

  • id (List[str]) – Return the list of virtual lines matching these virtualLineIds.

  • owner_name (List[str]) – Return the list of virtual lines matching these owner names.

  • phone_number (List[str]) – Return the list of virtual lines matching these phone numbers.

  • location_name (List[str]) – Return the list of virtual lines matching the location names.

  • order (List[str]) – Return the list of virtual lines based on the order. Default sort will be in an Ascending order. Maximum 3 orders allowed at a time.

  • has_device_assigned (bool) – If true, includes only virtual lines with devices assigned. When not explicitly specified, the default includes both virtual lines with devices assigned and not assigned.

  • has_extension_assigned (bool) – If true, includes only virtual lines with an extension assigned. When not explicitly specified, the default includes both virtual lines with extension assigned and not assigned.

  • has_dn_assigned (bool) – If true, includes only virtual lines with an assigned directory number, also known as a Dn. When not explicitly specified, the default includes both virtual lines with a Dn assigned and not assigned.

base = 'telephony/config/virtualLines'
class wxc_sdk.as_api.AsVoiceMessagingApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Voice Messaging APIs provide support for handling voicemail and message waiting indicators in Webex Calling. The APIs are limited to user access (no admin access), and all GET commands require the spark:calls_read scope, while the other commands require the spark:calls_write scope.

async summary() MessageSummary[source]

Get a summary of the voicemail messages for the user.

list_gen(**params) AsyncGenerator[VoiceMessageDetails, None, None][source]

Get the list of all voicemail messages for the user.

async list(**params) List[VoiceMessageDetails][source]

Get the list of all voicemail messages for the user.

async delete(message_id: str)[source]

Delete a specfic voicemail message for the user.

Parameters:

message_id (str) – The message identifer of the voicemail message to delete

async mark_as_read(message_id: str)[source]

Update the voicemail message(s) as read for the user. If the messageId is provided, then only mark that message as read. Otherwise, all messages for the user are marked as read.

Parameters:

message_id (str) – The voicemail message identifier of the message to mark as read. If the messageId is not provided, then all voicemail messages for the user are marked as read.

async mark_as_unread(message_id: str)[source]

Update the voicemail message(s) as unread for the user. If the messageId is provided, then only mark that message as unread. Otherwise, all messages for the user are marked as unread.

Parameters:

message_id (str) – The voicemail message identifier of the message to mark as unread. If the messageId is not provided, then all voicemail messages for the user are marked as unread.

base = 'telephony/voiceMessages'
class wxc_sdk.as_api.AsVoicePortalApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

location voice portal API

async read(location_id: str, org_id: str | None = None) VoicePortalSettings[source]
Parameters:
  • location_id (str) – Location to which the voice portal belongs.

  • org_id (str) – Organization to which the voice portal belongs.

Returns:

location voice portal settings

Return type:

VoicePortalSettings

async update(location_id: str, settings: VoicePortalSettings, passcode: str | None = None, org_id: str | None = None)[source]

Update VoicePortal

Update Voice portal information for the location.

Voice portals provide an interactive voice response (IVR) system so administrators can manage auto attendant announcements.

Updating voice portal information for organization and/or rules requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Location to which the voice portal belongs.

  • settings (VoicePortalSettings) – new settings

  • passcode (str) – new passcode

  • org_id (str) – Organization to which the voice portal belongs.

async passcode_rules(location_id: str, org_id: str | None = None) PasscodeRules[source]

Get VoicePortal Passcode Rule

Retrieve the voice portal passcode rule for a location.

Voice portals provide an interactive voice response (IVR) system so administrators can manage auto attendant announcements

Retrieving the voice portal passcode rule requires a full read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Retrieve voice portal passcode rules for this location.

  • org_id (str) – Retrieve voice portal passcode rules for this organization.

Returns:

passcode rules

Return type:

PasscodeRules

base = 'telephony/config/locations'
class wxc_sdk.as_api.AsVoicemailApi(*, session: AsRestSession, selector: ApiSelector = ApiSelector.person)[source]

Bases: AsPersonSettingsApiChild

API for person’s call voicemail settings

feature = 'voicemail'
async read(person_id: str, org_id: str | None = None) VoicemailSettings[source]

Read Voicemail Settings for a Person Retrieve a Person’s Voicemail Settings

The voicemail feature transfers callers to voicemail based on your settings. You can then retrieve voice messages via Voicemail. Voicemail audio is sent in Waveform Audio File Format, .wav, format.

Optionally, notifications can be sent to a mobile phone via text or email. These notifications will not include the voicemail files.

This API requires a full, user, or read-only administrator auth token with a scope of spark-admin:people_read or a user auth token with spark:people_read scope can be used by a person to read their settings.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • org_id (str) – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

Returns:

user’s voicemail settings

Return type:

VoicemailSettings

async configure(person_id: str, settings: VoicemailSettings, org_id: str | None = None)[source]

Configure Voicemail Settings for a Person Configure a person’s Voicemail Settings

The voicemail feature transfers callers to voicemail based on your settings. You can then retrieve voice messages via Voicemail. Voicemail audio is sent in Waveform Audio File Format, .wav, format.

Optionally, notifications can be sent to a mobile phone via text or email. These notifications will not include the voicemail files.

This API requires a full or user administrator auth token with the spark-admin:people_write scope or a user auth token with spark:people_write scope can be used by a person to update their settings. :return:

configure_busy_greeting(person_id: str, content: BufferedReader | str, upload_as: str | None = None, org_id: str | None = None)[source]

Configure Busy Voicemail Greeting for a Person Configure a Person’s Busy Voicemail Greeting by uploading a Waveform Audio File Format, .wav, encoded audio file.

Your request will need to be a multipart/form-data request rather than JSON, using the audio/wav Content-Type.

This API requires a full or user administrator auth token with the spark-admin:people_write scope or a user auth token with spark:people_write scope can be used by a person to update their settings.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • content (Union[BufferedReader, str]) – the file to be uploaded, can be a path to a file or a buffered reader (opened file); if a reader referring to an open file is passed then make sure to open the file as binary b/c otherwise the content length might be calculated wrong

  • upload_as (str) – filename for the content. Only required if content is a reader; has to be a .wav file name.

  • org_id (str) – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

configure_no_answer_greeting(person_id: str, content: BufferedReader | str, upload_as: str | None = None, org_id: str | None = None)[source]

Configure No Answer Voicemail Greeting for a Person Configure a Person’s No Answer Voicemail Greeting by uploading a Waveform Audio File Format, .wav, encoded audio file.

Your request will need to be a multipart/form-data request rather than JSON, using the audio/wav Content-Type.

This API requires a full or user administrator auth token with the spark-admin:people_write scope or a user auth token with spark:people_write scope can be used by a person to update their settings.

Parameters:
  • person_id (str) – Unique identifier for the person.

  • content (Union[BufferedReader, str]) – the file to be uploaded, can be a path to a file or a buffered reader (opened file); if a reader referring to an open file is passed then make sure to open the file as binary b/c otherwise the content length might be calculated wrong

  • upload_as (str) – filename for the content. Only required if content is a reader; has to be a .wav file name.

  • org_id (str) – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

async modify_passcode(person_id: str, passcode: str, org_id: str | None = None)[source]

Modify a person’s voicemail passcode.

Modifying a person’s voicemail passcode requires a full administrator, user administrator or location administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • person_id (str) – Modify voicemail passcode for this person.

  • passcode (str) – Voicemail access passcode. The minimum length of the passcode is 6 and the maximum length is 30.

  • org_id (str) – Modify voicemail passcode for a person in this organization.

Return type:

None

base = ''
class wxc_sdk.as_api.AsVoicemailGroupsApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

API for voicemail groups

ep(location_id: str | None = None, path: str | None = None)[source]
Parameters:
  • location_id

  • path

Returns:

list_gen(location_id: str | None = None, name: str | None = None, phone_number: str | None = None, org_id: str | None = None, **params) AsyncGenerator[VoicemailGroup, None, None][source]

List the voicemail group information for the organization.

You can create a shared voicemail box and inbound fax box to assign to users or call routing features like an auto attendant, call queue, or hunt group.

Retrieving voicemail Group for the organization requires a full read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Location to which the voicemail group belongs.

  • name (str) – Search (Contains) based on voicemail group name

  • phone_number (str) – Search (Contains) based on number or extension

  • org_id (str) – Organization to which the voicemail group belongs.

Returns:

yields ::class::VoicemailGroup instances

async list(location_id: str | None = None, name: str | None = None, phone_number: str | None = None, org_id: str | None = None, **params) List[VoicemailGroup][source]

List the voicemail group information for the organization.

You can create a shared voicemail box and inbound fax box to assign to users or call routing features like an auto attendant, call queue, or hunt group.

Retrieving voicemail Group for the organization requires a full read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Location to which the voicemail group belongs.

  • name (str) – Search (Contains) based on voicemail group name

  • phone_number (str) – Search (Contains) based on number or extension

  • org_id (str) – Organization to which the voicemail group belongs.

Returns:

yields ::class::VoicemailGroup instances

async details(location_id: str, voicemail_group_id: str, org_id: str | None = None) VoicemailGroupDetail[source]

Retrieve voicemail group details for a location.

Manage your voicemail group settings for a specific location, like when you want your voicemail to be active, message storage settings, and how you would like to be notified of new voicemail messages.

Retrieving voicemail group details requires a full, user or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • location_id (str) – Retrieve voicemail group details for this location.

  • voicemail_group_id (str) – Retrieve voicemail group details for this voicemail group ID.

  • org_id (str) – Retrieve voicemail group details for a customer location.

Returns:

Voicemail group settings

Type:

VoicemailGroupDetail

async update(location_id: str, voicemail_group_id: str, settings: VoicemailGroupDetail, org_id: str | None = None)[source]

Modifies the voicemail group location details for a particular location for a customer.

Manage your voicemail settings, like when you want your voicemail to be active, message storage settings, and how you would like to be notified of new voicemail messages.

Modifying the voicemail group location details requires a full, user administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Modifies the voicemail group details for this location.

  • voicemail_group_id (str) – Modifies the voicemail group details for this voicemail group ID.

  • settings (VoicemailGroupDetail) – New settings

  • org_id (str) – Modifies the voicemail group details for a customer location.

async create(location_id: str, settings: VoicemailGroupDetail, org_id: str | None = None) str[source]

Create new voicemail group for the given location for a customer.

Voicemail group can be created for given location for a customer.

Creating voicemail group for the given location requires a full or user administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Create new voice mail group for this location.

  • settings (VoicemailGroupDetail) –

    settings for new voicemail group Example:

    settings = VoicemailGroupDetail.create(
                            name=vmg_name, extension=extension,
                            first_name='first', last_name='last',
                            passcode=740384)
    vmg_id = api.telephony.voicemail_groups.create(location_id=location_id,
                                                   settings=settings)
    

  • org_id (str) – Create new voice mail group for this organization.

Returns:

UUID of the newly created voice mail group.

Return type:

str

async delete(location_id: str, voicemail_group_id: str, org_id: str | None = None)[source]

Delete the designated voicemail group.

Deleting a voicemail group requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • location_id (str) – Location from which to delete a voicemail group.

  • voicemail_group_id (str) – Delete the voicemail group with the matching ID.

  • org_id (str) – Delete the voicemail group from this organization.

base = 'telephony/config/voicemailGroups'
class wxc_sdk.as_api.AsVoicemailRulesApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

API for voicemail rules settings

async read(org_id: str | None = None) VoiceMailRules[source]

Get Voicemail Rules

Retrieve the organization’s voicemail rules.

Organizational voicemail rules specify the default passcode requirements.

Retrieving the organization’s voicemail rules requires a full, user or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:

org_id (str) – Retrieve voicemail settings for this organization.

Returns:

VM settings

Return type:

OrganisationVoicemailSettings

async update(settings: VoiceMailRules, org_id: str | None = None)[source]

Update Voicemail Rules

Update the organization’s default voicemail passcode and/or rules.

Organizational voicemail rules specify the default passcode requirements.

If you choose to set default passcode for new people added to your organization, communicate to your people what that passcode is, and that it must be reset before they can access their voicemail. If this feature is not turned on, each new person must initially set their own passcode.

Updating organization’s voicemail passcode and/or rules requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • settings (VoiceMailRules) – new settings

  • org_id (str) – Update voicemail rules for this organization.

base = 'telephony/config/voicemail/rules'
class wxc_sdk.as_api.AsWebexSimpleApi(*, tokens: str | Tokens | None = None, concurrent_requests: int = 10, retry_429: bool = True)[source]

Bases: object

The main API object

admin_audit: AsAdminAuditEventsApi

Admin Audit Events API AsAdminAuditEventsApi

attachment_actions: AsAttachmentActionsApi

Attachment actions API AsAttachmentActionsApi

authorizations: AsAuthorizationsApi

Authorizations API AsAuthorizationsApi

cdr: AsDetailedCDRApi

CDR API AsDetailedCDRApi

device_configurations: AsDeviceConfigurationsApi

device configurations API AsDeviceConfigurationsApi

devices: AsDevicesApi

devices API AsDevicesApi

events: AsEventsApi

events API; AsEventsApi

groups: AsGroupsApi

groups API AsGroupsApi

guests: AsGuestManagementApi

guests API AsGuestManagementApi

licenses: AsLicensesApi

Licenses API AsLicensesApi

locations: AsLocationsApi

Location API AsLocationsApi

meetings: AsMeetingsApi

meetings API AsMeetingsApi

membership: AsMembershipApi

membership API AsMembershipApi

messages: AsMessagesApi

Messages API AsMessagesApi

organizations: AsOrganizationApi

organization settings API

person_settings: AsPersonSettingsApi

Person settings API AsPersonSettingsApi

people: AsPeopleApi

People API AsPeopleApi

reports: AsReportsApi

Reports API AsReportsApi

rooms: AsRoomsApi

Rooms API AsRoomsApi

room_tabs: AsRoomTabsApi

Room tabs API AsRoomTabsApi

scim: AsScimV2Api

AsScimV2Api

Type:

ScimV2 API

status: AsStatusAPI

Webex Status API AsStatusAPI

teams: AsTeamsApi

Teams API AsTeamsApi

team_memberships: AsTeamMembershipsApi

Team memberships API AsTeamMembershipsApi

telephony: AsTelephonyApi

Telephony (features) API AsTelephonyApi

webhook: AsWebhookApi

Webhooks API AsWebhookApi

workspaces: AsWorkspacesApi

Workspaces API AsWorkspacesApi

workspace_locations: AsWorkspaceLocationApi

Workspace locations API; AsWorkspaceLocationApi

workspace_personalization: AsWorkspacePersonalizationApi

workspace_personalization.AsWorkspacePersonalizationApi`

Type:

Workspace personalization API

Type:

class

workspace_settings: AsWorkspaceSettingsApi

Workspace setting API AsWorkspaceSettingsApi

session: AsRestSession

AsRestSession used for all API requests

property access_token: str

access token used for all requests

Returns:

access token

Return type:

str

async close()[source]
class wxc_sdk.as_api.AsWebhookApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

API for webhook management

base = 'webhooks'
list_gen() AsyncGenerator[Webhook, None, None][source]

List all of your webhooks.

Returns:

yields webhooks

async list() List[Webhook][source]

List all of your webhooks.

Returns:

yields webhooks

async create(name: str, target_url: str, resource: WebhookResource, event: WebhookEventType, filter: str | None = None, secret: str | None = None, owned_by: str | None = None) Webhook[source]

Creates a webhook.

Parameters:
  • name – A user-friendly name for the webhook.

  • target_url – The URL that receives POST requests for each event.

  • resource – The resource type for the webhook. Creating a webhook requires ‘read’ scope on the resource the webhook is for.

  • event – The event type for the webhook.

  • filter – The filter that defines the webhook scope.

  • secret – The secret used to generate payload signature.

  • owned_by – Specified when creating an org/admin level webhook. Supported for meetings, recordings and meetingParticipants resources for now.

Returns:

the new webhook

async details(webhook_id: str) Webhook[source]

Get Webhook Details Shows details for a webhook, by ID.

Parameters:

webhook_id (str) – The unique identifier for the webhook.

Returns:

Webhook details

async update(webhook_id: str, update: Webhook) Webhook[source]

Updates a webhook, by ID. You cannot use this call to deactivate a webhook, only to activate a webhook that was auto deactivated. The fields that can be updated are name, targetURL, secret and status. All other fields, if supplied, are ignored.

Parameters:
  • webhook_id (str) – The unique identifier for the webhook.

  • update (Webhook) – The webhook update

Returns:

updated Webhook object

async webhook_delete(webhook_id: str)[source]

Deletes a webhook, by ID.

Parameters:

webhook_id (str) – The unique identifier for the webhook.

Returns:

None

class wxc_sdk.as_api.AsWorkspaceDevicesApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

base = 'telephony/config/workspaces'
list_gen(workspace_id: str, org_id: str | None = None) AsyncGenerator[TelephonyDevice, None, None][source]

Get all devices for a workspace. This requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • workspace_id (str) – ID of the workspace for which to retrieve devices.

  • org_id (str) – Organization to which the workspace belongs.

documentation: https://developer.webex.com/docs/api/v1/webex-calling-organization-settings/get-workspace-devices

async list(workspace_id: str, org_id: str | None = None) List[TelephonyDevice][source]

Get all devices for a workspace. This requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:
  • workspace_id (str) – ID of the workspace for which to retrieve devices.

  • org_id (str) – Organization to which the workspace belongs.

documentation: https://developer.webex.com/docs/api/v1/webex-calling-organization-settings/get-workspace-devices

async modify_hoteling(workspace_id: str, hoteling: Hoteling, org_id: str | None = None)[source]

Modify devices for a workspace. Modifying devices for a workspace requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:
  • workspace_id (str) – ID of the workspace for which to modify devices.

  • hoteling (Hoteling) – hoteling settings

  • org_id (str) – Organization to which the workspace belongs.

documentation: https://developer.webex.com/docs/api/v1/webex-calling-organization-settings/modify-workspace -devices

class wxc_sdk.as_api.AsWorkspaceLocationApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

base = 'workspaceLocations'
floors: AsWorkspaceLocationFloorApi

Workspace location floor API AsWorkspaceLocationFloorApi

ep(location_id: str | None = None)[source]

endpoint URL for given path

Parameters:

path (str) – path after APIChild subclass specific endpoint URI prefix

Returns:

endpoint URL

Return type:

str

list_gen(display_name: str | None = None, address: str | None = None, country_code: str | None = None, city_name: str | None = None, org_id: str | None = None, **params) AsyncGenerator[WorkspaceLocation, None, None][source]

List workspace locations

Parameters:
  • display_name (str) – Location display name.

  • address (str) – Location address

  • country_code (str) – Location country code (ISO 3166-1).

  • city_name (str) – Location city name.

  • org_id (str) – Organization id

  • params – addtl. parameters

Returns:

generator of WorkspaceLocation instances

async list(display_name: str | None = None, address: str | None = None, country_code: str | None = None, city_name: str | None = None, org_id: str | None = None, **params) List[WorkspaceLocation][source]

List workspace locations

Parameters:
  • display_name (str) – Location display name.

  • address (str) – Location address

  • country_code (str) – Location country code (ISO 3166-1).

  • city_name (str) – Location city name.

  • org_id (str) – Organization id

  • params – addtl. parameters

Returns:

generator of WorkspaceLocation instances

async create(display_name: str, address: str, country_code: str, latitude: float, longitude: float, city_name: str | None = None, notes: str | None = None, org_id: str | None = None) WorkspaceLocation[source]

Create a location. The cityName and notes parameters are optional, and omitting them will result in the creation of a location without these values set.

Parameters:
  • display_name – A friendly name for the location.

  • address – The location address.

  • country_code – The location country code (ISO 3166-1).

  • latitude – The location latitude.

  • longitude – The location longitude.

  • city_name – The location city name.

  • notes – Notes associated to the location.

  • org_id

Returns:

created workspace location

Return type:

WorkspaceLocation

async details(location_id: str, org_id: str | None = None) WorkspaceLocation[source]

Get a Workspace Location Details Shows details for a location, by ID. Specify the location ID in the locationId parameter in the URI.

Parameters:
  • location_id (str) – A unique identifier for the location.

  • org_id (str)

Returns:

Workspace location details

Return type:

WorkspaceLocation

async update(location_id: str, settings: WorkspaceLocation, org_id: str | None = None) WorkspaceLocation[source]

Update a Workspace Location Updates details for a location, by ID. Specify the location ID in the locationId parameter in the URI. Include all details for the location that are present in a Get Workspace Location Details. Not including the optional cityName or notes fields (setting them to None) will result in the fields no longer being defined for the location.

Parameters:
  • location_id (str) – A unique identifier for the location.

  • settings (WorkspaceLocation) – new settings

  • org_id (str)

Returns:

updated workspace location

Return type:

WorkspaceLocation

async delete(location_id: str, org_id: str | None = None)[source]

Delete a Workspace Location Deletes a location, by ID. The workspaces associated to that location will no longer have a location, but a new location can be reassigned to them.

class wxc_sdk.as_api.AsWorkspaceLocationFloorApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

base = 'workspaceLocations'
ep(location_id: str, floor_id: str | None = None)[source]

endpoint URL for given path

Parameters:

path (str) – path after APIChild subclass specific endpoint URI prefix

Returns:

endpoint URL

Return type:

str

list_gen(location_id: str, org_id: str | None = None) AsyncGenerator[WorkspaceLocationFloor, None, None][source]
Parameters:
  • location_id

  • org_id

Returns:

async list(location_id: str, org_id: str | None = None) List[WorkspaceLocationFloor][source]
Parameters:
  • location_id

  • org_id

Returns:

async create(location_id: str, floor_number: int, display_name: str | None = None, org_id: str | None = None) WorkspaceLocationFloor[source]

Create a Workspace Location Floor

Create a new floor in the given location. The displayName parameter is optional, and omitting it will result in the creation of a floor without that value set.

Parameters:
  • location_id (str) – A unique identifier for the location.

  • floor_number

  • display_name

  • org_id (str)

Returns:

new workspace location floor

Return type:

WorkspaceLocationFloor

async details(location_id: str, floor_id: str, org_id: str | None = None) WorkspaceLocationFloor[source]

Get a Workspace Location Floor Details

Shows details for a floor, by ID. Specify the floor ID in the floorId parameter in the URI.

Parameters:
  • location_id (str) – A unique identifier for the location.

  • floor_id (str) – A unique identifier for the floor.

  • org_id (str)

Returns:

workspace location floor details

Return type:

WorkspaceLocationFloor

async update(location_id: str, floor_id: str, settings: WorkspaceLocationFloor, org_id: str | None = None) WorkspaceLocationFloor[source]

Updates details for a floor, by ID. Specify the floor ID in the floorId parameter in the URI. Include all details for the floor that are present in a Get Workspace Location Floor Details. Not including the optional displayName field will result in the field no longer being defined for the floor.

Parameters:
  • location_id (str) – A unique identifier for the location.

  • floor_id (str) – A unique identifier for the floor.

  • settings (WorkspaceLocationFloor) – new settings

  • org_id (str)

Returns:

updated workspace location floor

async delete(location_id: str, floor_id: str, org_id: str | None = None)[source]

Delete a Workspace Location Floor Deletes a floor, by ID.

Parameters:
  • location_id (str) – A unique identifier for the location.

  • floor_id (str) – A unique identifier for the floor.

  • org_id (str)

class wxc_sdk.as_api.AsWorkspaceNumbersApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

base = 'workspaces'
async read(workspace_id: str, org_id: str | None = None) WorkspaceNumbers[source]

List the PSTN phone numbers associated with a specific workspace, by ID, within the organization. Also shows the location and Organization associated with the workspace.

Retrieving this list requires a full or read-only administrator auth token with a scope of spark-admin:workspaces_read.

Parameters:
  • workspace_id (str) – List numbers for this workspace.

  • org_id (str) – List numbers for a workspace within this organization.

Returns:

Workspace numbers

Return type:

WorkspaceNumbers

class wxc_sdk.as_api.AsWorkspacePersonalizationApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Workspace Personalization

This API collection applies only to Webex Edge registered devices.

The Workspace Personalization API is designed to help administrators enable Personal Mode for Webex Edge registered devices. This one-time operation allows for end users to receive calls and meeting notifications directly on their device, without needing to pair. This API aids with the process of the migration from on-premise to cloud-registered personal mode systems.

For the personalization of a device to be successful, the following requirements must be satisfied:

  • The workspace must contain a single, Webex Edge registered, shared mode device.

  • The workspace must not have any calendars configured.

  • The device belonging to the workspace must be online.

Invoking this API requires the spark-admin:devices_write, spark:xapi_commands, spark:xapi_statuses and Identity:one_time_password scopes.

base = 'workspaces'
async personalize_a_workspace(workspace_id: str, email: str)[source]

Personalize a Workspace

Initializes the personalization for a given workspace for the user email provided.

The personalization process is asynchronous and thus a background task is created when this endpoint is invoked. After successful invocation of this endpoint a personalization task status URL will be returned in the Location header, which will point to the Get Personalization Task endpoint for this workspace. The task should be completed in approximately 30 seconds.

Parameters:
  • workspace_id (str) – A unique identifier for the workspace.

  • email (str) – The user that the device will become personalised for.

Return type:

None

async get_personalization_task(workspace_id: str) WorkspacePersonalizationTaskResponse[source]

Get Personalization Task

Returns the status of a personalization task for a given workspace.

Whilst in progress the endpoint will return Accepted and provide a Retry-After header indicating the number of seconds a client should wait before retrying.

Upon completion of the task, the endpoint will return OK with a body detailing if the personalization was successful and an error description if appropriate.

Parameters:

workspace_id (str) – A unique identifier for the workspace.

Return type:

WorkspacePersonalizationTaskResponse

class wxc_sdk.as_api.AsWorkspaceSettingsApi(session: AsRestSession)[source]

Bases: AsApiChild

API for all workspace settings.

Most of the workspace settings are equivalent to corresponding user settings. For these settings the attributes of this class are instances of the respective user settings APIs. When calling endpoints of these APIs workspace IDs need to be passed to the person_id parameter of the called function.

base = 'workspaces'
call_bridge: AsCallBridgeApi
call_intercept: AsCallInterceptApi
call_waiting: AsCallWaitingApi
caller_id: AsCallerIdApi
devices: AsWorkspaceDevicesApi
forwarding: AsPersonForwardingApi
monitoring: AsMonitoringApi
numbers: AsWorkspaceNumbersApi
permissions_in: AsIncomingPermissionsApi
permissions_out: AsOutgoingPermissionsApi
class wxc_sdk.as_api.AsWorkspacesApi(*, session: AsRestSession, base: str | None = None)[source]

Bases: AsApiChild

Workspaces API

Workspaces represent where people work, such as conference rooms, meeting spaces, lobbies, and lunch rooms. Devices may be associated with workspaces. Viewing the list of workspaces in an organization requires an administrator auth token with the spark-admin:workspaces_read scope. Adding, updating, or deleting workspaces in an organization requires an administrator auth token with the spark-admin:workspaces_write scope. The Workspaces API can also be used by partner administrators acting as administrators of a different organization than their own. In those cases an orgId value must be supplied, as indicated in the reference documentation for the relevant endpoints.

base = 'workspaces'
list_gen(location_id: str | None = None, workspace_location_id: str | None = None, floor_id: str | None = None, display_name: str | None = None, capacity: int | None = None, workspace_type: WorkSpaceType | None = None, calling: CallingType | None = None, supported_devices: WorkspaceSupportedDevices | None = None, calendar: CalendarType | None = None, device_hosted_meetings_enabled: bool | None = None, device_platform: DevicePlatform | None = None, org_id: str | None = None, **params) AsyncGenerator[Workspace, None, None][source]

List Workspaces

List workspaces. Use query parameters to filter the response. The orgId parameter can only be used by admin users of another organization (such as partners). The workspaceLocationId, floorId, capacity and type fields will only be present for workspaces that have a value set for them. The special values notSet (for filtering on category) and -1 (for filtering on capacity) can be used to filter for workspaces without a type and/or capacity.

Parameters:
  • location_id (str) – Location associated with the workspace. Values must originate from the /locations API and not the legacy /workspaceLocations API.

  • workspace_location_id (str) – Location associated with the workspace. Both values from the /locations API and the legacy /workspaceLocations API are supported. This field is deprecated and integrations should prefer locationId going forward.

  • floor_id (str) – Floor associated with the workspace.

  • display_name (str) – List workspaces by display name.

  • capacity (int) – List workspaces with the given capacity. Must be -1 or higher. A value of -1 lists workspaces with no capacity set.

  • workspace_type (WorkSpaceType) – List workspaces by type. Possible values: notSet, focus, huddle, meetingRoom, open, desk, other

  • calling (CallingType) – List workspaces by calling type. Possible values: freeCalling, hybridCalling, webexCalling, webexEdgeForDevices, thirdPartySipCalling, none

  • supported_devices (str) – List workspaces by supported devices. Possible values: collaborationDevices, phones

  • calendar (CalendarType) – List workspaces by calendar type. Possible values: none, google, microsoft

  • device_hosted_meetings_enabled (bool) – List workspaces enabled for device hosted meetings.

  • device_platform (DevicePlatform) – List workspaces by device platform.

  • org_id (str) – List workspaces in this organization. Only admin users of another organization (such as partners) may use this parameter.

Returns:

generator of Workspace instances

async list(location_id: str | None = None, workspace_location_id: str | None = None, floor_id: str | None = None, display_name: str | None = None, capacity: int | None = None, workspace_type: WorkSpaceType | None = None, calling: CallingType | None = None, supported_devices: WorkspaceSupportedDevices | None = None, calendar: CalendarType | None = None, device_hosted_meetings_enabled: bool | None = None, device_platform: DevicePlatform | None = None, org_id: str | None = None, **params) List[Workspace][source]

List Workspaces

List workspaces. Use query parameters to filter the response. The orgId parameter can only be used by admin users of another organization (such as partners). The workspaceLocationId, floorId, capacity and type fields will only be present for workspaces that have a value set for them. The special values notSet (for filtering on category) and -1 (for filtering on capacity) can be used to filter for workspaces without a type and/or capacity.

Parameters:
  • location_id (str) – Location associated with the workspace. Values must originate from the /locations API and not the legacy /workspaceLocations API.

  • workspace_location_id (str) – Location associated with the workspace. Both values from the /locations API and the legacy /workspaceLocations API are supported. This field is deprecated and integrations should prefer locationId going forward.

  • floor_id (str) – Floor associated with the workspace.

  • display_name (str) – List workspaces by display name.

  • capacity (int) – List workspaces with the given capacity. Must be -1 or higher. A value of -1 lists workspaces with no capacity set.

  • workspace_type (WorkSpaceType) – List workspaces by type. Possible values: notSet, focus, huddle, meetingRoom, open, desk, other

  • calling (CallingType) – List workspaces by calling type. Possible values: freeCalling, hybridCalling, webexCalling, webexEdgeForDevices, thirdPartySipCalling, none

  • supported_devices (str) – List workspaces by supported devices. Possible values: collaborationDevices, phones

  • calendar (CalendarType) – List workspaces by calendar type. Possible values: none, google, microsoft

  • device_hosted_meetings_enabled (bool) – List workspaces enabled for device hosted meetings.

  • device_platform (DevicePlatform) – List workspaces by device platform.

  • org_id (str) – List workspaces in this organization. Only admin users of another organization (such as partners) may use this parameter.

Returns:

generator of Workspace instances

async create(settings: Workspace, org_id: str | None = None)[source]

Create a Workspace

The locationId, workspaceLocationId, floorId, indoorNavigation, capacity, type, notes and hotdeskingStatus parameters are optional, and omitting them will result in the creation of a workspace without these values set, or set to their default. A locationId must be provided when the floorId is set. Calendar and calling can also be set for a new workspace. Omitting them will default to free calling and no calendaring. The orgId parameter can only be used by admin users of another organization (such as partners).

  • Information for Webex Calling fields may be found here: locations and available numbers

  • The locationId and supportedDevices fields cannot be changed once configured.

  • When creating a webexCalling workspace, a locationId and either a phoneNumber or extension or both is required. Furthermore, it is possible to set the licenses field with a list of Webex Calling license IDs, if desired. If multiple license IDs are provided, the oldest suitable one will be applied. If no licenses are supplied, the oldest suitable one from the active subscriptions will be automatically applied.

Parameters:
  • settings (Workspace) – settings for new Workspace

  • org_id (str) – OrgId associated with the workspace. Only admin users of another organization (such as partners) may use this parameter.

Returns:

new workspace

Return type:

Workspace

async details(workspace_id) Workspace[source]

Get Workspace Details

Shows details for a workspace, by ID. The locationId, workspaceLocationId, floorId, indoorNavigation, capacity, type and notes fields will only be present if they have been set for the workspace.

Parameters:

workspace_id (str) – A unique identifier for the workspace.

Returns:

workspace details

Return type:

Workspace

async update(workspace_id, settings: Workspace) Workspace[source]

Updates details for a workspace by ID.

Specify the workspace ID in the workspaceId parameter in the URI. Include all details for the workspace that are present in a GET request for the workspace details. Not including the optional capacity, type or notes fields will result in the fields no longer being defined for the workspace. A locationId must be provided when the floorId is set. The locationId, workspaceLocationId, floorId, supportedDevices, calendar and calling fields do not change when omitted from the update request.

  • Information for Webex Calling fields may be found here: locations and available numbers

  • Updating the calling parameter is only supported if the existing calling type is freeCalling, none, thirdPartySipCalling or webexCalling.

  • Updating the calling parameter to none, thirdPartySipCalling or webexCalling is not supported if the workspace contains any devices.

  • The locationId and supportedDevices fields cannot be changed once configured.

  • When updating webexCalling information, a locationId and either a phoneNumber or extension or both is required. Furthermore, the licenses field can be set with a list of Webex Calling license IDs, if desired. If multiple license IDs are provided, the oldest suitable one will be applied. If a previously applied license ID is omitted, it will be replaced with one from the list provided. If the licenses field is omitted, the current calling license will be retained.

Parameters:
  • workspace_id (str) – A unique identifier for the workspace.

  • settings (Workspace) – new workspace settings

Returns:

updated workspace

Return type:

Workspace

async delete_workspace(workspace_id)[source]

Delete a Workspace

Deletes a workspace, by ID. Will also delete all devices associated with the workspace. Any deleted devices will need to be reactivated.

Parameters:

workspace_id (str) – A unique identifier for the workspace.

async capabilities(workspace_id: str) CapabilityMap[source]

Shows the capabilities for a workspace by ID. Returns a set of capabilities, including whether or not the capability is supported by any device in the workspace, and if the capability is configured (enabled). For example for a specific capability like occupancyDetection, the API will return if the capability is supported and/or configured such that occupancy detection data will flow from the workspace (device) to the cloud. Specify the workspace ID in the workspaceId parameter in the URI.

Parameters:

workspace_id (str) – A unique identifier for the workspace.