Search meetings

post

https://example.com/public-api/v1/meetings/list

List meetings that match the supplied filters.

Results use cursor pagination. Send page_info.end_cursor as after to
retrieve the next page.

Body Params

Request body for POST /meetings/list — filters and pagination.

first

integer

1 to 200

Defaults to 50

Forward page size. 1 to 200.

offset

0 to 5000

Offset-based pagination start (0 to 5000). Mutually exclusive with after — sending both is a 422.

after

length ≤ 128

Opaque pagination cursor from a previous response's page_info.end_cursor (next page) or page_info.start_cursor (previous page). Omit for the first page. When set, the page size comes from the cursor. Mutually exclusive with offset.

keyword

length ≤ 128

Free-text match against the video title and participant names.

starts_at

Lower bound on the meeting start time (inclusive).

ends_at

Upper bound on the meeting start time (inclusive).

platforms

array of objects

length ≤ 100

Restrict to these recording platforms.

Platforms

participant_ids

array of strings

length ≤ 100

Restrict to videos with these participant user ids (numeric).

Participant Ids

host_ids

array of strings

length ≤ 100

Restrict to videos hosted by these user ids (numeric).

Host Ids

my_meetings

boolean

Defaults to false

When true, restrict to meetings the caller hosted or joined.

duration__gte

0 to 2147483647

Minimum meeting duration, in seconds.

duration__lte

0 to 2147483647

Maximum meeting duration, in seconds.

playback_users__gte

0 to 2147483647

Minimum number of distinct playback users.

playback_users__lte

0 to 2147483647

Maximum number of distinct playback users.

status

VideoStatus | null

Restrict to videos in this analysis status.

tag_ids__include_and

array of strings

length ≤ 100

Require videos to carry all of these tag ids.

Tag Ids Include And

tag_ids__include_or

array of strings

length ≤ 100

Require videos to carry any of these tag ids (ignored if tag_ids__include_and is set).

Tag Ids Include Or

tag_ids__exclude

array of strings

length ≤ 100

Exclude videos carrying any of these tag ids.

Tag Ids Exclude

tag__exists

When set, restrict to videos that do (true) / do not (false) carry tags.

video_ids

array of strings

length ≤ 100

Restrict to these specific video ids.

Video Ids

comment

length ≤ 128

Free-text match against comments on the video.

Responses

200A page of matching meetings and pagination cursors.

400The tenant could not be resolved from the request.

401Error envelope (public_api.unauthorized).

403The request is not allowed for the current tenant or access configuration.

404Error envelope (public_api.not_found).

409Error envelope (public_api.conflict).

413The request body exceeds the maximum allowed size.

422Validation Error

429Rate limit exceeded. Wait for Retry-After seconds before retrying.

502Error envelope (public_api.internal_error).

503The request could not be served right now. Please retry.

504Error envelope (public_api.request_timeout).