Create a Theme Set

POST

https://api.withpersona.com/api/v1/theme-sets

POST

/api/v1/theme-sets

$ curl -X POST https://api.withpersona.com/api/v1/theme-sets \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "data": {
>     "attributes": {
>       "name": "Brand Default",
>       "styles": {
>         "settings": {
>           "use-dark-theme": false,
>           "preferred-theme-variant": "light"
>         },
>         "light": {
>           "inquiry": {
>             "primary-color": {
>               "unit": "hex",
>               "value": "#111111"
>             }
>           },
>           "components": {
>             "button": {
>               "primary": {
>                 "base": {
>                   "background-color": {
>                     "unit": "hex",
>                     "value": "#111111"
>                   },
>                   "text-color": {
>                     "unit": "hex",
>                     "value": "#FFFFFF"
>                   }
>                 }
>               }
>             }
>           }
>         }
>       }
>     }
>   }
> }'

1 {
2   "data": {
3     "type": "theme-set",
4     "id": "theset_ABC123",
5     "attributes": {
6       "name": "Brand Default",
7       "status": "active",
8       "styles": {
9         "settings": {
10           "use-dark-theme": false,
11           "preferred-theme-variant": "light"
12         },
13         "light": {
14           "inquiry": {
15             "primary-color": {
16               "unit": "hex",
17               "value": "#111111"
18             }
19           },
20           "components": {
21             "button": {
22               "primary": {
23                 "base": {
24                   "background-color": {
25                     "unit": "hex",
26                     "value": "#111111"
27                   },
28                   "text-color": {
29                     "unit": "hex",
30                     "value": "#FFFFFF"
31                   }
32                 }
33               }
34             }
35           }
36         }
37       },
38       "created-at": "2026-01-01T00:00:00.000Z",
39       "updated-at": "2026-01-01T00:00:00.000Z"
40     }
41   }
42 }

Creates a new theme set. The data attribute carries the nested theme tree (settings / light / dark) — the same shape as the Code-First theme-set YAML. Style cells that are not supported are rejected with a 400 naming each offending path.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

fieldsmap from strings to stringsOptional

Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See Serialization for more details.

Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.

Request

This endpoint expects an object.

dataobjectRequired

Response headers

RateLimit-Limitinteger

The maximum number of requests permitted in the current rate limit window for the API key used to authenticate the request. Returned on every authenticated response.

RateLimit-Remaininginteger

The number of requests remaining in the current rate limit window for the API key used to authenticate the request. Returned on every authenticated response.

RateLimit-Resetinteger

The number of seconds until the current rate limit window resets. Returned on every authenticated response.

Request-IdstringOptional

The unique identifier of the API log entry that recorded this request. Starts with req_. Include this value when reaching out to Persona support. Present on every authenticated response, including error responses.

Persona-Environment-IdstringOptional

The token of the Persona environment that handled the request. Returned on every authenticated response, including most error responses.

Persona-Organization-IdstringOptional

The token of the Persona organization that handled the request. Returned on every authenticated response, including most error responses.

Response

This endpoint returns a Theme Set object.

dataobject

A Theme Set object

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

422

Unprocessable Entity Error

429