Skip to main content
GET
Get a workspace

Authorizations

Authorization
string
header
required

Your API key, sent bare. See Authentication.

Path Parameters

id
string
required

Workspace ID, beginning with wks_. Treat it as an opaque string. Integer workspace ids are still accepted.

Example:

"wks_01k6a2r9s8x7c2dvq3m5n6p4ab"

Response

The workspace.

id
string

Workspace ID, beginning with wks_. Treat it as an opaque string.

name
string

The workspace name, shown to its members in MeetingKit.

role
enum<string>

The authenticated user's role in this workspace.

  • owner: owns the workspace.
  • admin: manages the workspace.
  • member: records and reads their own meetings.
  • guest: sees only what is shared with them.
Available options:
owner,
admin,
member,
guest
created_at
string<date-time>

When it was created, in ISO 8601.

updated_at
string<date-time>

When it last changed, in ISO 8601.

owner_email
string

(staff only) Email address of the workspace owner.

members_count
integer

(staff only) Number of members, excluding guests and deleted users.

is_human_transcription_allowed
boolean

(staff only) Whether the workspace may order human transcription.

is_human_translation_allowed
boolean

(staff only) Whether the workspace may order human translation.

email_domains
string[]

(staff only) Domains that auto-join the workspace at sign-up.

idp_company_names
string[]

(staff only) IdP company names configured for SSO.

currency
string

(staff only) Billing currency code, e.g. usd, eur, gbp.

metadata
object

(staff only) Your key-value pairs.

Example:
settings
object

(staff only) What applies to the workspace's meetings that no member, category or meeting decides. On List workspaces, only with include=settings.

Example: