Productmind API

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

GET
https://api.productmind.ai
/workspaces

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.

List workspaces accessible to the current user › query Parameters

page
​number

Page number (1-indexed, default 1)

limit
​number

Items per page (default 50)

sortBy
​string · enum

Field to sort by

Enum values:
name
createdAt
sortOrder
​string · enum

Sort direction (default desc)

Enum values:
asc
desc
search
​string

Full-text search across searchable fields

List workspaces accessible to the current user › Responses

200

List of workspaces

​WorkspaceDTO[] · required
​object
​object

Create a new workspace

POST
https://api.productmind.ai
/workspaces

Create a workspace to organize product requirements, features, and AI conversations.

Create a new workspace › Request Body

name
​string · minLength: 1 · required
description
​string · minLength: 1 · required

Create a new workspace › Responses

Created workspace

​WorkspaceDTO · required

Get a workspace by ID

GET
https://api.productmind.ai
/workspaces/{id}

Retrieve a single workspace with its full details including name, description, and metadata.

Get a workspace by ID › path Parameters

id
​string · required

Workspace UUID

Get a workspace by ID › Responses

200

Workspace details

​WorkspaceDTO · required

Update a workspace

PUT
https://api.productmind.ai
/workspaces/{id}

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.

Update a workspace › path Parameters

id
​string · required

Workspace UUID

Update a workspace › Request Body

name
​string · minLength: 1 · maxLength: 255
description
​string · minLength: 1

Update a workspace › Responses

Updated workspace

​WorkspaceDTO · required

Delete a workspace

DELETE
https://api.productmind.ai
/workspaces/{id}

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.

Delete a workspace › path Parameters

id
​string · required

Workspace UUID

Delete a workspace › Responses

Workspace deleted

No data returned

Get a workspace's product configuration

GET
https://api.productmind.ai
/workspaces/{id}/product-config

Returns the workspace-scoped product configuration (guardrails and other behaviour toggles). Missing keys are filled from defaults. Readable by any workspace member.

Get a workspace's product configuration › path Parameters

id
​string · required

Workspace UUID

Get a workspace's product configuration › Responses

200

Resolved product configuration

​ProductConfig · required

Update a workspace's product configuration

PATCH
https://api.productmind.ai
/workspaces/{id}/product-config

Partial-merge update of the workspace product configuration. Only the keys provided are changed; the rest are preserved. Restricted to organization owners and admins.

Update a workspace's product configuration › path Parameters

id
​string · required

Workspace UUID

Update a workspace's product configuration › Request Body

​object

Update a workspace's product configuration › Responses

200

Updated product configuration

​ProductConfig · required