DocumentationBlogSupport
Log inSign up
Log inSign up
BlogSupport
Build
Getting StartedPlatform Introduction
Embedded Apps
OverviewDeveloper GuideSubmission Checklist for Embedded Apps
Design Guidelines
MeetingsMessagingDevices
API Reference
BotsButtons and CardsIntegrationsLogin with WebexWidgetsGuest IssuerWebex ConnectInstant Connect Meeting LinksDeveloper SandboxSubmit Your AppSupport PolicyFAQs
APIs
XML API DeprecationGetting StartedREST API BasicsComplianceWebhooksWebex APIs
Admin
OverviewAdmin APIsAuthentication
Guides
Hybrid ServicesWebhooksReal-time File DLP Basics
Reference
Admin Audit EventsAuthorizationsEventsGroupsHistorical AnalyticsHybrid ClustersHybrid ConnectorsLicensesLocationsMeeting QualitiesOrganizationsPeopleRecording ReportRecordingsReport TemplatesReportsResource Group MembershipsResource GroupsRolesSecurity Audit EventsSession TypesSpace ClassificationsTracking CodesWebex Calling Organization SettingsWebex Calling Person SettingsWebex Calling Workspace SettingsWholesale Billing ReportsWorkspace LocationsWorkspace MetricsWorkspaces
Calling
Overview
Guides
Integrations and AuthorizationWebex for BroadWorksWebex for WholesaleWholesale and Broadworks Common Guide
Reference
BroadWorks Billing ReportsBroadWorks Device ProvisioningBroadWorks EnterprisesBroadWorks SubscribersCall ControlsLocationsPeopleRecording ReportVideo MeshWebex Calling Detailed Call HistoryWebex Calling Organization SettingsWebex Calling Person SettingsWebex Calling Voice MessagingWebex Calling Workspace SettingsWholesale Billing ReportsWholesale CustomersWholesale Subscribers
Contact Center
Overview
Devices
Overview
Guides
DevicesWorkspace Integrations Guide
Reference
Device ConfigurationsDevicesWorkspace LocationsWorkspace MetricsWorkspace PersonalizationWorkspacesxAPI
Meetings
Overview
Guides
Integrations and AuthorizationWebhooksWebinar GuideMeeting Resource Guide
Reference
Meeting ChatsMeeting Closed CaptionsMeeting InviteesMeeting MessagesMeeting ParticipantsMeeting PollsMeeting PreferencesMeeting Q and AMeeting QualitiesMeeting TranscriptsMeetingsMeetings Summary ReportPeopleRecording ReportRecordingsSession TypesTracking CodesVideo MeshWebhooks
Messaging
Overview
Guides
BotsIntegrations and AuthorizationWebhooksButtons and Cards
Reference
Attachment ActionsEventsMembershipsMessagesPeopleRoom TabsRoomsTeam MembershipsTeamsTracking CodesWebhooks
Webex Assistant Skills
Guides
Skills SDK GuideSkills Developer PortalSkills Reference GuideSkills UX Guide
Overview
FedRAMP
Overview
Guides
Create a BotCreate an IntegrationNotes on API Support
Webex Status API
Full API Reference
Admin Audit EventsAttachment ActionsAuthorizationsBroadWorks Billing ReportsBroadWorks Device ProvisioningBroadWorks EnterprisesBroadWorks SubscribersCall ControlsDevice ConfigurationsDevicesEventsGroupsHistorical AnalyticsHybrid ClustersHybrid ConnectorsLicensesLocationsMeeting ChatsMeeting Closed CaptionsMeeting InviteesMeeting MessagesMeeting ParticipantsMeeting PollsMeeting PreferencesMeeting Q and AMeeting QualitiesMeeting TranscriptsMeetingsMeetings Summary ReportMembershipsMessagesOrganizationsPeopleRecording ReportRecordingsReport TemplatesReportsResource Group MembershipsResource GroupsRolesRoom TabsRoomsSecurity Audit EventsSession TypesSiteSpace ClassificationsTeam MembershipsTeamsTracking CodesVideo MeshWebex Calling Detailed Call HistoryWebex Calling Organization SettingsWebex Calling Person SettingsWebex Calling Voice MessagingWebex Calling Workspace SettingsWebhooksWholesale Billing ReportsWholesale CustomersWholesale SubscribersWorkspace LocationsWorkspace MetricsWorkspace PersonalizationWorkspacesxAPI
API Changelog
SDKs
iOSAndroidBrowserNode.jsJava
Developer CommunityCertifications

Platform Introduction

Developers can extend the powerful meeting and collaboration functionality of Webex with our Webex Developer Platform family of APIs, SDKs, documentation, and examples. You can build bots, integrations, embedded apps, and guest issuer apps. Why not start by building a bot in 15 minutes?

