FAfanvue

Update fan notes

Changed on

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.

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

Path parameters

userUuidstring uuid required

Headers

X-Fanvue-API-Versionstring required
Example:2025-06-26

API version to use for the request

Request body

notesstring nullable required

The full replacement notes (max 5000 characters). Pass null or an empty string to clear them.

Response

The stored notes

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

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

Changes