WorkspaceAppearance

PATCH /v1/workspaces/{id}/appearance.

All four, every time. They are edited together and the caller knows all of them, so sending them whole sidesteps the absent versus null question a partial update has to answer in JSON - and which nobody answers the same way twice.

Type object

Shape

Field	Type	Description
icon	string or null	Default `null`
color	string or null	Default `null`
pinned	boolean	Default `false`
archived	boolean	Default `false`

Example

{
  "icon": "string",
  "color": "string",
  "pinned": false,
  "archived": false
}

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Used by

PATCH/v1/workspaces/{id}/appearance
How a workspace appears in a switcher: icon, colour, pinned, archived

Generated from contract version 1. Last updated November 12, 2026.