Productmind API

Workspace settings are the rules that apply to everyone in a workspace, such as the Git branches coding sessions work from, grouped by area. Read one setting or every changed setting in an area, change a setting, or reset it to its default. You can also preview the default MCP workflow skill with your workspace's details filled in, and read and change your own settings, such as whether your notifications go to Slack instead of email. See Settings.


Get the rendered default workflow skill

GET
https://api.productmind.ai
/workspaces/{workspaceId}/settings/skill-preview

Returns the default workflow skill markdown rendered with the workspace's git config + linked repositories. The settings UI displays this as a read-only preview when no custom skill is set.

Get the rendered default workflow skill › path Parameters

workspaceId
​string · required

Workspace UUID

Get the rendered default workflow skill › Responses

200

Rendered default skill

​SkillPreviewDTO · required

List persisted settings for a namespace

GET
https://api.productmind.ai
/workspaces/{workspaceId}/settings/{namespace}

Returns the workspace's persisted overrides for the given namespace (e.g. git, feature, workflow). Settings without an override are absent from the response — the consumer applies registry defaults.

List persisted settings for a namespace › path Parameters

workspaceId
​string · required

Workspace UUID

namespace
​string · required

Setting namespace, e.g. 'git', 'feature', 'workflow'

List persisted settings for a namespace › Responses

200

Persisted settings rows for the namespace

​SettingDTO[] · required

Get a single workspace setting

GET
https://api.productmind.ai
/workspaces/{workspaceId}/settings/{namespace}/{name}

Returns the resolved value for :namespace/:name — the persisted override when present, otherwise the registry default. Unknown setting keys return 400.

Get a single workspace setting › path Parameters

workspaceId
​string · required

Workspace UUID

namespace
​string · required

Setting namespace, e.g. 'git', 'feature', 'workflow'

name
​string · required

Setting name within the namespace, e.g. 'productionBranch'

Get a single workspace setting › Responses

200

Resolved setting value (override or registry default)

​SettingValueDTO · required

Set a single workspace setting

PUT
https://api.productmind.ai
/workspaces/{workspaceId}/settings/{namespace}/{name}

Upserts a setting identified by :namespace/:name. The body is { value } where value is parsed against the registry schema for the key. Unknown keys are rejected with 400.

Set a single workspace setting › path Parameters

workspaceId
​string · required

Workspace UUID

namespace
​string · required

Setting namespace, e.g. 'git', 'feature', 'workflow'

name
​string · required

Setting name within the namespace, e.g. 'productionBranch'

Set a single workspace setting › Request Body

Set a single workspace setting › Responses

200

Updated setting

​SettingDTO · required

Delete a single workspace setting

DELETE
https://api.productmind.ai
/workspaces/{workspaceId}/settings/{namespace}/{name}

Removes the override for :namespace/:name. Subsequent reads return the registry default. Idempotent — deleting an absent setting is a no-op.

Delete a single workspace setting › path Parameters

workspaceId
​string · required

Workspace UUID

namespace
​string · required

Setting namespace, e.g. 'git', 'feature', 'workflow'

name
​string · required

Setting name within the namespace, e.g. 'productionBranch'

Delete a single workspace setting › Responses

200

Setting deleted

data
​string · required

List the current user's persisted settings for a namespace

GET
https://api.productmind.ai
/users/me/settings/{namespace}

Returns the authenticated user's persisted setting overrides for the given namespace (e.g. help). Settings without an override are absent — the consumer applies registry defaults.

List the current user's persisted settings for a namespace › path Parameters

namespace
​string · required

Setting namespace, e.g. 'help'

List the current user's persisted settings for a namespace › Responses

200

Persisted user settings rows for the namespace

​SettingDTO[] · required

Set a single user setting

PUT
https://api.productmind.ai
/users/me/settings/{namespace}/{name}

Upserts a per-user setting identified by :namespace/:name. The body is { value }, parsed against the registry schema for the key. Unknown keys are rejected with 400. The user is always the authenticated caller.

Set a single user setting › path Parameters

namespace
​string · required

Setting namespace, e.g. 'help'

name
​string · required

Setting name within the namespace, e.g. 'accountsContacts'

Set a single user setting › Request Body

Set a single user setting › Responses

200

Updated setting

​SettingDTO · required