company logo

Help center

Contact Support Team
Sembly ๐Ÿ‡บ๐Ÿ‡ธSembly ๐Ÿ‡ช๐Ÿ‡บ
All collectionsHow-to ArticlesWorkspace APIReference

Reference

Endpoint reference and schemas.

Inna KhomaยทNovember 16, 2026

Endpoint reference

Base URLs:

  • https://api-us.sembly.ai: US region

  • https://api-eu.sembly.ai: EU region

List workspace users

GET /v1/workspace/users

All users of the workspace, including deactivated accounts, newest first.

Parameter

In

Type

Required

Description

email_contains

query

string or null

no

Case-insensitive substring of the email.

id

query

string or null

no

Return only this user id.

offset

query

integer

no

Rows to skip. (min 0, max 1000000, default 0)

limit

query

integer

no

Page size. (min 1, max 200, default 50)

Status

Body

Description

200

UserListResponse

Successful Response

400

ErrorResponse

A parameter is invalid. Code invalid_parameters.

401

ErrorResponse

Token is missing or not usable: missing_token, invalid_token, disabled_token or expired_token.

403

ErrorResponse

The workspace or client may not use the API: workspace_disabled, workspace_not_eligible, plan_not_allowed, api_disabled or ip_not_allowed.

429

ErrorResponse

Rate limit exceeded. Code rate_limited. Headers: Retry-After.

500

ErrorResponse

Unexpected server error. Code internal_error. Safe to retry.

List meetings

GET /v1/workspace/meetings

Meetings of the workspace, ordered by started_at (newest first), then by id. Private meetings are included. Archived, welcome, scheduled, not scheduled and duplicate meetings and meetings without a recording are not listed. Poll with processed_after to find newly processed meetings: read every page, then move your checkpoint to the largest processed_at you saw.

Parameter

In

Type

Required

Description

status

query

list of string

no

Repeat to combine. Allowed: processed, in_progress, failed.

owner

query

string or null

no

Owner user id.

accessible_by

query

list of string

no

User ids, repeat to combine, at most 10. Only meetings accessible to all of them. A filter, not an authorization check: your app decides what each of its users may see.

started_from

query

string or null

no

ISO 8601. Inclusive. Without a timezone, UTC is assumed. Example: 2026-10-01T00:00:00Z.

started_to

query

string or null

no

ISO 8601. Inclusive. Without a timezone, UTC is assumed. Example: 2026-10-31T23:59:59Z.

processed_after

query

string or null

no

ISO 8601. Only meetings processed strictly after this moment. Without a timezone, UTC is assumed. Example: 2026-10-29T10:00:00Z.

title_contains

query

string or null

no

Case-insensitive substring of the title.

offset

query

integer

no

Rows to skip. (min 0, max 1000000, default 0)

limit

query

integer

no

Page size. (min 1, max 200, default 50)

Status

Body

Description

200

MeetingListResponse

Successful Response

400

ErrorResponse

A parameter is invalid. Code invalid_parameters.

401

ErrorResponse

Token is missing or not usable: missing_token, invalid_token, disabled_token or expired_token.

403

ErrorResponse

The workspace or client may not use the API: workspace_disabled, workspace_not_eligible, plan_not_allowed, api_disabled or ip_not_allowed.

429

ErrorResponse

Rate limit exceeded. Code rate_limited. Headers: Retry-After.

500

ErrorResponse

Unexpected server error. Code internal_error. Safe to retry.

Get a meeting with its content

GET /v1/workspace/meetings/{meeting_uuid}

Meeting details. Add notes, tasks and transcript to include them. Content is returned only for processed meetings. A meeting the list leaves out returns 404 meeting_not_found.

Parameter

In

Type

Required

Description

meeting_uuid

path

uuid

yes

Meeting uuid from GET /meetings.

transcript

query

integer

no

1 to include the transcript. (min 0, max 1, default 0)

notes

query

integer

no

1 to include the notes. (min 0, max 1, default 0)

tasks

query

integer

no

1 to include the tasks. (min 0, max 1, default 0)

Status

Body

Description

200

MeetingContentResponse

Successful Response

400

ErrorResponse

A parameter is invalid. Code invalid_parameters.

401

ErrorResponse

Token is missing or not usable: missing_token, invalid_token, disabled_token or expired_token.

403

ErrorResponse

The workspace or client may not use the API: workspace_disabled, workspace_not_eligible, plan_not_allowed, api_disabled or ip_not_allowed.

404

ErrorResponse

The meeting does not exist in this workspace. Code meeting_not_found.

