API Reference List Organization Themes
List Organization Themes
List an organization's themes with their latest version and the projects using each
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
orgIdThe organization ID.
Response
An array of themes. Each theme has:
NameDescription
slugThe theme's identifier — the
brand in "@acme/brand".nameDisplay name.
versionThe latest version.
presetThe v2 preset the theme starts from.
appearanceThe latest version's
appearance settings.themeOverridesThe latest version's
themeOverrides.updatedAtWhen the theme last changed.
updatedBy{ id, name } of whoever made the last change.projectsProjects 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.Related
Was this page helpful? Yes No
Previous
Request
cURLJavaScriptPythonGoRubyPHPJavaC#cURL
curl https://api.syntext.dev/v1/orgs/org_123/themes \
-H "Authorization: Bearer <session token>"
const response = await fetch('https://api.syntext.dev/v1/orgs/org_123/themes', {
method: 'GET',
headers: {
'Authorization': 'Bearer <session token>',
},
});
const data = await response.json();
console.log(response.status, data);
import requests
url = "https://api.syntext.dev/v1/orgs/org_123/themes"
headers = {
"Authorization": "Bearer <session token>",
}
response = requests.get(url, headers=headers)
print(response.status_code)
print(response.json())
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://api.syntext.dev/v1/orgs/org_123/themes", nil)
if err != nil {
panic(err)
}
req.Header.Set("Authorization", "Bearer <session token>")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
body, err := io.ReadAll(res.Body)
if err != nil {
panic(err)
}
fmt.Println(res.Status)
fmt.Println(string(body))
}
require "net/http"
require "uri"
uri = URI("https://api.syntext.dev/v1/orgs/org_123/themes")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer <session token>"
response = http.request(request)
puts response.code
puts response.body
<?php
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => 'https://api.syntext.dev/v1/orgs/org_123/themes',
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer <session token>',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
echo $status, PHP_EOL, $response, PHP_EOL;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.syntext.dev/v1/orgs/org_123/themes"))
.header("Authorization", "Bearer <session token>")
.GET()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
using System.Net.Http;
using System.Text;
using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://api.syntext.dev/v1/orgs/org_123/themes");
request.Headers.TryAddWithoutValidation("Authorization", "Bearer <session token>");
using var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());
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 }
]
}
]
}