Theme Options - Save (options + logo)

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 sendingContent type
Theme options onlyapplication/json
Theme options and a logo filemultipart/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_id must 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)

FieldTypeRequiredNotes
company_idintegerRequiredMust be an existing account inside your own account tree.
theme_optionsstringRequiredJSON-encoded theme settings, stored verbatim.
logo_imagefile (image)OptionalJPEG/PNG, max 400 KB.

Behaviour

  • 200 with { status, message, data, white_label }: data is the saved RsUserThemeSetting row; white_label carries company_id and S3-resolved logo/login_logo/mobile_logo/favicon (null when unset).
  • 422 if company_id is missing/invalid/out of hierarchy, theme_options is missing, or logo_image is too large / wrong type.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
string
file
Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json