---
title: "Pin a fact"
description: "Teach the agent one confirmed fact about this brand.\n\nPin 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.\n\nFree, and there is no quote."
url: https://docs.roasos.com/api-reference/memory/createMemoryPin
---

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

## `POST /v1/memory/pins`

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

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.

### Request body

Content type: `application/json`

### Responses

- `201`: The pinned fact
- `400`: validation_error
- `501`: not_implemented: the memory API is contracted and not live yet
- `503`: The pin could not be written

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