---
title: "Start Meeting Preference Test"
method: POST
path: "/v1/internal/meetings/{session_id}/preference-tests"
tags: ["internal-meetings"]
---

# Start Meeting Preference Test

`POST /v1/internal/meetings/{session_id}/preference-tests`

## 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/internal/meetings/{session_id}/preference-tests`
- Auth: none declared

Start the canonical Preference Test workflow for one confirmed pulse.

## Path parameters

- `session_id` string, required

## Headers

- `authorization` string
- `x-evidenso-service-token` string, nullable

## Request body

- MeetingPreferenceTestRequest
  - `owner_user_id` string, required
  - `trace_subject_id` string, required
  - `pulse_id` string, required
  - `conversation_id` string, required
  - `board_id` string, required
  - `source_node_id` string, required
  - `society_ids` string[], required
  - `question` string, required
  - `variants` string[], required

## Response `200`

Successful Response

- MeetingPreferenceTestResponse
  - `status` 'running' | 'completed' | 'failed' | 'context_not_found', required
  - `session_id` string, required
  - `execution_id` string, nullable
  - `board_id` string, nullable
  - `board_url` string, nullable
  - `result` MeetingPreferenceResult
    - `actual_response_count` integer, required
    - `winner` MeetingPreferenceWinner
      - `label` string, required
      - `text` string, required
      - `count` integer, required
      - `percentage` integer, required
    - `percentages` MeetingPreferenceOptionResult[]
      - `label` string, required
      - `text` string, required
      - `count` integer, required
      - `percentage` integer, required
    - `evidence_depth` object, nullable
    - `synthesized_insight` string, nullable

## 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)