> ## Documentation Index
> Fetch the complete documentation index at: https://plain-docs-orca-916-agent-docs-restructure.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Notes

> Notes are internal comments on a thread. They appear in the timeline but never reach the customer.

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 user, a reminder, or annotations from an automation.

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

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" />