API reference

Branding

10 endpoints. Click one to see its parameters, fields and an example. Code samples use the region you pick.

POST/v1/assetsUpload a logo, icon, splash, font or photo (multipart, field "file", query kind)

Upload a logo, icon, splash, font or photo (multipart, field "file", query kind)

Query parameters

Name	Type	Description
`kind`required	"logo" \| "icon" \| "splash" \| "font" \| "photo"

Example

curl -X POST "https://ca-api.clocklap.com/v1/assets" \
  -H "Authorization: Bearer $CLOCKLAP_API_KEY"

Responses

200

GET/v1/assets/{id}Download an asset (logos are public; photos need auth)

Download an asset (logos are public; photos need auth)

Path parameters

Name	Type	Description
`id`required	string

Example

curl "https://ca-api.clocklap.com/v1/assets/{id}" \
  -H "Authorization: Bearer $CLOCKLAP_API_KEY"

Responses

200

GET/v1/brandingPublished theme, draft and history

Published theme, draft and history

Example

curl "https://ca-api.clocklap.com/v1/branding" \
  -H "Authorization: Bearer $CLOCKLAP_API_KEY"

Responses

200

PUT/v1/branding/draftSave a draft (partial theme, merged)

Save a draft (partial theme, merged)

Example

curl -X PUT "https://ca-api.clocklap.com/v1/branding/draft" \
  -H "Authorization: Bearer $CLOCKLAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Responses

200

DELETE/v1/branding/draftDelete draft

Delete draft

Example

curl -X DELETE "https://ca-api.clocklap.com/v1/branding/draft" \
  -H "Authorization: Bearer $CLOCKLAP_API_KEY"

Responses

200

GET/v1/branding/previewRender tokens for an unsaved theme (used by the live preview)

Render tokens for an unsaved theme (used by the live preview)

Query parameters

Name	Type	Description
`primary`required	string
`accent`required	string
`font`	string (12 values)
`radius`	"sharp" \| "soft" \| "round"

Example

curl "https://ca-api.clocklap.com/v1/branding/preview" \
  -H "Authorization: Bearer $CLOCKLAP_API_KEY"

Responses

200

POST/v1/branding/publishPublish the draft to every app and the console

Publish the draft to every app and the console

Example

curl -X POST "https://ca-api.clocklap.com/v1/branding/publish" \
  -H "Authorization: Bearer $CLOCKLAP_API_KEY"

Responses

200

POST/v1/branding/rollbackCreate a rollback

Create a rollback

Body (JSON)

Name	Type	Description
`version`required	integer

Example

curl -X POST "https://ca-api.clocklap.com/v1/branding/rollback" \
  -H "Authorization: Bearer $CLOCKLAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"version":-9007199254740991}'

Responses

200

GET/v1/workspaceWorkspace profile, including AI assistant (MCP) settings

Workspace profile, including AI assistant (MCP) settings

Example

curl "https://ca-api.clocklap.com/v1/workspace" \
  -H "Authorization: Bearer $CLOCKLAP_API_KEY"

Responses

200

PATCH/v1/workspaceRename, change timezone, or set AI assistant (MCP) access: on/off, changes allowed, which tools

Rename, change timezone, or set AI assistant (MCP) access: on/off, changes allowed, which tools

Body (JSON)

Name	Type	Description
`name`	string
`timezone`	string
`mcp`	boolean
`mcp_write`	boolean
`mcp_tools`	array of string (44 values) or null

Example

curl -X PATCH "https://ca-api.clocklap.com/v1/workspace" \
  -H "Authorization: Bearer $CLOCKLAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Responses

200