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

# The Herald

> Ask about your brand, review the evidence and decide what Heralded does next.

The Herald is your assistant for the brand. Ask about your scores, competitors, sources, site or any piece of work. Heralded does the work. The Herald explains it and offers changes for you to confirm.

## Open the Herald

Choose **Ask the Herald** from a brand page, or press ⌘J. On Windows and Linux, use Ctrl+J. The Herald opens on the right with a greeting and suggested questions. Choose a question or write your own. On a phone, it fills the screen.

The composer shows the page or panel you opened it from. Its filters travel with your message. Use **Remove context** to ask without that subject. **Split with the page** keeps the Herald beside the page on a wide screen. **Back over the page** returns it to a floating panel.

## Your conversations

**Ask the Herald** and **New chat** start a private conversation. Only you can read it, including when someone else owns or administers the workspace. **Share** makes the whole conversation readable by everyone who can read the brand. You cannot make it private again.

Open **Recent chats** in the Herald header to return to one of your six newest chats. Archived chats leave the list.

Hover over a message or focus its controls to reveal **Reply**. Choosing it quotes that message in your reply. On a phone, **Reply** stays visible.

The creator can rename or archive a chat from its menu. **Archive** offers **Undo**. An archived chat stays readable and accepts no new messages. Earlier conversations with other assistants stay readable and accept no new messages. Work updates appear on the work item and in your notifications.

The Herald answers every message in a private chat. In a shared conversation, mention **@Herald** or reply to an answer to ask it directly. Otherwise, a message mentioning only colleagues gets no automatic answer. Mentioned colleagues can receive an email according to their notification preferences.

## Ask about what you see

A message can carry the page or panel you are reading, with its filters. The Herald reads that subject's evidence before offering work. It can explain a current draft and propose changes, but replacement copy belongs in the draft review.

The greeting shows your waiting decisions and new results since your last Home visit, with questions for the page. It consumes none of your monthly answer allowance. Answers can include links back to the evidence.

## Confirm a change

An answer can offer work, a question or competitor change, or a draft revision. The card states what will change and any content credit cost. Choose **Start** to begin suggested work. The change uses your permissions and checks the current evidence and limits. Viewers can ask questions and read proposals but cannot confirm a change to the brand.

**Not now** sets a proposal aside without changing its work item. Handled proposals show **Started**, **Applied** or **Not now** in place of their buttons. Retrying a click does not repeat the change. Heralded cannot file work without the evidence its kind requires.

Ordinary answers use your [monthly answer allowance](https://docs.heralded.ai/concepts/usage.md#agent-answers). Messages sent during onboarding before setup confirmation are exempt, including when their answer arrives after confirmation. Per-person and per-brand rate limits still apply.

## Read through the API

`GET /v1/brands/{brand_id}/conversations` and MCP `list_conversations` list the conversations you can read. Private chats stay limited to their owner. Read a conversation with `GET /v1/brands/{brand_id}/conversations/{conversation_id}/messages` or MCP `get_conversation_by_id`.

Existing `GET /v1/brands/{brand_id}/conversations/{member}` paths and MCP `get_conversation` return stored history. The stored member keys remain valid. Posting and confirming proposals stay in the app.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.