---
title: "Update fan notes"
method: PUT
path: "/chats/{userUuid}/notes"
---

# Update fan notes

`PUT /chats/{userUuid}/notes`

## Request

- Base URL: `https://api.fanvue.com`
- URL: `https://api.fanvue.com/chats/{userUuid}/notes`
- Auth: OAuth 2
  - Authorization code: `https://auth.fanvue.com/oauth2/auth`
  - Token URL: `https://auth.fanvue.com/oauth2/token` scopes: `write:chat`

Replaces the authenticated user's notes about a fan and returns the stored result.

These are the notes a creator keeps on a fan in the Fanvue chat sidebar and contact list. Only the manually written notes are exposed; automatically generated fan summaries are never returned. Notes do not require an existing conversation with the fan.

The body replaces the notes in full, so send the complete text rather than a delta. Pass `null` (or an empty string) to clear them. Returns 400 if `userUuid` is your own UUID and 404 if the user does not exist.

## Path parameters

- `userUuid` string, uuid, required

## Headers

- `X-Fanvue-API-Version` string, required

## Request body

- object
  - `notes` string, nullable, required: The full replacement notes (max 5000 characters). Pass null or an empty string to clear them.

## Response `200`

The stored notes

- object
  - `notes` string, nullable, required: The notes kept about this fan, or null when none have been written. Only the manually written notes are returned; automatically generated summaries are never included.
  - `updatedAt` string, date-time, nullable, required: When the notes were last changed, or null when no notes are stored. The timestamp belongs to the fan's customisation record, so other changes to that record, including a nickname edit or internal updates, also move it.

## Other responses

- `400`: Bad Request - API version not supported OR validation failed OR invalid UUID
- `401`: Unauthorized Response
- `403`: Unauthorized Response
- `404`: Not Found Response
- `410`: API version no longer supported (sunset)
- `429`: Too many requests - rate limit exceeded

## Changes

- **2026-10-12** `1c26ce04b411`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fanvue/apis/fanvue-api/changes/chats/:userUuid/notes/put.md)

---

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