XML API Deprecation Announcement
The Meetings-related XML APIs will be deprecated and the End-of-Support (EoS) date is planned for the second half of 2023. Cisco will continue to resolve bugs up to this date, but new features will only be implemented for the REST APIs suite. The End-of-life (EoL) timeframe for Meetings-related XML APIs is targeted for the first quarter of 2024, at which time the APIs will be retired. For more information on how to migrate from XML to REST APIs, please see the Webex Meetings XML to REST Migration Guide. User management APIs such as CreateUser, SetUser, DelUser, etc. are NOT affected by this EOL announcement.

anchorWebex Meetings
anchor

Webex Meetings offers integrated audio, video, and content sharing with highly secure web meetings from the cloud. The Webex Meetings REST API allows developers to add basic Webex scheduling functionality to their custom applications or websites. You can:

  • Create and manage meetings
  • Add and manage meeting invitees
  • Get and update meeting preferences, options, and other details
  • Get, list, and delete recordings

More APIs are on the way! Watch our blog for announcements.

anchorCreating and Using Webex Apps
anchor

The base URL for the Webex REST API is https://webexapis.com/v1/. Detailed information about each API resource and endpoint can be found in the API Reference.

The Meetings-related APIs can be used with Webex Integrations. If you aren't familiar with integrations, check out the Integrations Guide for more information. To create a new integration, select My Webex Apps from the menu under your avatar at the top of this page to get started.

To use the Webex REST API you'll need to be a Webex Meetings subscriber with a Webex account backed by Cisco Webex Common Identity (CI). If you currently use Webex, your account is backed by Common Identity. If you're using only Webex Meetings, your site will need to be on Common Identity.

anchorMeetings API Scopes
anchor

The table below lists all meetings APIs and their required scopes at different levels.

ResourceAPIUser Level ScopesAdmin/Org Level ScopesCompliance Officer Level Scopes
MeetingsList Meetings of a Meeting Seriesmeeting:schedules_readmeeting:admin_schedule_readN/A
Create a Meetingmeeting:schedules_writemeeting:admin_schedule_writeN/A
Get a Meetingmeeting:schedules_readmeeting:admin_schedule_readN/A
List Meetingsmeeting:schedules_readmeeting:admin_schedule_readN/A
Update a Meetingmeeting:schedules_writemeeting:admin_schedule_writeN/A
Delete a Meetingmeeting:schedules_writemeeting:admin_schedule_writeN/A
Get Meeting Control Statusmeeting:controls_readN/AN/A
Update Meeting Control Statusmeeting:controls_writeN/AN/A
Get registration form for a meetingmeeting:schedules_readmeeting:admin_schedule_readN/A
Get a meeting registrant’s detail informationmeeting:schedules_readmeeting:admin_schedule_readN/A
List Meeting Registrantsmeeting:schedules_readmeeting:admin_schedule_readN/A
Batch Update Meeting Registrants statusmeeting:schedules_writemeeting:admin_schedule_writeN/A
Register a Meeting Registrantmeeting:schedules_writemeeting:admin_schedule_writeN/A
List Meeting Session Typesmeeting:schedules_readmeeting:admin_schedule_readN/A
Get a Meeting Session Typemeeting:schedules_readmeeting:admin_schedule_readN/A
Meeting InviteesList Meeting Inviteesmeeting:schedules_readmeeting:admin_schedule_readN/A
Create a Meeting Inviteemeeting:schedules_writemeeting:admin_schedule_writeN/A
Create Meeting Inviteesmeeting:schedules_writemeeting:admin_schedule_writeN/A
Get a Meeting Inviteemeeting:schedules_readmeeting:admin_schedule_readN/A
Update a Meeting Inviteemeeting:schedules_writemeeting:admin_schedule_writeN/A
Delete a Meeting Inviteemeeting:schedules_writemeeting:admin_schedule_writeN/A
Meeting ParticipantsList Meeting Participantsmeeting:participants_readmeeting:admin_participants_readspark-compliance:meetings_read
Get Meeting Participant Detailsmeeting:participants_readmeeting:admin_participants_readspark-compliance:meetings_read
Update a Participantmeeting:participants_writeN/AN/A
Admit Participantsmeeting:participants_writeN/AN/A
RecordingsList Recordingsmeeting:recordings_readmeeting:admin_recordings_readspark-compliance:meetings_read
Get Recording Detailsmeeting:recordings_readmeeting:admin_recordings_readspark-compliance:meetings_read
Delete a Recordingmeeting:recordings_writemeeting:admin_recordings_writespark-compliance:meetings_write
Meeting TranscriptsList Meeting Transcriptsmeeting:transcripts_read
meeting:schedules_read
meeting:admin_transcripts_readspark-compliance:meeting_transcripts_read
spark-compliance:meetings_read
Download a meeting transcriptmeeting:transcripts_read
meeting:schedules_read
meeting:admin_transcripts_readspark-compliance:meeting_transcripts_read
spark-compliance:meetings_read
List Snippets of a Meeting Transcriptmeeting:transcripts_readN/Aspark-compliance:meeting_transcripts_read
spark-compliance:meetings_read
Get a Transcript Snippetmeeting:transcripts_readN/Aspark-compliance:meeting_transcripts_read
spark-compliance:meetings_read
Update a Transcript Snippetmeeting:transcripts_writeN/Aspark-compliance:meeting_transcripts_write
spark-compliance:meetings_write
Meeting PreferencesGet Meeting Preference Detailsmeeting:preferences_readmeeting:admin_preferences_readN/A
Get Personal Meeting Room Optionsmeeting:preferences_readmeeting:admin_preferences_readN/A
Update Personal Meeting Room Optionsmeeting:preferences_writemeeting:admin_preferences_writeN/A
Get Audio Optionsmeeting:preferences_readmeeting:admin_preferences_readN/A
Update Audio Optionsmeeting:preferences_writemeeting:admin_preferences_writeN/A
Get Video Optionsmeeting:preferences_readmeeting:admin_preferences_readN/A
Update Video Optionsmeeting:preferences_writemeeting:admin_preferences_writeN/A
Get Scheduling Optionsmeeting:preferences_readmeeting:admin_preferences_readN/A
Update Scheduling Optionsmeeting:preferences_writemeeting:admin_preferences_writeN/A
Get Site Listmeeting:preferences_readmeeting:admin_preferences_readN/A
Update Default Sitemeeting:preferences_writemeeting:admin_preferences_writeN/A
Meeting ReportsList Meeting Usage ReportsN/Ameeting:admin_config_readN/A

