Skip to main content
Everything belongs to a workspace: its library, timelines, canvases, feed, comments, brand kit, skills, boards, calendars and public links. An account can have one or more workspaces, and its webhook endpoints receive events from 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 works in one workspace at a time, its default. The user picks it when connecting and can tick other workspaces the connection may use, on the consent screen or later in Settings, Agents. An API 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 can use, and switch_workspace changes the default for every later call until it is 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 switching 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 picks one for a single request. A connection or a key, including the CLI’s sign-in and its --workspace flag, can only name a workspace in its own set, and any other is refused. The MCP server ignores the header: there, only switch_workspace changes the workspace.

Members and balances

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

Changes

The overview shows 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 then, oldest first: files added, generated and edited, timelines and canvases worked on, structure, links, skills and published clips, each with who did it.