Get Workspace Settings

Return workspace-level settings (default_language, theme).

Settings are workspace-scoped: every member of the workspace sees the same defaults. Per-user UI preferences (e.g. personal dark-mode) belong in a future user_settings endpoint.

Path-based authorization (via get_workspace_from_path_for_auth_context) prevents the header-vs-path bypass class — the {ws_id} URL segment is the source of truth for which workspace is being read.

Return workspace-level settings (default_language, theme). Settings are workspace-scoped: every member of the workspace sees the same defaults. Per-user UI preferences (e.g. personal dark-mode) belong in a future user_settings endpoint. Path-based authorization (via get_workspace_from_path_for_auth_context) prevents the header-vs-path bypass class — the {ws_id} URL segment is the source of truth for which workspace is being read.

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": "light"
5	},
6	"meta": {
7	"request_id": "a3f1c9e2-7b4d-4f8a-9d2e-5c6b7a8f9d01",
8	"timestamp": "2024-01-15T09:30:00Z"
9	}
10	}