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

# Brands

> List the workspace's brands, to pick which one a skill paints with when you ask for your brand.

Some skills offer "your brand" as a colour: Background remover's `output: brand`, Stamp a watermark's `colour: lime`, and the others listed in [Brand kit](https://docs.mediamonster.app/brand-kit.md#your-brand-in-the-skills). They use the colour marked **Primary** in one of the workspace's [brands](https://docs.mediamonster.app/brand-kit.md).

A key belongs to a person, so it works in the workspace that person is working in. Owners, admins, members and viewers can list its brands. A guest's key is refused with `403 not_allowed`.

## List brands

```bash theme={"theme":{"light":"github-dark","dark":"github-dark"}}
curl https://mediamonster.app/api/v1/brands \
  -H "Authorization: Bearer mm_live_…"
```

```json theme={"theme":{"light":"github-dark","dark":"github-dark"}}
{
  "brands": [
    { "id": "3f0c…", "name": "Acme", "is_default": true, "primary_colour": "#FF0055" },
    { "id": "9b21…", "name": "Acme Kids", "is_default": false, "primary_colour": null }
  ]
}
```

The default brand comes first, then the rest by name.

| Field | What it is |
| - | - |
| `id` | The brand's id. Pass it as the `brand` option |
| `name` | The brand's name, or `Untitled` |
| `is_default` | `true` for the workspace's default brand. Exactly one brand has it |
| `primary_colour` | The colour a skill paints with, as `#RRGGBB`, or `null` for a brand with no colours yet |

## Pick a brand for a step

Add `brand` to a step's options, next to the option that asks for your brand:

```bash theme={"theme":{"light":"github-dark","dark":"github-dark"}}
curl https://mediamonster.app/api/v1/run/background-remover \
  -H "Authorization: Bearer mm_live_…" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/shoe.jpg", "options": {"output": "brand", "brand": "9b21…"}}'
```

The same option works on a step in a recipe sent to `POST /api/v1/runs`.

* **Without `brand`**, the step uses the default brand.
* **A `brand` that isn't in this workspace**, for example one from a recipe shared by another workspace, also uses the default brand.
* **A brand with no colour** uses the default brand's colour.
* **With no brands, or no colour on the default,** the step uses Mediamonster's lime.

To change the default, open the brand at [mediamonster.app/brand](https://mediamonster.app/brand) and click **Make default**. Brands are changed in the app, not over the API.

Over [MCP](https://docs.mediamonster.app/mcp.md), the `list_brands` tool returns the same list.


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