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

# Suggested replies

> Add a suggested reply to a thread for a user to review, edit, and send.

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.

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

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