---
title: "Brand"
description: "The three families that hold what roasOS knows about your brand: the kit, the memory and the compiled intelligence."
url: https://docs.roasos.com/brand
---

# Brand

Three API families hold what roasOS knows about your brand. Each family has one job, and no two families store the same value twice.

| Family                                        | Path               | What it holds                                                                |
| --------------------------------------------- | ------------------ | ---------------------------------------------------------------------------- |
| [Brand kit](/brand/brand-kit)                 | `/v1/brand-kit`    | the look: the logo, five colour roles, two font names and the call to action |
| [Memory](/brand/memory)                       | `/v1/memory`       | what you teach the agent: the pinned facts and the marketing brief           |
| [Intelligence documents](/brand/intelligence) | `/v1/intelligence` | what roasOS compiled from the rows above, ready to read                      |

The brand kit and the memory are the layer that you write. The intelligence documents are the layer that roasOS compiles from it. Refer to [Intelligence](/concepts/intelligence) for the full path from a website to a document.

## Every door here is free

Each door under `/v1/brand-kit`, `/v1/memory` and `/v1/intelligence` costs **0 credits**. Each one reads or writes stored rows. None of them calls a model.

<Callout type="warn">
  A 0-credit door never returns a quote envelope. It needs no `Idempotency-Key`, it accepts no `quote_only`, and it accepts no `quote_id`. Your software goes straight to the read or the write.
</Callout>

One door in this area does spend credits: [`POST /v1/workflows/extract-brand`](/workflows/extract-a-brand) reads your website for 2 credits. It is a workflow, and roasOS quotes it like every other paid call.

## Scopes

| Operation                                                                                    | Scope       |
| -------------------------------------------------------------------------------------------- | ----------- |
| Every `GET` under `/v1/brand-kit`, `/v1/memory` and `/v1/intelligence`                       | `api:read`  |
| `PUT /v1/brand-kit`, `POST` and `DELETE` under `/v1/memory`, `POST /v1/intelligence/refresh` | `api:write` |

## From an agent

Ten of these operations are also tools on `https://mcp.roasos.com/mcp`.

| Tool                                 | Operation                               |
| ------------------------------------ | --------------------------------------- |
| `roasos_get_brand_kit`               | `GET /v1/brand-kit`                     |
| `roasos_update_brand_kit`            | `PUT /v1/brand-kit`                     |
| `roasos_list_memory_pins`            | `GET /v1/memory/pins`                   |
| `roasos_create_memory_pin`           | `POST /v1/memory/pins`                  |
| `roasos_get_marketing_brief`         | `GET /v1/memory/brief`                  |
| `roasos_update_marketing_brief`      | `PUT /v1/memory/brief`                  |
| `roasos_get_intelligence_context`    | `GET /v1/intelligence/context`          |
| `roasos_list_intelligence_documents` | `GET /v1/intelligence/documents`        |
| `roasos_get_intelligence_document`   | `GET /v1/intelligence/documents/{slug}` |
| `roasos_refresh_intelligence`        | `POST /v1/intelligence/refresh`         |

`DELETE /v1/memory/pins/{id}` has no bound tool. Refer to [Memory](/brand/memory#a-connected-model-cannot-unpin).

The paid extraction door has a tool of its own, `roasos_extract_brand`. It belongs to the Workflows group, and not to the three families above. Refer to [Connect an AI agent (MCP)](/mcp).

## Next

<Cards>
  <Card title="Brand kit" href="/brand/brand-kit">
    The logo, the five colour roles, the two font names and the call to action.
  </Card>

  <Card title="Memory" href="/brand/memory">
    The pinned facts and the marketing brief.
  </Card>

  <Card title="Intelligence documents" href="/brand/intelligence">
    The compiled documents, and the door that recompiles them.
  </Card>

  <Card title="Extract a brand" href="/workflows/extract-a-brand">
    Read one brand from its own website in one paid call.
  </Card>
</Cards>