API Changelog
This page lists recent and upcoming changes to the Webex API. Contact Webex Developer Support with any questions.
March 18, 2024
Partners should plan for a transition to a new
packages
field, which accepts a list of packages, as Cisco will eventually remove support for the existingpackage
field in the Wholesale Subscriber Provisioning POST, PUT, GET, LIST and PreCheck APIs. Further information will be provided well in advance of a published removal date.
March 15, 2024
We have observed that during the OAuth 2.0 integration authorization process, customers have been appending data to URLs as query parameters in their POST requests. Although this method was functional previously, please be aware that it will no longer be supported after 6:00 PM on April 5, 2024 (America/Los_Angeles time zone). This change is in line with the best practices recommended by the Open Web Application Security Project (OWASP), which advises against exposing sensitive information through URL query strings (you can find more information on this topic here). We prioritize the security of your users' data, and adhering to these standards is crucial for maintaining the integrity of our platform.
March 14, 2024
On May 1, 2024, Webex Calling Public APIs are moving to a new, more modern ID for the following types: Auto Attendant, Call Queue, Hunt Group, Paging Group, and Single Number Reach. Customers following the general recommendation to treat Public API IDs opaquely should not be affected beyond comparing IDs saved in the old format with new IDs. The APIs will continue to accept ids in the old format as input.
March 8, 2024
In the Virtual Line Call Settings API, we've added multiple endpoints that let you manage all Virtual Lines call settings.
March 7, 2024
The Get a person's Privacy Settings API returned IDs in the
monitoringAgent
field that were not compatible with APIs like Get Person Details. Get a person's Privacy Settings API has been corrected to return Person, Virtual Line, and Workspace IDs fully compatible with other APIs.
March 7, 2024
For consistency with other APIs, the GET /v1/telephony/config/locations/{locationId}/queues/{queueId}/callForwarding API will be renaming the
sendToVoiceMailEnabled
response field todestinationVoiceMailEnabled
.To allow API clients to make this transition, for the next six weeks, we are adding the
destinationVoiceMailEnabled
alongside the existingsendToVoiceMailEnabled
field. On April 15, 2024 thesendToVoiceMailEnabled
will be removed from the response.
March 6, 2024
Two new attributes,
hostDidJoin
andattendeeDidJoin
, are returned in the response of the following APIs: Get a Meeting, List Meetings, and List Meetings of a Meeting Series. Those new attributes only apply to meeting series in theinProgress
state, scheduled meetings in theready
state, and meeting instances in theinProgress
state, whether or not anyone has joined the meeting. Indicates that someone is waiting in the lobby and the host hasn't joined the meeting, if bothattendeeDidJoin
is true andhostDidJoin
is false.
February 27, 2024
The Update Location Webex Calling Details API now ignores
pAccessNetworkInfo
if the location's country is not Belgium, Germany, and France. Starting April 11, 2024, the API will respond with an error ifpAccessNetworkInfo
is modified for locations outside of Belgium, Germany, and France.
February 21, 2024
Currently when one of the Webex for Wholesale or Webex for Broadworks APIs returns error code 5001, Internal Server Error, we include a
description
which details where the issue occurred. Since internal server errors are, by nature, unexpected, these detailed descriptions are often not useful as they reference internal service interactions beyond your control. We are now opting to return a genericdescription
which says "An unexpected error occurred", and including aninternalErrorCode
in the response body to indicate the precise nature of the issue. This will help accelerate the resolution of support tickets, as aninternalErrorCode
is of more benefit when trying to resolve such issues. This change will take effect before the end of February.
February 7, 2024
If a Broadworks Subscriber exists but contains errors, the Get A Broadworks Subscriber and List Broadworks Subscribers APIs now return the
errorCode
asinteger
in theerrors
array. This change aligns the APIs with current documentation. Please review and prepare any code using these APIs and parsing theerrorCode
for the change in type.
January 31, 2024
We are proud to announce the availability of the new guest creation mechanism via Service Apps. Guests are now created from authorized Service Apps with guest-issuer scopes. The traditional way of using a
Guest Issuer
app type is deprecated and will be removed in the future.
January 25, 2024
In the Virtual Line Call Settings API, we've added multiple endpoints that let you create and manage Virtual Lines and subsets of their call settings.
January 17, 2024
We are please to announce the support for the System for cross-domain Identity Management (SCIM) v2.0 standard as specified by RFC7643 and IETF RFC7644 in our developer program. Endpoints supported include v2/Users, v2/Groups and v2/Bulk. With Webex SCIM 2.0 APIs, customers can configure or develop SCIM 2.0 clients to manage users and groups in Webex.
December 21, 2023
The /v1/devices APIs and /v1/workspaces are moving towards returning organizations, location, and people IDs which exactly match those IDs returned by /v1/organizations, /v1/locations, and /v1/people respectively. The default format of IDs returned will be changed to the new, compatible style on February 2, 2024. Clients that rely on the current style of IDs can pass the legacy=true query parameter which will ensure the current style of organizations, location, and people IDs will continue to be returned by these APIs after the default ID style changes. Note that Webex Calling specific APIs already return IDs in the compatible format, and will not honor the legacy query parameter. APIs will continue to accept both styles of IDs.
December 15, 2023
We now provide
businessTexts
a.k.a. SMS events in the events API . When a Webex Calling user sends or receives SMS messages, these will be logged in the API and can be retrieved by a Compliance Officer. This feature complements our recently released CDR events.
December 12, 2023
In an ongoing effort to strengthen the security posture of the Webex Developer APIs have we removed support for the below weak and old ciphers in TLS connections. Remember only TLS 1.2 and TLS 1.3 are supported. In addition TLS SNI, Server Name Indication is now mandatory.
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA TLS_RSA_WITH_AES_128_GCM_SHA256 TLS_RSA_WITH_AES_128_CBC_SHA TLS_RSA_WITH_AES_256_GCM_SHA384 TLS_RSA_WITH_AES_256_CBC_SHA256 TLS_RSA_WITH_AES_256_CBC_SHA
December 12, 2023
If a Broadworks Subscriber exists but contains errors, the Get A Broadworks Subscriber and List Broadworks Subscribers APIs currently return the
errorCode
as aString
in theerrors
array. From February 1 2024, these APIs will return theerrorCode
as an integer, which will align the APIs with current documentation. Please review and prepare any code using these APIs and parsing theerrorCode
for the change in type.
December 6, 2023
The APIs Add Phone Numbers to a location, Activate Phone Numbers in a location, and Remove phone numbers from a location now require phone numbers in the E.164 format for all countries.
December 6, 2023
The API, Activate phone numbers in a location, supports a maximum of 500 phone numbers.
November 30, 2023
Service Apps with meetings functionalities as indicated by
meetings:*
scopes can now be tied to specific sites in the organization. This selection is done by a full admin in Control Hub who authorizes the Service App for the required site(s). The admin can choose from any or all of the meetings sites in the organization. The service app can only act on the allowed sites. As an example let's assume an organization with two sites A and B. An admin wants to use a meeting scheduling Service App, but wants to allow this Service App only for site A. The admin would during the authorization process select site A and the Service App will not be able to schedule meetings on site B.
November 17, 2023
The call detaill records for Webex Calling can now be found in the /events API under the resource
call_records
.
November 16, 2023
The reports API provides download links for reports today in CSV format. This behavior will change on January 4, 2024 and the default file format will be zip. Until January 31, 2024 you can force the download in CSV by manipulating the download URL and setting the
zipEnable=false
. After January 31, 2024 this flag will be ignored and all reports will be provided in zip format only. Please see also this help article.
November 12, 2023
The Add Phone Numbers to a location endpoint now supports adding toll-free numbers via the new
numberType
field. The possible values for this field areDID
, which is the default if not specified, andTOLLFREE
. This functionality now properly validates that the location has a compatible PSTN connection type and ID set before adding numbers, and returns aHTTP 200 OK
rather thanHTTP 201 Created
on success.
November 1, 2023
As indicated on September 13, here in this change log, we have now enacted the new license API with the new names and the http
PATCH
.As part of the change we removed some license strings that had no function. These are
Webex Meetings Assistant
(WAM) andMeeting - Webex Collaboration Meeting Rooms
(CMR).
October 27, 2023
The following fields have been added to the Webex Calling Detailed Call History report: Ring duration, Release time, Answer indicator, Final local
SessionID
, and Final remoteSessionID
.
October 25, 2023
When patching a meeting, the
agenda
,recurrence
, andtrackingCodes
attributes can now be specified asnull
so that those attributes become null and hidden from the response after the patch. For example, by patchingrecurrence
asnull
, a recurring meeting can be changed to a non-recurring meeting. Note that you must use the the keywordnull
not the string "null".
October 23, 2023
The Receptions client DELETE feature has been corrected to return an HTTP 404
Not Found
error when the given directoryId does not exist rather than HTTP 204No Content
.
October 13, 2023
Due to a system issue, webhooks with an IP address in the targetUrl may have been disabled between Oct 13, 2023 04:30:00AM UTC and Oct 13, 2023 19:40:00 UTC. If your webhook was affected you must manually re-enable the webhook. You can do this with a PUT request and by setting the status field to
active
. Please see here. We apologize for this error on our side.
October 12, 2023
As described in the Meeting Transcripts API document, the meeting transcript cannot be recorded until the meeting recording is turned on. Since August 1, 2023, you not only need to turn on the meeting recording, but also need to turn on the Webex Assistant or the Closed Captions in order to record the meeting transcript.
October 4, 2023
In the Workspace Call Settings API, we've added Get Workspace Music on Hold Endpoint and to Modify Workspace Music on Hold Endpoint that let you configure music on hold settings for individual workspaces.
October 4, 2023
In the Users Call Settings API, we've added Get Users Music on Hold Endpoint and Modify Users Music on Hold Endpoint that let you configure music on hold settings for individual users.
September 27, 2023
As an admin user, you can now refresh personal room IDs for a site's meeting hosts using the Batch Refresh Personal Meeting Room ID API. The personal room IDs can be automatically refreshed according to the current personal room ID rule of the target site, or by the values specified by the admin user.
September 13, 2023
The
autoAcceptRequest
parameter has been added to the the request of the Update Meeting Registration Form API, and has also been added to the response of the Update Meeting Registration Form and Get registration form for a meeting APIs.
September 13, 2023
On 10/25/2023, we will be releasing the new PATCH API for license assignment as well as enhancements to the existing GET license API. You will be able to list users that are assigned a specific license, even external users. You will be able to use the PATCH command to assign all licenses, including the contact center licenses. Finally, the license names will be aligned with the names an admin can see in Control Hub for consistency and ease of use. In the table below, you will find the old and new license names. Please prepare your code to make use of the new names where needed. The name change will be effective with the rollout of the new functionality on Oct 25, 2023. The license IDs will not change.
Offer code Existing name New name MS Messaging Advance Messaging CF Meeting 25 party Advanced Space Meetings EE Meeting - Webex Enterprise Edition Webex Meetings Suite MC Meeting - Webex Meeting Center Webex Meetings SC Meeting - Webex Support Center Webex Support TC Meeting - Webex Training Center Webex Training EC "Meeting - Webex Event Center Webex Webinar WXSFREE Webex Free Meetings Basic Meetings CO Calling Webex Calling SD Room Systems Webex Room Kit EC250 Webex Events 250 Webex Webinar 250 EC500 Webex Events 500 Webex Webinar 500 EC1k Webex Events 1000 Webex Webinar 1000 EC3k Webex Events 3000 Webex Webinar 3000 EC5k Webex Events 5000 Webex Webinar 5000 EC10k Webex Events 10000 Webex Webinar 10000 EC25k Webex Events 25000 Webex Webinar 25000 EC50k Webex Events 50000 Webex Webinar 50000 EC100k Webex Events 100000 Webex Webinar 100000 RTT Webex Real-Time Translations Real-Time Translations FMS Basic message Basic Messaging FTS Call on Webex Call on Webex (1:1 call, non-PSTN) FTM Basic meeting Basic Space Meetings UCPREM On-Prem UCM Calling Unified Communication Manager (UCM) CVI MS Teams Video Webex Video Integration for Microsoft Teams CJPPRM CJP Premium Contact Center Premium Agent3 Note: Due to some problems with the publishing system a publishing date of Sep 26, was shown between Sep 13-Sep 21. This article was published on Sep 13, 2023.
September 7, 2023
New attributes,
hostEmail
, andhostDisplayName
are returned in the response of the List Recordings For an Admin or Compliance Officer API.
August 31, 2023
The Webex Calling Devices and Workspaces APIs now have the ability to list and add Webex Calling Workspaces and Devices, to onboard Webex Calling devices by MAC address, to manage Device Call Settings with Third-party device activation, and to manage Device Line Key templates.
August 28, 2023
When the feature toggle
DecoupleJBHWithRegistration
is applied, theJoin Before Host
option can be enabled for meetings with registration. As a meeting host, cohost, attendee, guest, or guest issue user, you can retrieve the meeting start or join links using the Join a Meeting API. NOTE: If the meeting is webinar-enabled and includes theregistration ID
option, theregistrationId
parameter is required.
August 24, 2023
The Create a Meeting, Patch a Meeting, and Update a Meeting APIs now have an attribute named
enabledAudioWatermark
that allows you to specify whether to turn on meeting audio watermarking. Only specific users can use the function. Please contact an administrator to enable the required feature toggle. Webex version 43.9.0 or higher is required.
August 9, 2023
In the locations API we will now support the field name
timeZone
instead oftimezone
to adhere to Cisco's API standards and avoid customer confusion. This change will be effective Sep 21, 2023.
July 27, 2023
In the User Call Settings APIs, new APIs to Get Users Preferred Answer Endpoint and to Modify Users Preferred Answer Endpoint have been added. In the Call Controls APIs, the dial, answer, retrieve, pickup and barge-in APIs have been enhanced to include an optional
endpointId
attribute. You can choose to use theModify Users Preferred Answer Endpoint
API to specify the preferred answer endpoint for all subsequent calls or instead specify the endpointId for each call using the Call Control API option.
July 27, 2023
A webinar host can now generate individual post-event survey links for different users using the Get Meeting Survey Links API by specifying users' emails. This API only applies to webinars. Webex version 43.8.0 or higher is required.
July 21, 2023
In the Configure Call Recording Settings for a Person API we are phasing out the
startStopAnnouncementEnabled
parameter and replace it with more granular control. The setting can now be configured for internal calls and pstn calls separately. The respective parameters arestartStopAnnouncement.internalCallsEnabled
andstartStopAnnouncement.pstnCallsEnabled
. You can use the new parameters immediately.
July 18, 2023
As a host or cohost user, you can now list in-progress meeting breakout sessions using the List Meeting Breakout Sessions API and admit participants into meeting breakout sessions using Admit Participants. The changes only apply to meetings on converged sites and are behind a feature toggle. Only EFT users can use the functions. Please contact an administrator to enable the feature toggle. Webex version 43.6.0 or higher is required.
July 6, 2023
We've added support for an "announcement repository", which is a centralized repository of media at the customer/org and location levels. Different features can utilize this media for things like audible announcements being played when certain events/situations happen. The following APIs can upload and list announcements at the customer or org level: Upload a binary announcement greeting at organization level, Fetch list of announcement greetings on location and organization level, Fetch details of binary announcement greeting at organization level, Modify a binary announcement greeting, Fetch repository usage for announcements for an organization, and Delete an announcement greeting of an organization. The following APIs can upload and list announcements at the location level: Upload a binary announcement greeting at the location level, Fetch details of binary announcement greeting at location level, Modify a binary announcement greeting, Fetch repository usage for announcements in a location, and Delete an announcement greeting in a location The remaining APIs are modified to allow referencing the files in the announcement repository (updated with the
audioAnnouncementFiles
array): Create a call queue, Get details for a call queue, Update a call queue, Read the list of call queue announcement files, Get details for an auto attendant, Create an auto attendant, Update an auto attendant, Get music on hold, Update music on hold, Get details for a call queue forced forward service, Update a call queue forced forward service, Get details for a call queue holiday service, Update a call queue holiday service, Get details for a call queue night service, Update a call queue night service, Get details for a call queue stranded calls, and Update a call queue stranded calls service.
July 6, 2023
The
numbers
andmainNumber
attributes in the following Wholesale APIs: Provision a Wholesale Customer, Update a Wholesale Customer, and Precheck a Wholesale Customer Provisioning will be deprecated in the near future.
June 28, 2023
Webex Calling detailed call history API CDR feed is included with additional "Reasons" and "User type" attributes, clarifying user types and call reasons that can be initiated, terminated or redirected. For more details about these new attributes see Detailed call history API, or Webex Calling reports for your collaboration portfolio.
June 28, 2023
We do now support limited HTML markup in message creation and edits. The supported HTML tags are limited to
h1
,h2
,h3
,ul
,ol
,u
,i
,b
and linkshref
.
June 28, 2023
Some customers and partners were provided with early beta (limited) access to a REST API and webhooks for space calls and meetings. The API is known in the field as calls-api. This API was never publicly available, and all production use was discouraged. We are going to shut down this API by Sep 30, 2023. The calls-api mentioned here is not connected to CUCM, Webex Calling, or Broadworks which we will continue to carry forward and extend their functionality. If you are interested in webhooks for meetings see the
meetings
resource in the webhooks guide and the meetings API. If you are interested in calling webhooks please see thetelephony_calls
resource in the webhooks guide and the calling API. If you are interested inWebex Calling
records, please see the Webex Calling CDR API
June 20, 2023
The Meetings API now supports the following options: requiring attendees to sign in before joining a webinar and restricting the webinar to invited attendees only. The following endpoints now support the parameters
requireAttendeeLogin
andrestrictToInvitees
: Create a Meeting, Get a Meeting, and List Meetings, and Get a Meeting Template.
June 20, 2023
In the Webex Calling APIs we will not return fields with
null
values any longer to be consistent with the rest of our API set. Fields that have a null value will be omitted from the response. This change will be enforced on August 1, 2023.
June 5, 2023
The List Meetings and List Meetings of a Meeting Series APIs now support querying ended meeting instances with the following meeting feature flags:
hasChat
,hasRecording
,hasTranscription
,hasClosedCaption
,hasPolls
, andhasQA
.
April 13, 2023
Service Apps are now Generally Available. Service Apps are a new application type, accessible to developers under 'Create a New App.' Service Apps follow a 2-step process with a developer creating an app and an admin authorizing the app in Control Hub. The result is a forever-lived machine account in the authorizing org on whose behalf API calls are made. This means you don't risk your mission-critical apps stopping just because the authorizing user left or changed their password. For more information, please see here.
April 12, 2023
A new attribute,
startLink
, has been added to the Join a Meeting API. ThestartLink
attribute can be used to start a meeting as the meeting host. Only the meeting host or cohost can generate astartLink
.
March 27, 2023
As an admin user, you can now reassign meetings to a new host using the Reassign Meetings to a New Host API with a
hostEmail
and a group ofmeetingIds
. This new API applies to Webex client 43.4.0 or higher.
March 20, 2023
The issue where the 'Get a List of Phone Numbers for a Person' API doesn't return the
directNumber
in industry standard E164 format has been fixed and will be rolled out and enforced on May 3, 2023. Clients expecting the original format using theGET /v1/people/{userId}/features/numbers
API may need to be updated.
March 7, 2023
A new attribute,
spEnterpriseGroupId
, has been added to the Provision a Broadworks Subscriber and the Update a Broadworks Subscriber APIs, for partners with thew4bwks-group-contacts-support
toggle. These APIs allow group provisioning for Enterprise for Webex For Broadworks users. For additional information, see the Group Contacts Support section of the Webex For BroadWorks Solution Guide.
March 7, 2023
In support of the SOAP API EOL/EOS that was announced on December 27, 2022, on this changelog we provide two more admin-level recording APIs for our customers to seamlessly transfer their workflows. As an admin user, you can now list meeting archive summaries with a time range on a target site and get meeting archive details with a meeting archive ID.
February 17, 2023
As an admin user or a normal meeting host, you can now list meeting attendee reports on a site. The meeting attendee reports include aggregated meeting attendee information, such as
joinedTime
,leftTime
,duration
, etc.
February 13, 2023
The events API has an undocumented, unadvertised, and never publicized feature to query events for several actor Ids in a single GET request. Due to architectural changes, we cannot honor these queries any longer and will return a 400 error. This behavior will be enforced on March 31, 2023.
February 9, 2023
The Update a Meeting PUT method is still supported and behaves the same as before, but has been deprecated. Use the Patch a Meeting via the PATCH method as a replacement.
February 9, 2023
A new attribute,
expirationMinutes
, has been added to the Join a Meeting API to specify when the join meeting link expires.
February 9, 2023
A new attribute,
panelist
, has been added to theinvitees
for the Create a Meeting API. This new attribute only applies to webinars, not meeting.
February 8, 2023
As a meeting user, you can now create a meeting, update a meeting, and list meetings with audio connection options.
January 18, 2023
As an admin user, you can now list meeting usage reports on a site. The meeting usage reports include aggregated meeting usage information, such as
totalCallInMinutes
,totalParticipants
, etc. It also includes the meetingtrackingCodes
.
January 10, 2023
The following three APIs now support specifying whether to send email to registrants: Register Meeting Registrant, Batch Register Meeting Registrants, and Batch Update Meeting Registrants status.
January 5, 2023
The
participantEmail
parameter which was used to list meetings by a meeting participant email address is no longer supported. It's been removed from the API document.
December 27, 2022
Due to reasons of security and maintainability we are going to deprecate the recordings SOAP API. In effect Jan 1, 2023 the recordings SOAP API is being deprecated and should not be used for any new projects. On June 30, 2023 the recordings SOAP API will be permanently shut down. This means customers have a full 6 months to migrate from the current recordings SOAP API to the alternative REST APIs. Depending on your use cases we recommend using the /recordings REST resource. Other functionality in the current SOAP API is replaced by the following APIs: Meeting Participants, Meetings Chat, Meetings Polls, Meetings Q&A
December 8, 2022
New attribute
extension
, has been added to POST Broadworks Subscriber and PUT Broadworks Subscriber APIs. This attribute allows the provisioning of extension numbers for Webex For Broadworks users. For additional information, see Extension Dialing in the Ordering and Provisioning section of the Webex For BroadWorks Solution Guide.
November 21, 2022
Due to CASUAL, UNKNOWN, and URL_DIALING outgoing calling permissions not being supported for modification, these values are now ignored when the following endpoints are called:
update location outgoing permission,
modify person outgoing call permissions,
outgoing workspace permissions
These values will also be removed from the corresponding GET calls in the future and callers should not depend on these values.
November 16, 2022
We are going to rename a role in the roles API. The current
Sales Administrator
role will be renamed toPartner Administrator
. This brings parity with the Control Hub experience and better reflects the responsibilities of the role. ThePartner Administrator
's privilege is to manage the specific set of customers to which they have been assigned. This change will be effective January 13, 2023.
November 10, 2022
We now provide the ability to create public spaces in the /rooms API. You can mark a space as public and give it a description. Public spaces are discoverable within the org. You can also update a public space to make it private if you are a member or compliance officer. The conversion from private to public is not yet supported.
November 10, 2022
The Download Transcript API no longer requires
meetingId
as a parameter.
October 28, 2022
We are going to update parts of our DB backend tonight Oct 28, starting at 18:30 America/Los_Angeles. There may be short service disruptions to the creation or running of applications.
October 27, 2022
Added support for creating one or more invitation sources for a meeting using the Create Invitation Sources API, and retrieving invitation sources for a meeting using the List Invitation Sources API.
October 27, 2022
As a Webex user, you can now create an ad-hoc meeting for a room by the Create a Meeting API with
adhoc
oftrue
androomId
of the target room. An ad-hoc meeting is a non-recurring instant meeting for the target room which is supposed to be started immediately after being created for a quick collaboration.
October 27, 2022
You can now Create a Meeting which is associated with a Webex room using the new attribute
roomId
, and List Meetings associated with a Webex room using the same attribute.
October 25, 2022
Org admins and partner admins are able to look up people in the people API by email. Today when specifying an email and orgId, if the user is found by their email they are returned ignoring the orgId. Upon partner request, coming February 17, 2023 we will change this behavior. When a request is made with the email address and orgId provided we will return the user only when the orgId matches the orgId of the user, otherwise an empty result will be returned. Example: User A is provisioned in org A and the following query is made GET /people?email=userAemail&orgId=orgAid -> returns user A details
GET /people?email=userAemail&orgId=orgBid -> returns an empty result, even the user A exists and can be managed by the partner
October 19, 2022
Meeting hosts and admins can now set and retrieve tracking codes for meetings via the meetings resource. They can list all available tracking codes and their options by List Meeting Tracking Codes, and retrieve tracking codes for a meeting template by Get a Meeting Template.
October 18, 2022
The List Transcripts API now supports listing all transcripts for the current user at a given site, with new return parameters
meetingTopic
andstatus
. Compliance Officers can now list all transcripts at a site via the new List Transcripts For Compliance officer API. Hosts and Compliance Officers now can delete specified transcripts via the new Delete Transcripts API.
October 12, 2022
Introduced Webex site-level APIs into the Webex RESTful API, including Get Meeting Common Settings Configuration and Update Meeting Common Settings Configuration. These APIs let you update features, options and privileges that are configured for your Webex service sites.
October 11, 2022
Admins can now set and retrieve tracking codes for their managed sites and for users. Tracking codes help site administrators understand how much a particular group within an organization is using Webex services. See the help page for more details about tracking codes.
October 7, 2022
In the meetingParticipants REST resource in order to avoid race conditions and cope with the attendee behavior, where a participant rejoins the same meeting, we will not any longer provide the
joinedTime
andleftTime
while the meeting is ongoing. Instead these fields will be correctly populated after the meeting hasended
. While the meeting is ongoing you can still poll the meetingParticipants but the joinedTime and leftTime may be set to1970-01-01T00:00:00.000Z
. If you need accurate in-meeting information, that also reflects participants rejoining the meeting, please use our webhook infrastructure with themeetingParticipants
resource. This change will be effective on November 20, 2022.
October 6, 2022
As an admin user, you can now List Site Session Types, List User Session Types, Update User Session Types.
September 13, 2022
We added the following new response fields to the discovery endpoint in login with Webex (GET /v1/.well-known/openid-configuration) to increase compatibility with other systems.
grant_types_supported
,request_parameter_supported
,request_uri_parameter_supported
,token_endpoint_auth_methods_supported
Further information can be found in the Login with Webex Guide
September 9, 2022
You can now configure custom registration forms for your webinars using the /meetings registration API. The base form can be configured graphically as described here, and the API can be used to enable and disable individual elements from the master template as required by your meeting or webinar. This enhancement further increases parity between the Webex REST and XML APIs.
September 2, 2022
Compliance Officers can list Meeting Polls and Meeting Q&A. You must request access to this endpoint via our support channel.
August 16, 2022
For Recording APIs, we've added a
Recycle Bin
feature, as well as some new and modified APIs to support it. You can move some recordings into the recycle bin using Move Recordings into Recycle Bin API. For recordings already in the recycle bin, you can choose to restore or purge them using the Restore Recordings from Recycle Bin API or the Purge Recordings from Recycle Bin API. To differentiate recordings when using List Recordings API or Admin List Recordings API, a new condition namedstatus
has been added. Ifavailable
the recording is not deleted. Ifdeleted
the recording is in the recycle bin.
August 5, 2022
The
language
field from the response body of Broadworks Subscriber APIs and from the request body of Broadworks Subscriber PUT API will soon be deprecated.
August 1, 2022
We have changed the HTTP response status code in the List Meeting Participants API. A
200
code is now returned instead of a404
when a sub-resource does not exist.
July 27, 2022
Compliance Officers and Administrators can now list all recordings for all users per site using the Admin List Recordings endpoint.
July 25, 2022
Updating the registration form is no longer supported by the Update a Meeting API.
July 20, 2022
As previously announced here (Jan 24, May 19), as well as in our newsletter, we will turn off cross-org people lookup by email. This is a security and privacy requirement. Lookup from partner admins to managed customer org users will continue to work, as will lookup by ID. Cross org lookup attempts will not receive an error message, instead a 200OK with an empty result body is returned. In our last rollout attempt we still had customers struggling which made us roll back this feature. The final rollout date is now set on July 28 evening America/Los_Angeles.
July 13, 2022
Compliance Officers can now retrieve the in-meetings closed captions via the new meeting closed captions endpoint without the host explicitly recording the meeting. You must request access to this endpoint via our support channel.
July 12, 2022
Added support for retrieving a link to join a meeting directly without logging in and entering a password with the Join a Meeting API.
July 11, 2022
The Meetings API now supports breakout sessions: Create a Meeting with breakout sessions option, Get a Meeting and List Meetings contain breakout sessions option of a meeting, Get a Meeting Template with breakout sessions option, Update Meeting Breakout Sessions of a meeting, List Meeting Breakout Sessions of a meeting, and Delete Meeting Breakout Sessions of a meeting.
July 7, 2022
We now provide the ability to set direct type (between two people only) spaces (rooms) as read only by the Compliance Officer of either participating org. This feature can be used to suppress any further communication between the two parties. Existing communication will be retained and accessible to the participants. Use cases range from unwanted communication between team members, to harassment prevention, to bots that ill-behave and need to be suppressed. The feature is executed via a settable
isReadOnly
field on the rooms resource
July 6, 2022
List Recordings now lets users retrieve recordings for meetings with a specified
siteUrl
. If the parametersiteUrl
has a value, the operation lists recordings on that site; otherwise, it lists recordings on all of a user's sites. All of a user's Webex sites can be retrieved using the Get Site List API.
June 30, 2022
Three new attributes of
phoneNumber
,callType
anddurationSecond
are returned in the response of the following meeting participant APIs: List Meeting Participants, Query Meeting Participants with Email, Get Meeting Participant Details.