Get your latest recordings
const url = 'https://collab.work.optidata.cloud/api/users/2d9e8f70-1a3b-4c5d-8e9f-a0b1c2d3e4f5/dashboard?limit=5';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://collab.work.optidata.cloud/api/users/2d9e8f70-1a3b-4c5d-8e9f-a0b1c2d3e4f5/dashboard?limit=5' \ --header 'Authorization: Bearer <token>'Your most recent recordings, newest first, each with its link to the
recording page — the data behind the Call widget of the Optiwork home
screen. Only the recordings you made are listed, with their transcripts.
Pass your own user uuid as user: another user’s uuid answers 403,
company super-administrators included.
Authorizations
Section titled “Authorizations”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”Your own user uuid.
Query Parameters
Section titled “Query Parameters”Number of recordings to return.
Responses
Section titled “ Responses ”Your latest recordings.
object
The person who made the recording.
creating,started— being recorded.stopped_locally,pending,processing— recorded; being saved and processed.stopped— done; the transcript follows when ready.failed— interrupted; seestartRecordingRecovery.
manual when a participant pressed record; automatic for the audio
recorded to produce AI meeting notes; audio_only_sibling for the
audio track kept next to a manual recording.
Whether a copy was saved to Optiwork Drive.
The public link, when the recording has one.
Address of the recording page in Optiwork.
Technical details of the recording. Its content may change; do not rely on it.
object
Internal id. Address the room by hash or custom_hash, never by this id.
Your company’s id.
The room’s identifier and link.
The permanent-link identifier, when the room has one.
The user who created the room.
on_site for rooms holding an uploaded in-person meeting; null or virtual for video meetings.
Whether AI meeting notes are on for this room.
Whether participants are prevented from turning AI notes off.
The room’s link, to share with participants.
object
Maximum number of people in the room at once.
Whether people without an Optiwork account may join.
Who may enter the room and whether they must ask first:
automatic— anyone with the link enters straight away; guests without an account appear as “Guest”.no_request— anyone with the link enters without asking; guests type their name first.unauthenticated_must_request— signed-in Optiwork users enter; guests type their name and ask to join.authenticated_only_no_request— only signed-in Optiwork users, without asking; guests are turned away.authenticated_only_must_request— only signed-in Optiwork users, and they ask to join; guests are turned away.any_must_request— everyone asks to join; guests type their name first.
Present on getRoom and listRooms.
One person’s presence in a room.
object
null for guests without an Optiwork account.
admin for the room owner, moderator for co-hosts, guest for everyone else.
Details a guest gave when joining.
object
Where the guest gets the meeting summary. Shown only on your own participation, or to the room’s owner, its moderators and company super-administrators.
State of the person’s request to join, in rooms where joining must be requested.
object
The user’s display preferences (language, theme, time zone).
object
The user’s display preferences (language, theme, time zone).
Who was in the meeting while it was recorded.
One person’s presence in a room.
object
null for guests without an Optiwork account.
admin for the room owner, moderator for co-hosts, guest for everyone else.
Details a guest gave when joining.
object
Where the guest gets the meeting summary. Shown only on your own participation, or to the room’s owner, its moderators and company super-administrators.
State of the person’s request to join, in rooms where joining must be requested.
object
The user’s display preferences (language, theme, time zone).
People and groups the recording is shared with.
object
The public-link setting, when the recording has a public link.
object
AI summary of the meeting.
AI key points, as a JSON-encoded string: an array of
{ "title", "items": [string] } sections.
The full transcript as produced by the speech-to-text engine (utterances, words, speakers, timings). Its exact shape depends on the engine and may change.
Examples
[ { "id": 1739, "status": "stopped", "type": "manual", "user_id": 59, "room_id": 10783, "name": "Friday, June 26, 2026 3:25 PM", "duration_ms": 904161, "chunks_count": 0, "is_drive_saved": false, "sibling_recording_id": null, "created_at": "2026-06-26T18:25:18.000000Z", "updated_at": "2026-06-26T18:40:22.000000Z", "stopped_at": "2026-06-26T18:40:22.000000Z", "is_processing": false, "is_in_progress": false, "public_link_url": null, "link": "https://collab.work.optidata.cloud/urn/owt42/v1-4-eyJyZWNvcmRpbmdfaWQiOjE3MzksInJvb21faWQiOjEwNzgzfQ==", "permissions": [], "link_permission": null }]No authentication key was sent, or it is malformed.
Authentication failures use an error key rather than message.
object
Examples
No bearer token sent
{ "error": "JWT passport exception: Missing bearer token in request"}user is not your own uuid.
A refused or not-found request.
object
Examples
{ "message": "You do not have permission to view this dashboard."}No user has this uuid.
A refused or not-found request.
object
Examplegenerated
{ "message": "example"}The authentication key is expired or not recognised. Get a fresh one and retry.
Authentication failures use an error key rather than message.
object
Examples
{ "error": "JWT passport expired: Passport expired"}limit is missing or out of range.
object
The first validation message.
Validation messages keyed by field name.
object
Examples
{ "message": "The limit field is required.", "errors": { "limit": [ "The limit field is required." ] }}