429

ErrorResponse

Rate limit exceeded. Code rate_limited. Headers: Retry-After.

500

ErrorResponse

Unexpected server error. Code internal_error. Safe to retry.

Get a page of the transcript

GET /v1/workspace/meetings/{meeting_uuid}/transcript

Transcript items in spoken order. Follow next_cursor until it is null. The list is empty until the meeting is processed.

Parameter

In

Type

Required

Description

meeting_uuid

path

uuid

yes

Meeting uuid from GET /meetings.

cursor

query

string or null

no

next_cursor of the previous page. Opaque; do not build it yourself. Example: WzEuNSwzXQ.

limit

query

integer

no

Page size. (min 1, max 2000, default 500)

Status

Body

Description

200

TranscriptPage

Successful Response

400

ErrorResponse

A parameter is invalid. Codes invalid_parameters or invalid_cursor.

401

ErrorResponse

Token is missing or not usable: missing_token, invalid_token, disabled_token or expired_token.

403

ErrorResponse

The workspace or client may not use the API: workspace_disabled, workspace_not_eligible, plan_not_allowed, api_disabled or ip_not_allowed.

404

ErrorResponse

The meeting does not exist in this workspace. Code meeting_not_found.

429

ErrorResponse

Rate limit exceeded. Code rate_limited. Headers: Retry-After.

500

ErrorResponse

Unexpected server error. Code internal_error. Safe to retry.

Schemas

UserListResponse

Field

Type

Required

Description

data

list of WorkspaceUserItem

yes

Users, newest account first.

pagination

Pagination

yes

Offset pagination of this list.

ErrorResponse

The body of every non-2xx response.

Field

Type

Required

Description

error

ErrorBody

yes

What went wrong. Branch on code.

MeetingListResponse

Field

Type

Required

Description

data

list of MeetingListItem

yes

Meetings, newest started_at first.

pagination

Pagination

yes

Offset pagination of this list.

MeetingContentResponse

Field

Type

Required

Description

uuid

uuid

yes

Meeting id. Use it to fetch content. It does not change once the meeting is recorded. A failed meeting scheduled from a calendar event can get a new id when the event is edited; the old id then returns 404 meeting_not_found.

web_url

string

yes

Opens the meeting in the Sembly web app. The person opening it signs in and needs access to the meeting.

title

string or null

yes

Meeting title. Null when the meeting has none.

started_at

datetime or null

yes

When the meeting started, UTC.

finished_at

datetime or null

yes

When the meeting ended, UTC. Null while it is running or when unknown.

duration_seconds

integer

yes

Recorded duration in seconds. 0 when unknown.

meeting_type

string or null

yes

Meeting type, lowercase, for example generic.

platform

MeetingPlatform

yes

Where the meeting took place or where the recording came from. New values may be added; treat unknown ones as other.

status

MeetingStatus

yes

processed once content is available, and it stays processed.

processed_at

datetime or null

yes

When processing finished. Null until status is processed.

owner

UserRef or null

yes

Workspace user who owns the meeting. Null when the owner left the workspace.

accessible_by

list of UserRef

yes

Workspace users who have access to the meeting.

calendar_event

CalendarEventRef or null

yes

Calendar event the meeting was scheduled from. Null for uploads, recordings and meetings added without a calendar event.

notes

NotesContent or null

no

Present only with notes=1 and a processed meeting. Null when none exist.

tasks

list of TaskContent or null

no

Present only with tasks=1 and a processed meeting.

transcript

list of TranscriptItem or null

no

Present only with transcript=1 and a processed meeting. Use the transcript endpoint for long meetings.

TranscriptPage

Field

Type

Required

Description

status

MeetingStatus

yes

Processing state of the meeting.

items

list of TranscriptItem

yes

Empty until the meeting is processed.

next_cursor

string or null

yes

Pass as cursor to get the next page. Null on the last page.

WorkspaceUserItem

Field

Type

Required

Description

id

uuid

yes

User id. Use it in owner and accessible_by filters.

email

string

yes

Email of the user, unique in the workspace.

full_name

string

yes

Display name. Empty when the user has not set one.

joined_at

datetime

yes

When the account was created, UTC.

is_active

boolean

yes

False for deactivated accounts, which are still listed.

Pagination

Field

Type

Required

Description

offset

integer

yes

Offset of the first returned row.

limit

integer

yes

Requested page size.

has_more

boolean

yes

True when another page follows. Increase offset.

ErrorBody

Field

Type

Required

Description

code

ErrorCode

yes

