---
title: "Remember a preference"
method: POST
path: "/memory"
---

# Remember a preference

`POST /memory`

## Request

- Base URL: `https://clypmint.com/api/v1`
- URL: `https://clypmint.com/api/v1/memory`
- Auth: HTTP bearer

Teach Clypmint one lasting preference for every later video of this brand, in plain words: caption size, pace, sound effects, colours, "own footage first", or how a name is spelled. Up to 200 characters. Free. Cost: Free: no credits and no change round. Same as the MCP tool remember.

## Request body

- object
  - `text` string, required: One preference in plain words, e.g. "Bigger captions" or "Always spell it ClipMint".
  - `brand_id` string, uuid

## Response `200`

Remember a preference

- Result: The tool result, as the MCP tool of the same name returns it.

## Other responses

- `400`: The request is invalid. The message names each field to fix.
- `401`: A valid bearer token (API key or OAuth access token) is required.
- `402`: This account has no allowance left for this, or does not include it. error.checkout_url is where to add it.
- `403`: This needs publishing permission (scope clypmint.publish), or is not open on this account yet.
- `404`: The video, upload, memory or calendar was not found in this account.
- `409`: Busy: an upload or edit is already running, the video changed, or too many upload links are waiting.
- `413`: The request body is too large.
- `422`: Clypmint could not apply it as asked; error.problems names each part.
- `429`: A daily limit was reached (direct edits, caption fixes, upload links).
- `501`: This is not available on Clypmint yet; the message says what to use instead.
- `503`: Clypmint is busy. Try again in a moment.

---

[API](https://skmtc.dev/clypmint/apis/clypmint-api.md) · [All operations](https://skmtc.dev/clypmint/apis/clypmint-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clypmint/apis/clypmint-api/revisions/dde4982718df?raw)