Guest users can interact with regular Webex users via tokens generated by a Guest Issuer application. The table below lists the meetings APIs for guest issuer and the required scopes.

ResourceAPIGuest Issuer Scopes
MeetingsGet a meeting registrant’s detail informationwebex-squared:locus_participant
spark:all
List Meeting Registrantswebex-squared:locus_participant
spark:all
Batch Update Meeting Registrants statuswebex-squared:locus_participant
spark:all
Register a Meeting Registrantwebex-squared:locus_participant
spark:all
anchorUser Level Authentication and Scopes
anchor

Webex REST API authentication is described in detail in the Integrations Guide. The following scopes are required to use the Meetings-related API resources:

ScopeUsageAccessible APIs
meeting:schedules_readRetrieve your Webex meeting lists and detailsList Meetings of a Meeting Series
Get a Meeting
List Meetings
List Meeting Invitees
Get a Meeting Invitee
List Meeting Transcripts
Download a meeting transcript
Get registration form for a meeting
Get a meeting registrant's detail information
List Meeting Registrants
List Meeting Session Types
Get a Meeting Session Type
Webhook APIs for Meetings
meeting:schedules_writeCreate, manage, or cancel your scheduled Webex meetingsCreate a Meeting
Update a Meeting
Delete a Meeting
Create a Meeting Invitee
Update a Meeting Invitee
Delete a Meeting Invitee
Create Meeting Invitees
Batch Update Meeting Registrants status
Register a Meeting Registrant
meeting:recordings_readRetrieve your Webex meeting recordings for playbackList Recordings
Get Recording Details
Webhook APIs for Recordings
meeting:recordings_writeManage or delete your meeting recordings for playbackDelete a Recording
meeting:transcripts_readRetrieve your Webex meetings transcriptsList Meeting Transcripts
Download a meeting transcript
List Snippets of a Meeting Transcript
Get a Transcript Snippet
meeting:transcripts_writeManage your Webex meeting transcript snippetsUpdate a Transcript Snippet
meeting:preferences_readRetrieve your Webex meeting preferencesGet Meeting Preference Details
Get Personal Meeting Room Options
Get Audio Options
Get Video Options
Get Scheduling Options
Get Site List
meeting:preferences_writeEdit your Webex meeting preferencesUpdate Personal Meeting Room Options
Update Audio Options
Update Video Options
Update Scheduling Options
Update Default Site
meeting:participants_readRead participant information from meetingsList Meeting Participants
Get Meeting Participant Details
Update a Participant
Admit Participants
Webhook APIs for Meeting Participants
meeting:participants_writeManage participants within meetingsUpdate a Participant
Admit Participants
meeting:controls_readRead meeting control information for in-progress meetingsGet Meeting Control Status
meeting:controls_writeUpdate meeting controls for in-progress meetingsUpdate Meeting Control Status

Remember, when choosing scopes for your app, only select the scopes your application will need.

anchorAdmin/Organization Level Authentication and Scopes
anchor

