---
title: "Execute Survey Stream"
method: POST
path: "/v1/personas/surveys/stream"
tags: ["personas"]
---

# Execute Survey Stream

`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)
- URL: `https://api.evidenso.com/v1/personas/surveys/stream`
- Auth: HTTP bearer

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

## Request body

- SurveyRequest
  - `question` string, required: Full message content
  - `conversationId` string, nullable
  - `topK` integer: Always 3
  - `category` string, nullable: Always 'survey_simulation'
  - `num_respondents` integer, nullable: Sample size from UI (10-100,000)
  - `job_role` string[], nullable: Multiselect dropdown: Job roles from persona group (e.g., ['Product Manager', 'Engineer']) or single string
  - `country` string[], nullable: Multiselect dropdown: Countries (e.g., ['UK', 'US']) or comma-separated string like 'UK,US'
  - `seniority` string[], nullable: Multiselect dropdown: Seniority levels (e.g., ['Senior', 'Executive']) or single string
  - `experience` string[], nullable: Multiselect dropdown: Experience ranges (e.g., ['5-10 years', '10+ years']) or single string
  - `position` string[], nullable: Multiselect dropdown: Positions/titles (e.g., ['Product Manager', 'Director']) or single string
  - `images` string[], nullable: Base64-encoded images
  - `model` string, nullable: LLM model to use (e.g., 'gpt-5', 'gpt-4o'). Defaults to 'gpt-5' if not provided
  - `mentionedProducts` SrcModelsPersonaV1MentionedProduct[], nullable: Products mentioned via @ autocomplete
    - `id` string, required
    - `name` string, required
  - `mentionedFeatures` SrcModelsPersonaV1MentionedFeature[], nullable: Features mentioned via @ autocomplete
    - `id` string, required
    - `name` string, required
    - `productId` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/evidenso/apis/persona-rag-api.md) - [All operations](https://skmtc.dev/evidenso/apis/persona-rag-api/llms.txt) - [OpenAPI document](https://skmtc.dev/evidenso/apis/persona-rag-api/revisions/86408c178d4f?raw)