API Referenceengagements

List Engagements (POST)

Beta
Lists the engagement records.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
typelist of enumsOptional
Filters for engagement of the provided types.
cursorstringOptionalformat: "text"
The cursor to resume iteration from. If not provided, then iteration starts from the beginning.
external_reflist of stringsOptional

Filters for meetings with the provided external_refs.

limitintegerOptional
The maximum number of engagements to return.
memberslist of stringsOptional
Filters for engagement of the provided members.
modeenumOptional

The iteration mode to use. If “after”, then entries after the provided cursor will be returned, or if no cursor is provided, then from the beginning. If “before”, then entries before the provided cursor will be returned, or if no cursor is provided, then from the end. Entries will always be returned in the specified sort-by order.

Allowed values:
parentlist of stringsOptional
Filters for engagements with the provided parent.
sort_bylist of stringsOptional
Fields to sort the engagements by and the direction to sort them.

Response

Success.
engagementslist of objects
The list of engagements.
next_cursorstring or nullformat: "text"
The cursor used to iterate subsequent results in accordance to the sort order. If not set, then no later elements exist.
prev_cursorstring or nullformat: "text"
The cursor used to iterate preceding results in accordance to the sort order. If not set, then no prior elements exist.

Errors