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

# Suggested replies

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

Suggested replies (also called generated replies) allow you to programmatically add AI-generated or pre-composed reply suggestions to a thread. These suggestions are shown to the user in Plain so they can review and send them to the customer.

This is useful if you are building your own AI integration or want to suggest replies based on your own logic, external knowledge bases, or automation workflows.

## Adding a suggested reply

To add a suggested reply you need to provide the `threadId`, the `timelineEntryId` of the customer message you are responding to, and the `markdown` content of the reply. The timeline entry must be from a customer — suggested replies cannot be added against non-customer messages.

A `timelineEntryId` identifies a single entry on a customer's timeline (e.g. an email or chat message). You can get one by querying a thread's `timelineEntries` connection, where each entry has an `id` you can use here.

The `markdown` field supports a maximum of 5,000 characters.

To add a suggested reply, you need an API key with the following permissions:

* `generatedReply:create`

<Snippet file="graphql/add-generated-reply.mdx" />