Webex developers now have the ability to leverage admin level scopes in their integrations. These new scopes allow WebEx Admin grant scopes to integrations on behalf of other users. This allows developers and admins flexibility in creating integrations to meet their needs and can lessen the need for individual users of an integration to perform an OAuth grant.

Several conditions and restrictions apply to organizations that want to authorize an integration that utilizes these admin level scopes.

  • The admin that authorizes the integration for an organization (meeting:admin_* scopes) must be a full org admin. This admin must also be a site admin for the site or sites that contain the users they wish the integration to be able to act on behalf of.
  • Partners: Partner admins who are also full org admins for their own org are not permitted to authorize integrations that use these admin level scopes for their customer's org. They are however able to authorize these types of integrations in their own org as per the previous requirement.

In support of this functionality the admin must grant the integration the following admin scopes:

ScopeUsageAccessible APIs
meeting:admin_schedule_readRetrieve meetings of all WebEx users of your organizationGet a Meeting
List Meetings
List Meetings of a Meeting Series
List Meeting Invitees
Get a Meeting Invitee
Get registration form for a meeting
Get a meeting registrant's detail information
List Meeting Registrants
Webhook APIs for Meetings
meeting:admin_schedule_writeCreate, manage, or cancel meetings of all WebEx users of your organizationCreate a Meeting
Update a Meeting
Delete a Meeting
Create a Meeting Invitee
Update a Meeting Invitee
Delete a Meeting Invitee
meeting:admin_recordings_readRetrieve recordings of all WebEx users of your organizationGet Recording Details
List Recordings
Webhook APIs for Recordings
meeting:admin_recordings_writeManage or delete recordings of all WebEx users of your organizationDelete a Recording
meeting:admin_transcripts_readRetrieve Webex meetings transcripts of all WebEx users of your organizationList Meeting Transcripts
Download a meeting transcript
meeting:admin_preferences_readRetrieve Webex meeting preferences of all WebEx users of your organizationGet Meeting Preference Details
Get Personal Meeting Room Options
Get Audio Options
Get Video Options
Get Scheduling Options
Get Site List
meeting:admin_preferences_writeManage meeting preferences of all WebEx users of your organizationUpdate Personal Meeting Room Options
Update Audio Options
Update Video Options
Update Scheduling Options
Update Default Site
meeting:admin_participants_readRead participant information from meetings for all WebEx users of your organizationGet Meeting Participant Details
List Meeting Participants
Update a Participant
Admit Participants
Webhook APIs for Meeting Participants
meeting:admin_config_readRetrieve Webex meeting configurations as an administratorList Meeting Usage Reports

The admin feature applies to both CI-enabled or CI-linked Webex sites. The managed user account (host) does not need to be CI-enabled/CI-linked.

In support of this feature, the following will be allowed as query parameters on GET requests and as valid attributes in the request body of POST and PUT commands:

  • hostEmail - When set as a query parameter on a GET request made by an admin, the response will be meetings hosted by the user specified instead of meetings hosted by the admin user. When set as part of the request body sent to a POST or PUT method by an admin, the user specified will be the host of the meeting if they belong to a site managed by that admin user. The meeting will belong to the specified host's default site unless the siteUrl attribute is used to override this.
  • siteUrl - optional - When set as a query parameter on a GET request, the response will be restricted to the meetings that belong to the specified site that are hosted by the caller of the API, or by the user specified via the hostEmail parameter. When set as part of the request body sent to a POST or PUT method, this attribute allows the caller of the API to create a meeting in a non-preferred site for a host whose account is associated with multiple sites.

Developers can become aware of the allowable values for siteUrl by querying the GET /meetingPreferences/sites API.

anchorCompliance Officer Level Authentication and Scopes
anchor

An administrator user can be associated with a specific role to become a Compliance Officer. The role of a compliance officer is to ensure that a company is conducting its business in full compliance with all laws and regulations that pertain to its particular industry, as well as professional standards, accepted business practices, and internal standards. The following scopes are required to use the Meetings-related API resources as a Compliance Officer:

ScopeUsageAccessible APIs
spark-compliance:meetings_readAccess to read recording and transcript resources in your user’s organizationGet Recording Details
List Recordings
Get Meeting Participant Details
List Meeting Participants
List Meeting Transcripts
Download a meeting transcript
List Snippets of a Meeting Transcript
Get a Transcript Snippet
Webhook APIs for Recordings
spark-compliance:meetings_writeAccess to update/delete recordings and transcripts in your user’s organizationDelete a Recording
Update a Transcript Snippet
anchorMeeting Series, Scheduled Meetings, and Meeting Instances
anchor

