Skip to contentDevelopersPrezly website
Newsroom themes

Apply Theme Preset

Activate a theme using settings validated for this newsroom.

Personal token scopes: sites:write. Your account must also have access to the requested data. Authentication

Supplied settings replace saved overrides on top of theme defaults; omitted or null settings retain the preset. Use PATCH to save without activating a different theme.

Read the guide

POST
/newsrooms/{newsroom_id}/themes/{id}

Apply theme to particular newsroom with provided settings.

Apply activates this theme. Provided settings replace saved overrides on top of defaults; include every override to preserve. Omitted or null settings retains saved settings. The theme settings schema and account feature restrictions apply.

Personal access tokens: sites:write. Every listed scope is required; the token owner's permissions, feature availability and newsroom access still apply.

Authorization

API_key
headerAuthorizationBearer <token>

Bearer authentication using an integration API key, or a personal access token only where the operation explicitly supports it. Every listed personal-token scope is required; owner permissions and newsroom access still apply.

Path Parameters

newsroom_id*string

Newsroom UUID or ID

Length1 <= length
id*string

Theme ID

Request Body

application/json
  1. body
settings?|

Values validated against the editable settings schema for this theme and account. This replaces saved overrides on top of theme defaults.

key_features?array<>

Response Body

OK

application/json
  1. response
theme?
Example Request
curl -X POST 'https://api.prezly.com/v2/newsrooms/string/themes/string' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response200
{  "theme": {    "theme": {      "id": "string",      "name": "string",      "description": "string",      "features": [        "string"      ],      "preview_image": {        "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",        "version": 0,        "filename": "string",        "mime_type": "string",        "size": 0,        "original_width": 0,        "original_height": 0,        "effects": [          "string"        ]      },      "is_custom": true,      "is_legacy": true,      "demo_url": "string",      "status": "beta",      "codename": "string"    },    "editable_settings": {},    "settings": {},    "is_active": true,    "email_branding": {      "background_color": "string",      "title_color": "string",      "text_color": "string",      "link_color": "string"    },    "preview_url": "string"  }}