> ## Documentation Index
> Fetch the complete documentation index at: https://www.plain.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Notes

<Snippet file="graphql/sdk-note.mdx" />

Notes are internal comments that show up in the thread timeline alongside customer messages but are only visible to your team. They're useful for context — like a heads-up from another teammate, a reminder, or annotations from an automation.

Notes can be attached either to a customer (visible across all of that customer's threads) or specifically to a thread (visible only in that thread's timeline).

These operations require the following permissions:

* `note:create`
* `note:edit`
* `note:delete`

## Create a note

`text` is the plain-text body. If you also pass `markdown`, that version is preferred where rich text is supported.

<Snippet file="graphql/create-note.mdx" />

## Update a note

<Snippet file="graphql/update-note.mdx" />

## Delete a note

<Snippet file="graphql/delete-note.mdx" />