Workspaces
A workspace holds one product's work: its feedback, features, tasks, sessions and settings. List the workspaces you can use in your organization, create one, change its name or description, or delete it with all its data. You can also read and change a workspace's product configuration: when a status change on a feature or feature request asks for or requires a decision, and what evidence a feature request needs before it can be promoted to a feature. See Organizations and workspaces.
List workspaces accessible to the current user
Returns the workspaces of the organization this sign-in or MCP connection is for (each carries organizationId). Workspaces of the user's other organizations are not listed, and their tools are refused; to use them, reconnect and choose that organization. Each workspace contains product requirements, features, and AI agent conversations. Returns: id, name, description, createdAt.
query Parameters
pagePage number (1-indexed, default 1)
limitItems per page (default 50)
sortByField to sort by
sortOrderSort direction (default desc)
searchFull-text search across searchable fields
List workspaces accessible to the current user › Responses
List of workspaces
Create a new workspace
Create a workspace to organize product requirements, features, and AI conversations.
Create a new workspace › Request Body
namedescriptionCreate a new workspace › Responses
Created workspace
Get a workspace by ID
Retrieve a single workspace with its full details including name, description, and metadata.
path Parameters
idWorkspace UUID
Get a workspace by ID › Responses
Workspace details
Update a workspace
Rename a workspace or change its description. Open to the workspace's creator and to an Owner or Admin of its organization, where workspace management is available to the organization. A new name must not be one another workspace of the organization already has.
path Parameters
idWorkspace UUID
Update a workspace › Request Body
namedescriptionUpdate a workspace › Responses
Updated workspace
Delete a workspace
Delete a workspace. It leaves every workspace list and can no longer be opened, its feedback widgets stop accepting conversations, and its scheduled automations stop running. Its assistant conversations and knowledge-base files are erased for good 30 days later. An organization's last workspace cannot be deleted. Open to the workspace's creator and to an Owner or Admin of its organization, where workspace management is available to the organization.
path Parameters
idWorkspace UUID
Delete a workspace › Responses
Workspace deleted
Get a workspace's product configuration
Returns the workspace-scoped product configuration (guardrails and other behaviour toggles). Missing keys are filled from defaults. Readable by any workspace member.
path Parameters
idWorkspace UUID
Get a workspace's product configuration › Responses
Resolved product configuration
Update a workspace's product configuration
Partial-merge update of the workspace product configuration. Only the keys provided are changed; the rest are preserved. Restricted to organization owners and admins.
path Parameters
idWorkspace UUID
Update a workspace's product configuration › Responses
Updated product configuration