Get Workspace Settings

GET

/api/v1/workspaces/:ws_id/settings

Return workspace-level settings for the specified workspace.

Currently exposes default_language (the locale used as the default for new workflow nodes) and theme (the workspace’s display color theme). Settings are workspace-scoped: all members of the workspace share the same values. Per-user preferences (e.g. personal dark mode) are outside the scope of this endpoint.

If settings have not yet been explicitly configured for the workspace, defaults are returned (and persisted) on first access.

Return workspace-level settings for the specified workspace. Currently exposes `default_language` (the locale used as the default for new workflow nodes) and `theme` (the workspace's display color theme). Settings are workspace-scoped: all members of the workspace share the same values. Per-user preferences (e.g. personal dark mode) are outside the scope of this endpoint. If settings have not yet been explicitly configured for the workspace, defaults are returned (and persisted) on first access.

Authentication

AuthorizationBearer

Clerk JWT token

AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Path parameters

ws_idstringRequiredformat: "uuid"

Response

Successful Response

dataobject

metaobject

Errors

422

Unprocessable Entity Error

1	{
2	"data": {
3	"default_language": "en-US",
4	"theme": "dark-blue"
5	},
6	"meta": {
7	"request_id": "a3f47b9e-8c2d-4f1a-9b7e-2d5f6c8a1e4b",
8	"timestamp": "2024-01-15T09:30:00Z"
9	}
10	}