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

# update_reply

> Updates a draft social reply.

Updates a draft social-listening reply (Reddit, Hacker News, X, LinkedIn listening). Patches `reply_text` and/or `status`; brand is resolved from the auth context.

## When to use

* The user has reviewed the auto-generated reply text and wants the agent to revise it.
* A draft needs to move to `queued` or `cancelled` without posting.

## When not to use

* The user wants to mark the reply as posted with a live URL — use [`mark_reply_posted`](/mcp/writes/mark-reply-posted) instead.
* The user wants to schedule it for a specific date — use [`schedule_reply`](/mcp/writes/schedule-reply).
* The reply doesn't exist yet — replies are created in the social-listening UI's Generate Reply flow.

## Status values

Allowed: `draft`, `queued`, `scheduled`, `published`, `cancelled`. Flipping to `published` without supplying `posted_url` leaves the URL blank — prefer [`mark_reply_posted`](/mcp/writes/mark-reply-posted) for that transition.

Returns the updated reply on success, or an error if the reply doesn't exist or doesn't belong to this brand.

## See also

* [Overview](/mcp/overview)