Generate synthetic audience personas

DEPRECATED. Superseded by the async create path; slated for /api/v1/audiences.

Generates one or more synthetic personas. When customTraits or websiteUrl is supplied, the simulation engine generates personas matching the description. All personas are synthetic — engine-generated simulated people, not real users. This call may take up to ~110 seconds for engine-generated batches.

post/api/personas/create

Request

  • Base URL: https://api.aetherya.ai
  • URL: https://api.aetherya.ai/api/personas/create
  • 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

type'individual' | 'batch'

Use 'individual' for one persona, 'batch' for multiple.

countinteger

Number of personas to generate.

categorystring

Segment label (e.g. 'e-commerce', 'fintech').

targetAudiencestring

Plain-language audience description.

customTraitsstring

Detailed audience description. Triggers engine generation (slower path).

websiteUrlstring uri

Optional site URL. Aetherya infers the audience from its content.

marketstring

Target market / locale (e.g. 'US', 'DE', 'UK').

Response

Created personas.

successboolean required
errorstring
messagestring

Changes

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