Settings
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
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.
path Parameters
workspaceIdWorkspace UUID
Get the rendered default workflow skill › Responses
Rendered default skill
List persisted settings for a 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.
path Parameters
workspaceIdWorkspace UUID
namespaceSetting namespace, e.g. 'git', 'feature', 'workflow'
List persisted settings for a namespace › Responses
Persisted settings rows for the namespace
Get a single workspace setting
Returns the resolved value for :namespace/:name — the persisted override when present, otherwise the registry default. Unknown setting keys return 400.
path Parameters
workspaceIdWorkspace UUID
namespaceSetting namespace, e.g. 'git', 'feature', 'workflow'
nameSetting name within the namespace, e.g. 'productionBranch'
Get a single workspace setting › Responses
Resolved setting value (override or registry default)
Set a single workspace setting
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.
path Parameters
workspaceIdWorkspace UUID
namespaceSetting namespace, e.g. 'git', 'feature', 'workflow'
nameSetting name within the namespace, e.g. 'productionBranch'
Set a single workspace setting › Responses
Updated setting
Delete a single workspace setting
Removes the override for :namespace/:name. Subsequent reads return the registry default. Idempotent — deleting an absent setting is a no-op.
path Parameters
workspaceIdWorkspace UUID
namespaceSetting namespace, e.g. 'git', 'feature', 'workflow'
nameSetting name within the namespace, e.g. 'productionBranch'
Delete a single workspace setting › Responses
Setting deleted
dataList the current user's persisted settings for a 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.
path Parameters
namespaceSetting namespace, e.g. 'help'
List the current user's persisted settings for a namespace › Responses
Persisted user settings rows for the namespace
Set a single user setting
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.
path Parameters
namespaceSetting namespace, e.g. 'help'
nameSetting name within the namespace, e.g. 'accountsContacts'
Set a single user setting › Responses
Updated setting