When using the Meetings and Meeting Invitees API resources, it's important to understand the difference between "meeting series", "scheduled meetings", and "meetings" objects. Each of these objects may be sent to or received from the API. To differentiate them, the value of the meetingType attribute in the object will be one of:

  • meetingSeries – a container object that includes all of the scheduling information for a meeting
  • scheduledMeeting – an object that represents the information associated with the scheduling information associated with a single instance of a meeting; a scheduledMeeting object can be thought of as a “child” of a meetingSeries object
  • meeting – an object that represents a meeting that is currently happening or has happened in the past; this object is created only when a meeting starts

Both meeting series and scheduled meetings may be used with the API. For example, to invite an attendee to the series, use the ID of the meeting series with the Create a Meeting Invitee endpoint. Or, to invite someone to just one scheduled instance of a meeting, use the ID of the scheduled meeting instead.

anchorMeeting States
anchor

Different meeting states are available for each type of meeting object. See "Meeting Series, Scheduled Meetings, and Meeting Instances" above for more detail.

Meeting Series
  • active – one or more future scheduled meetings exists for this series
  • inProgress – an instance of this meeting is happening now or someone has joined meeting before the host and is waiting in the lobby
  • expired – all scheduled instances of this meeting have passed
Scheduled Meeting
  • scheduled – this meeting is scheduled in the future
  • ready – this meeting is ready to start
  • ended – this meeting was started and is now over
  • missed – this meeting was scheduled in the past but never happened
Meeting
  • lobby – a locked meeting has been joined by participants, but no hosts have joined
  • inProgress – the meeting has been joined and unlocked
  • ended – a meeting has concluded
anchorMeeting Lifecycle
anchor
Meeting Auto Delete

Auto Delete Options

There's a Delete from My Meetings when completed option in Webex page of classic view. It's invisible in Webex page of modern view and the default value is unchecked.

If the Delete from My Meetings when completed option is unchecked for a meeting, there will be a mandatory Delete after 180 days option for the meeting.

Auto Delete Cases

  1. If the Delete from My Meetings when completed option is checked for a non-recurring meeting, the meeting will be deleted automatically after the scheduled end time.

  2. If the Delete from My Meetings when completed option is unchecked for a non-recurring meeting, the meeting will be deleted automatically 180 days after the scheduled end time.

  3. If the Delete from My Meetings when completed option is checked for a meeting series, the entire meeting series will be deleted automatically after the scheduled end time of the last scheduled meeting of the meeting series.

  4. If the Delete from My Meetings when completed option is unchecked for a meeting series, the entire meeting will be deleted automatically 180 days after the scheduled end time of the last scheduled meeting of the meeting series.

Meeting Series Lifecycle
  1. A meeting series is created.

  2. A scheduled meeting of the meeting series is started, or someone has joined the meeting before the host and is waiting in lobby.

  3. The ongoing scheduled meeting has ended, but it has not passed the scheduled end time of the last scheduled meeting of the meeting series, or the meeting has not yet been started and the participants which were previously waiting in lobby have left the meeting.

  4. The ongoing scheduled meeting is ended, and it has passed the scheduled end time of the last scheduled meeting of the meeting series.

  5. It has passed the scheduled end time of the last scheduled meeting of the meeting series.

  6. The meeting series is deleted manually or automatically after it's been expired.

  7. The meeting series is deleted manually.

Scheduled Meeting Lifecycle
  1. The parent meeting series is created. Any scheduled meeting other than the first one of the meeting series is scheduled and it can be started in the future.

  2. The parent meeting series is created. The first scheduled meeting of the meeting series is ready and it can be started immediately.

  3. It has passed the scheduled end time of the previous scheduled meeting. The subsequent scheduled meeting becomes ready and it can be started immediately.

  4. The previous ready scheduled meeting has been started and ended, and it has passed its scheduled end time. This scheduled meeting becomes ended.

  5. The previous ready scheduled meeting has never been started, and it has passed its scheduled end time. This scheduled meeting becomes missed.

  6. The scheduled meeting is deleted manually or it's deleted when the parent meeting series is deleted maunally.

  7. The scheduled meeting is deleted manually or it's deleted when the parent meeting series is deleted maunally or automatically.

  8. The scheduled meeting is deleted manually or it's deleted when the parent meeting series is deleted maunally.

  9. The scheduled meeting is deleted manually or it's deleted when the parent meeting series is deleted maunally or automatically.

Meeting Lifecycle
  1. A locked meeting has been joined by participants, but no hosts have joined.

  2. The meeting has been started and not ended yet.

  3. The participants in lobby have been admitted to meeting.

  4. The meeting has ended.

anchorMeeting Template Locales
anchor

Meetings can be created by meeting templates. The list of meeting templates that is available for the authenticated user can be retrieved from List Meeting Templates API with different values of locale. All the locales supported by Webex are listed below.

