Update a Theme Set

PATCH

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

PATCH

/api/v1/theme-sets/:theme-set-id

$ curl -X PATCH https://api.withpersona.com/api/v1/theme-sets/theme-set-id \
>      -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": "#222222"
>             }
>           }
>         }
>       }
>     }
>   }
> }'

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": "#222222"
18             }
19           }
20         }
21       },
22       "created-at": "2026-01-01T00:00:00.000Z",
23       "updated-at": "2026-01-02T00:00:00.000Z"
24     }
25   }
26 }

Updates an existing theme set. Both attributes are optional — an omitted attribute is left unchanged. When styles is present it replaces the stored styling wholesale: the tree carries the complete desired styling, and any cell absent from it falls back to the Persona default cascade.

Authentication

AuthorizationBearer

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

Path parameters

theme-set-idstringRequired

ID of the theme set to update

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

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error