roasOSBrand
The three families that hold what roasOS knows about your brand: the kit, the memory and the compiled intelligence.
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 | /v1/brand-kit | the look: the logo, five colour roles, two font names and the call to action |
| Memory | /v1/memory | what you teach the agent: the pinned facts and the marketing brief |
| Intelligence documents | /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 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.
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.
One door in this area does spend credits: POST /v1/workflows/extract-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.
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).