Get workspace appearance settings
Retrieves the current workspace appearance settings.
What is returned:
- Main workspace color: The primary color theme used throughout the workspace
- Navigation animations: Workspace default for left-right page slides during navigation. Off by default. Users can override this in their profile.
- Logo URL: Public URL for the workspace logo (shown in light theme)
- Logo dark theme URL: Public URL for the workspace logo used in dark theme
Note: This endpoint requires the WsSettings.manageSettings permission. Appearance settings affect how the workspace looks to all users in the workspace.
GET
/administration/appearance-settingsAuthorization
AuthorizationOAuth2 access token · headerrequiredScopes:
api:reador
AuthorizationBearer token (JWT) · headerrequiredResponses
200
Appearance settings retrieved successfully
logoDarkThemeUrlobject | nullURL to the workspace logo for dark theme
logoUrlobject | nullURL to the workspace logo for default theme
mainWorkspaceColorstringrequiredMain workspace color theme
Allowed:
DEFAULTBLACKREDROSEMAGENTAGREENBLUESKYYELLOWVIOLETnavigationAnimationsEnabledbooleanrequiredWhen true, workspace pages slide left and right during navigation. Off by default. Users can override this in their profile.
401
Unauthorized - Invalid or missing authentication token
403
Forbidden - Insufficient API scopes or permissions