How to relate a webex embedded API meeting id to a REST API meeting ID

[mark@avarobotics.com]

An embedded app can get a meeting object that includes an id value and a conferenceId value. My embedded app also has an integration with the REST API, and I want to get more meeting information from the REST API using https://webexapis.com/v1/meetings/{meetingId}

It looks like the embedded meeting id is the id of a meeting series, not the specific meeting instance. From observation it looks like I can construct the id of the meeting instance with <embedded API meeting id> + "_I_" + <embedded API meeting conferenceId>. Is this always true, for all types of meetings? Is this documented anywhere? Can I rely on this behavior, or can it change without notice?

I understand these IDs can be used in the REST API only when app.isPrivateDataAvailable is true.

References:

https://developer.webex.com/docs/embedded-apps-api-reference#type-definitions

https://developer.webex.com/docs/api/v1/meetings/get-a-meeting

[Raffaele Lagana · Accepted solution]

You are correct with that meeting instance ID format, that's how it's built. As far as we know there are no plans to change this in future.

Usually, the recommended way to get the meeting instance ID through API, is to make a GET request to https://webexapis.com/v1/meetings and include meetingType=meeting as a parameter. This will return the single meeting Instances of the meeting Series (even when there is only one meeting in the series).

Request would look like this: https://webexapis.com/v1/meetings?meetingType=meeting . You can also add state, hostEmail, from and to values to help filtering the data. What you get in return then is the meetingId will be in the format XXXX_I_ZZZZ, or <meetingSeriesID>_I_<conferenceId>.