Create an audience chat session

Creates a conversation session with a synthetic persona. Used as the first step of the aetherya_ask_audience MCP tool — follow with a POST to /api/audience-chat/message.

post/api/audience-chat/sessions

Request

  • Base URL: https://api.aetherya.ai
  • URL: https://api.aetherya.ai/api/audience-chat/sessions
  • 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

mode'persona' | 'group' required

Target a single persona or a group.

targetPersonaIdstring

The persona id to chat with (required when mode is 'persona').

targetGroupIdstring

The group id to chat with (required when mode is 'group').

titlestring
chatContextstring

Background/situation for the persona to consider.

Response

Session created.

successboolean required
errorstring

Changes

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