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

Create Organization Theme

Create an organization theme as version 1

POST/v1/orgs/{orgId}/themesTry it
Session token

Creates a theme as version 1. Projects use it with "theme": "@<org slug>/<slug>".

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

NameDescription
name:stringbodyRequired
Display name, 1–80 characters.
slug:stringbody
The identifier: lower-case letters, digits and hyphens, at most 48 characters, not starting or ending with a hyphen. Generated from name when omitted.
preset:stringbodyRequired
A v2 preset: workbench, paper, console, atlas, plain, orbit, grid or margin.
appearance:objectbody
appearance settings. Values the build would reject are refused.
themeOverrides:objectbody
themeOverrides applied to every project using the theme, under the project's own.

Response

Returns 201 with the theme — see List Organization Themes for its fields.

Error Responses

StatusCodeWhen
400validation_errorMissing name or preset, or a malformed slug
400invalid_themeAn unknown preset, or an appearance value the build would reject. details.issues lists them
403org_admin_requiredYou're a member, not an admin
404not_foundThe organization doesn't exist, or you're not in it
409theme_slug_takenThe organization already has a theme with this slug
Was this page helpful? Yes No
Request
cURLJavaScriptPythonGoRubyPHPJavaC#cURL
curl -X POST https://api.syntext.dev/v1/orgs/org_123/themes \
-H "Authorization: Bearer <session token>" \
-H "Content-Type: application/json" \
-d '{ "name": "Acme Brand", "slug": "brand", "preset": "paper", "appearance": { "accent": "#0E7A63" } }'
Product
Resources
Company
© 2026 SyntextBuilt with Syntext