/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog
API Reference List Organization Themes

List Organization Themes

List an organization's themes with their latest version and the projects using each

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

Returns every organization theme, sorted by name, with its latest version.

Any member of the organization can call it. A caller outside the organization gets 404. These endpoints need a session token; API keys get 401.

Path Parameters

NameDescription
orgId:stringpathRequired
The organization ID.

Response

An array of themes. Each theme has:

NameDescription
slug:string
The theme's identifier — the brand in "@acme/brand".
name:string
Display name.
version:number
The latest version.
preset:string
The v2 preset the theme starts from.
appearance:object
The latest version's appearance settings.
themeOverrides:object
The latest version's themeOverrides.
updatedAt:string
When the theme last changed.
updatedBy:object | null
{ id, name } of whoever made the last change.
projects:array
Projects in the organization using the theme: { id, name, pinned }. pinned is the version number for "@org/slug@N", or null for a project that follows the latest version. Updated by production builds and by publishes from the appearance editor.
Was this page helpful? Yes No
Request
cURLJavaScriptPythonGoRubyPHPJavaC#cURL
curl https://api.syntext.dev/v1/orgs/org_123/themes \
-H "Authorization: Bearer <session token>"
Responseapplication/json
json
{
"data": [
{
"slug": "brand",
"name": "Acme Brand",
"version": 4,
"preset": "paper",
"appearance": { "accent": "#0E7A63", "radius": "small" },
"themeOverrides": {},
"updatedAt": "2026-11-13T10:30:00Z",
"updatedBy": { "id": "usr_123", "name": "Ada Lovelace" },
"projects": [
{ "id": "b4c5d6e7-f8a9-4b0c-9d1e-2f3a4b5c6d7e", "name": "API Docs", "pinned": null },
{ "id": "7d1e4b2a-5c6f-4a8b-b9d0-1e2f3a4b5c6d", "name": "SDK Docs", "pinned": 3 }
]
}
]
}
Product
Resources
Company
© 2026 SyntextBuilt with Syntext