List folder contents
GET/folder.contents
List the meetings and Magicasts filed in a folder, newest first, with each item's metadata.
Reading the folder is what grants access to these rows. A meeting or
Magicast is included even when the caller would not see it on
meeting.list or
magicast.list. If the item was deleted after
it was filed, type, id, and addedAt are still returned and the
embedded meeting or magicast object is omitted.
A personal token that can read the folder can then call
meeting.info,
meeting.transcript, and
meeting.prompt for a filed meeting, and
magicast.info for a filed Magicast. Those
calls need meetings:read or magicast:read in addition to
folders:read. magicast.shareLink
stays limited to the Magicast owner. Organization follow-ups on meetings
still follow Meeting width.
Access: Organization and Personal. Same visibility as
folder.info: a folder the caller cannot see
returns 404 folder_not_found.
Required scope: folders:read
OpenAPI Spec: chat-v1.json
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 405
- 500
Folder contents retrieved successfully
Bad request. Missing or invalid id, type, date, limit, or cursor.
Presented invalid authentication credentials.
Token is missing folders:read.
Folder not found, or not visible to the caller (folder_not_found).
An unsupported method was requested.
An internal error occurred.