LanguageCountry/RegionLocale NameDefault Locale
BulgarianBulgariabg_BG
Castilian SpanishSpaines_SP
Chinese (Simplified)Chinazh_CN
Chinese (Traditional)Taiwanzh_TW
CroatianCroatiahr_HR
CzechCzech Republiccs_CZ
DanishDenmarkda_DK
DutchNetherlandsnl_NL
EnglishUnited Kingdomen_GB
EnglishUnited Statesen_USYes
FrenchCanadafr_CA
FrenchFrancefr_FR
GermanGermanyde_DE
HungarianHungaryhu_HU
ItalianItalyit_IT
JapaneseJapanja_JP
KoreanKoreako_KR
NorwegianNorwayno_NO
PolishPolandpl_PL
PortugueseBrazilpt_BR
RomanianRomaniaro_RO
RussianRussiaru_RU
SerbianSerbiasr_RS
SpanishMexicoes_ES
SwedishSwedensv_SE
TurkishTurkeytr_TR
anchorRestrictions on Updating a Meeting
anchor

When updating a meeting, there are different restrictions for different meeting types. It's important for a developer to understand these restrictions to avoid confusion and handle any restriction-related errors when they occcur.

There are some general rules for updating a meeting. They are listed below.

Rule 1. start and end cannot be a time before the current time

This rule applies to meeting series and scheduled meeting.

When updating a meeting series or a scheduled meeting, the start and end in specified timezone cannot be a time before the current time. For example, assume that the current time is 2021-05-28T14:00:00+08:00, if update a meeting series, or a scheduled meeting with start of 2021-05-27T14:00:00+08:00 and timezone of Asia/Shanghai, it will fail saying that "Parameter 'start' or 'end' is before current time". Please note that the default timezone is UTC if not specified explicitly.

Rule 2. Limit for duration between start and end

This rule applies to meeting series and scheduled meeting.

Duration between start and end cannot be shorter than 10 minutes or longer than 24 hours.

Rule 3. Update is forbidden when an associated meeting instance is in progress

This rule applies to meeting series and scheduled meeting.

When a meeting instance is in-progress, its parent scheduled meeting and grandparent meeting series cannot be updated. In fact, when a meeting instance is in-progress, the state of the parent scheduled meeting is ready which means that currently this scheduled meeting is ready to join, and the state of the grandparent meeting series is inProgress which means that a meeting instance of the series is currently happening. Neither the parent scheduled meeting, nor the grandparent meeting series can be updated until the ongoing meeting instance is ended. If break this rule, it'll fail saying that "Meeting is in progress".

Rule 4. Update is forbidden for a meeting instance

This rule applies to meeting instance.

It's totally forbidden to update any meeting instance of any state. It fails with an error message like "Meeting ID '06263e1088604fc1b3ca17fbe49fe97d_I_195989045032040979' is not allowed for this API."

Rule 5. Update is forbidden to cross recurring interval

This rule applies to scheduled meeting.

What is a recurring interval

When a meeting series has been scheduled, each scheduled meeting of this meeting series has its own "territory of time". It means that any other scheduled meeting of the same meeting series cannot be updated to fall into the range of time of this scheduled meeting. Specifically, each scheduled meeting has its original timezone when the parent meeting series was scheduled. It can be an explicitly specified value such as Asia/Shanghai or UTC by default if not specified explicitly. Generally, the recurring interval of a scheduled meeting begins at 00:00:00 (inclusive) in the original timezone of the day of start, and ends at 00:00:00 (exclusive) in the original timezone of the day of the next scheduled meeting of the same meeting series. However, there's exception for the first and the last scheduled meeting of a meeting series. The first one has no beginning, and the last one has no end. It's explained in detail below with examples of daily meetings and weekly meetings. The rule for other meetings, e.g. yearly meetings, is similar.

1. Recurring intervals of a daily meeting series

Fig. 1 Recurring intervals of a daily meeting series

Fig. 1 illustrates the recurring intervals of a daily meeting series with four scheduled meetings.

  • Recurring interval of d1: No beginning, to 2021-04-20T00:00:00+08:00 (exclusive).
  • Recurring interval of d2: From 2021-04-20T00:00:00+08:00 (inclusive) to 2021-04-21T00:00:00+08:00 (exclusive).
  • Recurring interval of d3: From 2021-04-21T00:00:00+08:00 (inclusive) to 2021-04-22T00:00:00+08:00 (exclusive).
  • Recurring interval of d4: From 2021-04-22T00:00:00+08:00 (inclusive), no end.
2. Recurring intervals of a weekly meeting series

Fig. 2 Recurring intervals of a weekly meeting series

