> ## Documentation Index
> Fetch the complete documentation index at: https://docs.joinmarkt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Merchant themes

> List catalog themes and apply one to a store with a Bearer API key.

```http theme={null}
GET  /api/merchant/v1/stores/{storeId}/themes
POST /api/merchant/v1/stores/{storeId}/themes/apply
```

Scopes: `theme:read` · `theme:write` · ceiling `editDesign`

```json theme={null}
{ "themeSlug": "nova", "publish": false }
```

`publish` defaults to `true` (live storefront). Send `false` to apply as draft only. Unknown slugs return `404`. Theme zip upload stays on the dashboard builder.

## Related

* [Merchant storefront](/api/merchant-storefront)
* [API keys](/developers/api-keys)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.