---
title: "Create an audience chat session"
method: POST
path: "/api/audience-chat/sessions"
---

# Create an audience chat session

`POST /api/audience-chat/sessions`

## Request

- Base URL: `https://api.aetherya.ai`
- URL: `https://api.aetherya.ai/api/audience-chat/sessions`
- Auth: HTTP bearer

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

## Headers

- `X-Aetherya-Workspace-Id` string

## Request body

- object
  - `mode` 'persona' | 'group', required: Target a single persona or a group.
  - `targetPersonaId` string: The persona id to chat with (required when mode is 'persona').
  - `targetGroupId` string: The group id to chat with (required when mode is 'group').
  - `title` string
  - `chatContext` string: Background/situation for the persona to consider.

## Response `200`

Session created.

- object
  - `success` boolean, required
  - `data` object
    - `id` string, required
  - `error` string

## Other responses

- `401`: Missing or invalid API key.

---

[API](https://skmtc.dev/aetherya/apis/aetherya-api.md) · [All operations](https://skmtc.dev/aetherya/apis/aetherya-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aetherya/apis/aetherya-api/revisions/afa076131ee1?raw)