Stable machine-readable error code.

message

string

yes

Human-readable explanation. Do not parse it.

MeetingListItem

Field

Type

Required

Description

uuid

uuid

yes

Meeting id. Use it to fetch content. It does not change once the meeting is recorded. A failed meeting scheduled from a calendar event can get a new id when the event is edited; the old id then returns 404 meeting_not_found.

web_url

string

yes

Opens the meeting in the Sembly web app. The person opening it signs in and needs access to the meeting.

title

string or null

yes

Meeting title. Null when the meeting has none.

started_at

datetime or null

yes

When the meeting started, UTC.

finished_at

datetime or null

yes

When the meeting ended, UTC. Null while it is running or when unknown.

duration_seconds

integer

yes

Recorded duration in seconds. 0 when unknown.

meeting_type

string or null

yes

Meeting type, lowercase, for example generic.

platform

MeetingPlatform

yes

Where the meeting took place or where the recording came from. New values may be added; treat unknown ones as other.

status

MeetingStatus

yes

processed once content is available, and it stays processed.

processed_at

datetime or null

yes

When processing finished. Null until status is processed.

owner

UserRef or null

yes

Workspace user who owns the meeting. Null when the owner left the workspace.

accessible_by

list of UserRef

yes

Workspace users who have access to the meeting.

calendar_event

CalendarEventRef or null

yes

Calendar event the meeting was scheduled from. Null for uploads, recordings and meetings added without a calendar event.

MeetingPlatform

Where the meeting took place or where the recording came from.

Values: zoom, ms_teams, google_meet, webex, upload, recording, other.

MeetingStatus

Public processing state of a meeting.

Values: processed, in_progress, failed.

UserRef

Field

Type

Required

Description

id

uuid

yes

User id, as returned by GET /users.

email

string

yes

Email of the user, unique in the workspace.

CalendarEventRef

The calendar event a meeting was scheduled from.

Field

Type

Required

Description

provider

CalendarProvider

yes

microsoft and google come from a connected calendar, ics from a calendar feed, email from an invite sent to Sembly. New values may be added.

ical_uid

string or null

yes

iCalendar UID of the event, the same in every attendee's calendar. Match on it. For an occurrence of a recurring microsoft series this is the UID of the series, so match it together with started_at.

event_ids

list of string

yes

Provider ids of this event in the calendars Sembly synced. A microsoft id is valid only in its own mailbox and can change, so prefer ical_uid. Empty for ics and email.

series_ids

list of string

yes

Provider ids of the recurring series, in the same calendars as event_ids. Empty for a single event.

is_recurring

boolean

yes

True when the event is part of a recurring series.

NotesContent

Field

Type

Required

Description

meeting_type

string

yes

Meeting type the notes were written for, lowercase.

text

string

yes

Meeting notes body, as HTML.

TaskContent

Field

Type

Required

Description

title

string

yes

Short task title.

description

string

yes

Task text as captured from the meeting.

type

string

yes

task, activity or project. New values may be added.

due_date

string or null

yes

ISO 8601 due date, when the task has one.

raw_timing

string or null

yes

Timing phrase as spoken in the meeting.

performer

NamedUser

yes

Who should do the task.

assigner

NamedUser

yes

Who gave the task.

TranscriptItem

Field

Type

Required

Description

start

number

yes

Start offset in seconds.

end

number

yes

End offset in seconds.

text

string

yes

What was said.

is_cross_talk

boolean

yes

True when several people spoke at once.

speaker

Speaker

yes

Who said it.

ErrorCode

Stable machine-readable codes. Clients should branch on these, not on messages.

Values: missing_token, invalid_token, disabled_token, expired_token, workspace_disabled, workspace_not_eligible, plan_not_allowed, api_disabled, ip_not_allowed, invalid_parameters, invalid_cursor, meeting_not_found, not_found, rate_limited, internal_error.

CalendarProvider

Where Sembly learned about the meeting's calendar event.

Values: microsoft, google, ics, email.

NamedUser

A person named on a task or utterance. user is set only when matched.

Field

Type

Required

Description

label

string

yes

Name as spoken or written in the meeting.

user

UserRef or null

yes

Workspace user this name was matched to, if any.

Speaker

Field

Type

Required

Description

id

integer

yes

Speaker id, stable within the meeting.

label

string

yes

Speaker name or a generic label.

user

UserRef or null

yes

Workspace user this speaker was matched to. Null when not matched.

Did this answer your question?
๐Ÿ˜ž
๐Ÿ˜
๐Ÿ˜