roasOS
API referenceMemory

List pinned facts

Read the creative-direction facts this workspace has pinned: brand voice, audience, hooks, banned phrases, wins and notes. These are the same rows the agent reads in chat. Free, and there is no quote.

GET
/v1/memory/pins

Read the creative-direction facts this workspace has pinned: brand voice, audience, hooks, banned phrases, wins and notes. These are the same rows the agent reads in chat.

Free, and there is no quote.

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication. Use your API key as the bearer token: Authorization: Bearer roasos_sk_...

In: header

Query Parameters

category?string

Value in

  • "brand_voice"
  • "audience"
  • "hook"
  • "banned"
  • "win"
  • "note"
cursor?string

Opaque composite pagination cursor from the previous response. Do not parse or construct it.

limit?integer

Number of items to return

Range1 <= value <= 100
Default20

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/memory/pins"
{  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "category": "brand_voice",      "content": "string",      "metadata": {        "property1": null,        "property2": null      },      "created_at": "2019-08-24T14:15:22Z"    }  ],  "meta": {    "cursor": "string",    "has_more": true  }}

Replace the brand kit

Replace the whole brand kit. There is no PATCH: an omitted field clears that part of the kit. The logo must be media this workspace owns, named by its immutable `cdn.roasos.com` URL — upload it at `POST /v1/uploads` first. A URL from another workspace is refused with `reference_media_not_workspace_owned`, and a Discover creative is refused by name with `discover_source_not_allowed`. Colours are lower-case six-digit hex, one per role. Fonts are NAMES, not files: roasOS hosts no font and embeds none, so a later render maps the name onto a bundled fallback. That is a real limit, not a placeholder. Free, and there is no quote: proving your logo does not buy it.

Pin a fact

Teach the agent one confirmed fact about this brand. Pin confirmed facts only, never speculation — the agent treats a pin as true. A category holds fifty pins; the oldest is dropped when the fifty-first arrives, and the marketing brief is never dropped that way. Free, and there is no quote.