---
title: "List pinned facts"
description: "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.\n\nFree, and there is no quote."
url: https://docs.roasos.com/api-reference/memory/listMemoryPins
---

# 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`

Endpoint: `GET https://api.roasos.com/v1/memory/pins`

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.

### Parameters

- `category` (query)
- `undefined`
- `undefined`

### Responses

- `200`: One page of pinned facts
- `400`: Invalid cursor, limit or category
- `501`: not_implemented: the memory API is contracted and not live yet
- `503`: The memory store is temporarily unavailable

Read the full reference at https://docs.roasos.com/api-reference/memory/listMemoryPins.