post
https://production-api.shoutaboutus.com/api/v1/theme-options/save
Create or updates the latest RsUserThemeSetting for a company (recording the authenticated user as author) with the supplied theme_options JSON, and — when a logo_image file is sent — stores it to S3 and writes it onto the company's RsWhiteLabel logo. Distinct from /account/white-label/theme/save: this route is and does not take a user_id (it uses the authenticated user).
Choose the content type to match what you are sending:
| You are sending | Content type |
|---|---|
| Theme options only | application/json |
| Theme options and a logo file | multipart/form-data |
Both accept the same fields. Use multipart/form-data only when you attach logo_image, because a file cannot travel in a JSON body.
Auth
- Account bearer.
company_idmust sit inside your own account tree — partner can target any company beneath it. Account user limited to its own part of the account tree.
Rate limit
- No rate limit.
Body (multipart/form-data)
| Field | Type | Required | Notes |
|---|---|---|---|
company_id | integer | Required | Must be an existing account inside your own account tree. |
theme_options | string | Required | JSON-encoded theme settings, stored verbatim. |
logo_image | file (image) | Optional | JPEG/PNG, max 400 KB. |
Behaviour
200with{ status, message, data, white_label }:datais the savedRsUserThemeSettingrow;white_labelcarriescompany_idand S3-resolvedlogo/login_logo/mobile_logo/favicon(null when unset).422ifcompany_idis missing/invalid/out of hierarchy,theme_optionsis missing, orlogo_imageis too large / wrong type.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
