> **Shapeless capabilities index**
> Fetch https://shapelessai.com/llms.txt to discover every page before exploring further.
> Every page also answers Markdown: append `.md` to its path, or send `Accept: text/markdown`.

# Read and write Brand Memory

*Verified 2026-10-07. Source: https://shapelessai.com/capabilities/brand-memory*

The account's durable knowledge as files: voice, positioning, product facts, audience, what has worked.

Read the tree with its completion ring, read or write one file, delete one, export the whole thing as a zip, scan a link and file what it says, or import a document. Every job and agent reads Brand Memory before it writes, so an agent that fixes a fact here fixes every post after it. An agent can complete the onboarding this way: scan the website, then fill in what the scan could not know.

## Ask in plain words

- "read our positioning from Brand Memory"
- "update the product facts: we now support Bluesky"
- "scan our website and fill in the brand"
- "import this PDF about our product into Brand Memory"
- "export everything you know about my brand"

## From an agent host (MCP)

Server: `https://shapelessai.com/mcp` ([add it to your host](https://shapelessai.com/connect)).

- `brain_tree`: Brand Memory's file list with the completion ring. Needs the read scope.
- `brain_read`: Read one Brand Memory file. Needs the read scope.
- `brain_write`: Write one Brand Memory file (.md paths only) - the agent grounds future posts in it. Needs the write scope.
- `brain_onboarding`: What is still open in Brand Memory, as the questions a human answers, with hints. Ask the human, write the answers as markdown under the question headings with brain_write at the item's path, then call again until open is empty. Needs the read scope.

## From code (REST)

Bearer API key with the scope each call names ([auth](https://shapelessai.com/docs/auth), [OpenAPI](https://shapelessai.com/api/openapi.json)).

- `GET /api/workspace` (read scope): Brand Memory's file tree with its completion ring.
- `GET /api/workspace/file` (read scope): One Brand Memory file (?path=).
- `PUT /api/workspace/file` (write scope): Write one file.
- `DELETE /api/workspace/file` (write scope): Delete one file.
- `GET /api/workspace/export` (read scope): The whole Brand Memory as a zip.
- `GET /api/workspace/onboarding` (read scope): What is still open in Brand Memory, as the questions a human answers, with hints. PUT each answer to /api/workspace/file and call again until open is empty.
- `POST /api/brain/scan` (write scope): Read a link and file what it says into Brand Memory (NDJSON).
- `POST /api/brain/import` (write scope): Import a .md/.txt/.pdf/.docx document.

## From a terminal (CLI)

- `shapeless brain ls`
- `shapeless brain onboarding`
- `shapeless brain get`
- `shapeless brain put`
- `shapeless brain rm`
- `shapeless brain import`
- `shapeless brain export`

## Example

```bash
curl -s "https://shapelessai.com/api/workspace/file?path=positioning.md" -H "Authorization: Bearer $SHAPELESS_API_KEY"
```
```jsonc
// MCP tool call
{ "tool": "brain_write", "arguments": { "path": "facts.md", "content": "# Facts\n- Publishes to nine networks, Bluesky included." } }
```
```bash
shapeless brain put facts.md < facts.md
```

## Where else

- [Do it in the studio](https://shapelessai.com/brain)
- [The brand memory docs](https://shapelessai.com/docs/brand-memory) ([markdown](https://shapelessai.com/docs/brand-memory.md))