Fig. 2 illustrates the recurring intervals of a weekly meeting series with four scheduled meetings. Please note that recurring intervals of a weekly meeting can be of different lengths, and a single recurring interval may cross days.

  • Recurring interval of w1: No beginning, to 2021-06-04T00:00:00+08:00 (exclusive).
  • Recurring interval of w2: From 2021-06-04T00:00:00+08:00 (inclusive) to 2021-06-08T00:00:00+08:00 (exclusive).
  • Recurring interval of w3: From 2021-06-08T00:00:00+08:00 (inclusive) to 2021-06-11T10:00:00+08:00 (exclusive).
  • Recurring interval of w4: From 2021-06-11T10:00:00+08:00 (inclusive), no end.
3. Recurring intervals of the first and last scheduled meetings of a meeting series

Fig. 3 Recurring intervals of the first and last scheduled meetings of a meeting series

Please pay attention to the recurring intervals of the first and the last scheduled meetings of a meeting series:

  • The recurring interval of the first scheduled meeting of a meeting series has no beginning. For instance, Fig. 3 illustrates recurring intervals of a daily meeting series with three scheduled meetings. The recurring interval of d1 which is highlighted in green has no beginning and ends at 2021-04-20T00:00:00+08:00 (exclusive). Therefore, d1 can be updated to d1-01 or d1-02.

  • The recurring interval of the last scheduled meeting of a meeting series has no end. For instance, in Fig. 3, the recurring interval of d3 which is highlighted in blue begins at 2021-04-21T00:00:00+08:00 and has no end. Therefore, d3 can be updated to d3-01 or d3-02.

Cross-recurring-interval update is forbidden

Based on the recurring interval concept, cross-recurring-interval update is forbidden. If break this rule, it'll fail with an error message like "meeting.err.two_meeting_schedule_at_same_day". Specifically, meetings RESTful API examines start against crossing-recurring-interval behavior when updating a scheduled meeting, but it doesn't examine end against this rule.

1. Update scheduled meetings of a daily meeting series successfully

Fig. 4 Update scheduled meetings of a daily meeting series successfully

Fig. 4 illustrates non-cross-recurring-interval updates for scheduled meetings of a daily meeting series. All the updates in Fig. 4 are within the same recurring interval and succeed. For example:

  • d1 to d1-s1: This update is within d1's recurring interval. It makes the previously missed d1 to be ready again.
  • d2 to d2-s1: This update is within d2's recurring interval. It makes d2 a little earlier in the same day.
  • d2 to d2-s2: This update is within d2's recurring interval. It makes d2 a little later in the same day.
  • d4 to d4-s1: This update is within d4's recurring interval. It makes d4 a little earlier in the same day.
  • d4 to d4-s2: This update is within d4's recurring interval. It makes d4 a little later in the same day.
  • d4 to d4-s2: This update is within d4's recurring interval. It makes d4 a little later in the same day.
  • d4 to d4-s3 or d4-s4: This update is within d4's recurring interval. It moves d4 to the next day or even later. However, they are both within the recurring interval of d4 since d4 is the last scheduled meeting of the parent meeting series. It doesn't break rule 5.
2. Update scheduled meetings of a daily meeting series crossing recurring interval

Fig. 5 Update scheduled meetings of a daily meeting series crossing recurring interval

Fig. 5 illustrates cross-recurring-interval updates for scheduled meetings of a daily meeting series. All the updates in Fig. 5 break rule 5 and fail. For example:

  • d1 to d1-f1: This update moves d1 to a time before the current time and breaks rule 1.
  • d2 to d2-f1: This update moves d2 to the previous day and breaks rule 5.
  • d2 to d2-f2: This update moves d2 to the next day and breaks rule 5.
  • d3 to d3-f4: This update moves d3 to two days later and breaks rule 5.
  • d4 to d4-f2: This update moves d4 to two days ago and breaks rule 5.
3. Update scheduled meetings of a weekly meeting series successfully

Fig. 6 Update scheduled meetings of a weekly meeting series successfully

Fig. 6 illustrates non-cross-recurring-interval updates for scheduled meetings of a weekly meeting series. All the updates in Fig. 6 are within the same recurring interval and succeed. For example:

  • w1 to w1-s1: This update is within w1's recurring interval. It moves the previously missed w1 to the next day and makes it ready again. It crosses day, but it doesn't cross recurring interval. So, it doesn't break rule 5.
  • w1 to w1-s2: This update is within w1's recurring interval. It moves the previously missed w1 to two days later and makes it ready again. It crosses day, but it doesn't cross recurring interval. So, it doesn't break rule 5.
  • w2 to w2-s1: This update is within w2's recurring interval. It moves w2 a little earlier in the same day.
  • w2 to w2-s3: This update is within w2's recurring interval. It moves w2 three days later. It crosses day, but it doesn't cross recurring interval. So, it doesn't break rule 5.
  • w4 to w4-s2: This update is within w4's recurring interval. It moves w4 to the two days later or even later than that. However, it's within w4's recurring interval since w4 is the last scheduled meeting of the parent meeting series. It doesn't break rule 5.
