Send a message to a synthetic audience chat session

Sends a message to an existing audience chat session and returns the synthetic persona's predicted response. This is the second step of the aetherya_ask_audience MCP tool.

post/api/audience-chat/message

Request

  • Base URL: https://api.aetherya.ai
  • URL: https://api.aetherya.ai/api/audience-chat/message
  • Auth: HTTP bearer

Headers

X-Aetherya-Workspace-Idstring

Optional for auth.md delegated tokens (their human-approved workspace is bound into the token); legacy API-key calls may include this header to select a workspace.

Request body

sessionIdstring required

The session id returned by POST /api/audience-chat/sessions.

messagestring required

The question or message to send to the synthetic audience.

chatContextstring

Optional additional context for this message.

Response

Persona response.

successboolean required
modestring
replystring required

The synthetic persona's predicted response.

innerThoughtsstring

Optional inner-monologue reasoning from the persona (may not always be present).

sessionIdstring
messageIdstring

Changes

No recorded changes to this operation across all 1 revision of this API.