/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog
API Reference Update Organization Theme

Update Organization Theme

Save a new version of an organization theme, or rename it

PATCH/v1/orgs/{orgId}/themes/{slug}Try it
Session token

Changing preset, appearance or themeOverrides creates a new version; every earlier version stays as it was. Projects that follow the latest version pick it up on their next build; pinned projects don't. A request that only changes name renames the theme in place, without a new version.

Needs the organization admin role (or owner). A caller outside the organization gets 404. These endpoints need a session token; API keys get 401.

Request Body

Send at least one field.

NameDescription
name:stringbody
New display name, 1–80 characters.
preset:stringbody
A v2 preset name.
appearance:objectbody
The new version's appearance settings.
themeOverrides:objectbody
The new version's themeOverrides.

Response

The updated theme, with its new version.

Error Responses

StatusCodeWhen
400validation_errorNo field sent
400invalid_themeAn unknown preset, or an appearance value the build would reject
403org_admin_requiredYou're a member, not an admin
404theme_not_foundNo theme with this slug
Was this page helpful? Yes No
Request
cURLJavaScriptPythonGoRubyPHPJavaC#cURL
curl -X PATCH https://api.syntext.dev/v1/orgs/org_123/themes/brand \
-H "Authorization: Bearer <session token>" \
-H "Content-Type: application/json" \
-d '{ "appearance": { "accent": "#0F766E", "radius": "small" } }'
Product
Resources
Company
© 2026 SyntextBuilt with Syntext