4. Update scheduled meetings of a weekly meeting series crossing recurring interval

Fig. 7 Update scheduled meetings of a weekly meeting series crossing recurring interval

Fig. 7 illustrates cross-recurring-interval updates for scheduled meetings of a weekly meeting series. All the updates in Fig. 7 break rule 5 and fail. For example:

  • w1 to w1-f1: This update moves w1 to a time before the current time and breaks rule 1.
  • w1 to w1-f2: This update moves w1 to the next recurring interval and breaks rule 5.
  • w2 to w2-f1: This update moves w2 to the previous recurring interval and breaks rule 5.
  • w2 to w2-f2: This update moves w2 to the next recurring interval and breaks rule 5.
  • w2 to w2-f3: This update moves w2 to the last recurring interval and breaks rule 5.
  • w4 to w4-f2: This update moves w4 to the second recurring interval and breaks rule 5.
5. Boundary cases

Fig. 8 Boundary cases

Meetings RESTful API examines start against crossing-recurring-interval behavior when updating a scheduled meeting, but it doesn't examine end against this rule. In other words, if the target start crosses recurring interval, the update breaks rule 5; if the target start doesn't cross recurring interval, it doesn't break rule 5.

Fig. 8 illustrates various boundary cases of updating a scheduled meeting of a daily meeting series. The upper part is moving d1 towards d2 and the lower part is moving d2 towards d1.

The upper part is forward boundary cases:

  • d1 to d1-b1: This update doesn't cross recurring interval. It doesn't break rule 5.
  • d1 to d1-b2: The target end is on the boundary but the target start doesn't cross boundary. It doesn't break rule 5.
  • d1 to d1-b3: The target end is in the next recurring interval but the target start doesn't cross boundary. It doesn't break rule 5.
  • d1 to d1-b4: The target start is on the boundary and the target end is in the next recurring interval. Since a recurring interval is left-inclusive and right-exclusive, it breaks rule 5.
  • d1 to d1-b5: Both the target start and end are in the next recurring interval. It breaks rule 5.

The lower part is backward boundary cases:

  • d2 to d2-b1: This update doesn't cross recurring interval. It doesn't break rule 5.
  • d2 to d2-b2: The target start is on the boundary. Since a recurring interval is left-inclusive and right-exclusive, it doesn't break rule 5.
  • d2 to d2-b3: The target start is in the previous recurring interval. It breaks rule 5.
  • d2 to d2-b4: The target start is in the previous recurring interval and the target end is on the boundary. It breaks rule 5.
  • d2 to d2-b5: Both the target start and end are in the previous recurring interval. It breaks rule 5.

Fig. 9 Cross-day cases

There're extreme situations where the parent meeting series was scheduled crossing-day. Fig.9 illustrates a daily meeting series of which the start is in some day while the end is in the next day. d2, d3 and d4 are successive scheduled meetings of the series. Here're the recurring intervals of d3 and d4:

  • Recurring interval of d3: From 2021-04-20T00:00:00+08:00 (inclusive) to 2021-04-21T00:00:00+08:00 (exclusive).
  • Recurring interval of d4: From 2021-04-21T00:00:00+08:00 (inclusive) to 2021-04-22T00:00:00+08:00 (exclusive).

The following updates break rule 5:

  • d3 to d3-01: The target start is in the previous recurring interval. It breaks rule 5.
  • d3 to d3-02: Same as above.
  • d3 to d3-03: Same as above.
  • d3 to d3-10: The target start is in the next recurring interval. It breaks rule 5.
  • d3 to d3-11: Same as above.
Restrictions table

To summarize, the restrictions on updating a meeting of different types are listed in the table below.

Meeting typeRestrictions on updating meeting of this type
Meeting seriesRule 1, 2, 3
Scheduled meetingRule 1, 2, 3, 5
MeetingRule 4
  • Webex Meetings
  • Creating and Using Webex Apps
  • Meetings API Scopes
  • User Level Authentication and Scopes
  • Admin/Organization Level Authentication and Scopes
  • Compliance Officer Level Authentication and Scopes
  • Meeting Series, Scheduled Meetings, and Meeting Instances
  • Meeting States
  • Meeting Lifecycle
  • Meeting Template Locales
  • Restrictions on Updating a Meeting

Connect

Support

Developer Events

Contact Sales

Handy Links

Webex Ambassadors

Webex App Hub

Resources

Open Source Bot Starter Kits

Download Webex

DevNet Learning Labs

Terms of Service

Privacy Policy

Cookie Policy

Trademarks

© 2023 Cisco and/or its affiliates. All rights reserved.