Update workspace appearance settings

Updates workspace appearance settings. All fields are optional - only provided fields will be updated.

What can be updated:

Main workspace color: Changes the primary color theme used throughout the workspace
Logo: Upload a logo file for light theme display
Logo dark theme: Upload a separate logo file optimized for dark theme display

To upload logo files:

Call POST /api/public/workspace/upload to upload each logo file
Get the file ID from the response
Use that file ID in the logoId or logoDarkThemeId field
Set to null to remove an existing logo

Note: This endpoint requires the WsSettings.manageSettings permission. Changes affect how the workspace appears to all users. The system validates that provided file IDs exist and belong to the workspace.

PATCH/administration/appearance-settings

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Request body

requiredapplication/json

logoDarkThemeIdobject | null

File ID for the workspace logo (dark theme). Upload file via POST /workspace/upload first.

logoIdobject | null

File ID for the workspace logo (default theme). Upload file via POST /workspace/upload first.

mainWorkspaceColorstring

Main workspace color theme

Allowed:DEFAULTBLACKREDROSEMAGENTAGREENBLUEYELLOWVIOLET

Responses

200Appearance settings updated successfully

successboolean

401Unauthorized - Invalid or missing authentication token

403Forbidden - Insufficient API scopes or permissions

404File not found - Invalid logoId or logoDarkThemeId provided

Request

curl -X PATCH "https://leadtime.app/api/public/administration/appearance-settings" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "logoDarkThemeId": "123e4567-e89b-12d3-a456-426614174001",
  "logoId": "123e4567-e89b-12d3-a456-426614174000",
  "mainWorkspaceColor": "BLUE"
}'

const response = await fetch("https://leadtime.app/api/public/administration/appearance-settings", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "logoDarkThemeId": "123e4567-e89b-12d3-a456-426614174001",
  "logoId": "123e4567-e89b-12d3-a456-426614174000",
  "mainWorkspaceColor": "BLUE"
})
});

import requests

response = requests.patch(
    "https://leadtime.app/api/public/administration/appearance-settings",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "logoDarkThemeId": "123e4567-e89b-12d3-a456-426614174001",
  "logoId": "123e4567-e89b-12d3-a456-426614174000",
  "mainWorkspaceColor": "BLUE"
},
)

Response

{
  "success": true
}