Skip to main content
A workspace is the unit everything belongs to: its library, timelines, canvases, feed, comments, brand kit, skills, boards, calendars and public links. An account has one or more workspaces, and its webhook endpoints receive the events of every workspace it owns. A workspace has an owner and members.

​
Roles

get_workspace_overview returns the caller’s role. manage_settings changes account settings for anyone and workspace settings for the owner only.

​
One connection, one workspace at a time

A connection acts in one workspace at a time, its default. The user picks it when connecting and may tick other workspaces the connection can reach, on the consent screen or later in Settings, Agents; a key gets its workspaces the same way, in Settings, API keys, one unless more are ticked. manage_settings with workspaces: true lists the workspaces the connection may act in, and switch_workspace moves the default for every call after, until switched again. Every result names the workspace it acted in. Through the desktop app a connection works in the workspace the app has open, and a switch opens that workspace in the app. A Business seat’s minutes apply in the workspaces of the admin who holds the plan. Over REST, GET /api/v1/workspaces lists every workspace the account can reach, and the x-workspace-id header names one for a single request. A connection, the CLI’s sign-in and its --workspace included, or a key may name only a workspace in its own set; one outside it is refused. The MCP server ignores the header: there, a connection moves only with switch_workspace.

​
Members and balances

The overview lists members by name, and those names are what manage_comments accepts as mentions. Cloud processing minutes are always the caller’s own, whoever owns the workspace. Storage is the owner’s.

​
Changes

The overview reports what each member has open in the app right now, and a changes cursor. get_workspace_changes with after_cursor returns only what happened since, oldest first: files added, generated and edited, timelines and canvases worked on, structure, links, skills and published clips, each with who did it.