personas

Execute Survey Stream

Execute a survey simulation and receive streaming updates. Returns a stream of JSON objects (SSE).

post/v1/personas/surveys/stream

Request

Base URL
https://api.evidenso.com (the document declares no server; this is the origin it was published from)
Auth
HTTP bearer

questionstring required

Full message content

conversationIdstring nullable

topKinteger

Always 3

categorystring nullable

Always 'survey_simulation'

num_respondentsinteger nullable

Sample size from UI (10-100,000)

job_rolestring[] nullable

Multiselect dropdown: Job roles from persona group (e.g., ['Product Manager', 'Engineer']) or single string

countrystring[] nullable

Multiselect dropdown: Countries (e.g., ['UK', 'US']) or comma-separated string like 'UK,US'

senioritystring[] nullable

Multiselect dropdown: Seniority levels (e.g., ['Senior', 'Executive']) or single string

experiencestring[] nullable

Multiselect dropdown: Experience ranges (e.g., ['5-10 years', '10+ years']) or single string

positionstring[] nullable

Multiselect dropdown: Positions/titles (e.g., ['Product Manager', 'Director']) or single string

imagesstring[] nullable

Base64-encoded images

modelstring nullable

LLM model to use (e.g., 'gpt-5', 'gpt-4o'). Defaults to 'gpt-5' if not provided

Successful Response

unknown required

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