# Retrieve the workspace brand theme

`GET /v1/brand-theme`

Requires an API key with the `templates:read` scope. [About keys and scopes](/docs/api/authentication)

Any member. Every email's `theme` holds only the fields it overrides; the rest come from here. A change restyles templates and draft campaigns and journeys at once. Scheduling or sending a campaign, activating a journey and publishing a template freeze the look that email goes out with, so nothing already approved changes. Templates saved before the brand existed carry every field, so they keep their look until a field is reset.

## Returns

Returns `200 OK` with a `EmailTheme` in `data`. Otherwise returns an error; [Errors](/docs/api/errors) lists every code and which to retry.

- `font` (string, optional, up to 200 characters) — Body font stack, such as `Inter, sans-serif`.
- `hfont` (string, optional, up to 200 characters) — Heading font stack.
- `bg` (string, optional) — Background of the email card, as hex.
- `canvas` (string, optional) — Background behind the card, as hex.
- `text` (string, optional) — Default text colour, as hex.
- `accent` (string, optional) — Brand colour for buttons and highlights, as hex.
- `link` (string, optional) — Link colour, as hex.
- `width` (string, optional, one of `560px`, `600px`, `680px`) — Width of the email card on wide screens.
- `radius` (string, optional, one of `0px`, `6px`, `12px`, `16px`, `24px`, `999px`) — Corner rounding of the email's card.
- `btnRadius` (string, optional, one of `0px`, `6px`, `12px`, `16px`, `24px`, `999px`) — Button corners; `radius` rounds the email's card and, when this is unset, buttons.
- `btn` (string, optional, one of `solid`, `outline`) — Button style.

## Example

```bash
curl https://api.kirora.io/v1/brand-theme \
  -H "Authorization: Bearer $KIRORA_API_KEY"
```

Response `200`:

```json
{
  "data": {
    "font": "font_example",
    "hfont": "hfont_example",
    "bg": "bg_example",
    "canvas": "canvas_example",
    "text": "text_example",
    "accent": "accent_example",
    "link": "link_example",
    "width": "560px",
    "radius": "0px",
    "btnRadius": "0px",
    "btn": "solid"
  }
}
```