Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

API key prefixed with mvra_live_. Create keys at Settings > Developer > API Keys.

Body

application/json
name
string
required

Name/title for the focus group study.

Required string length: 3 - 100
Example:

"Product Feedback Study Q1 2026"

sample_size
integer
required

Number of responses to generate per persona per question.

Required range: 1 <= x <= 500
Example:

50

persona_ids
string[]
required

Array of persona IDs to participate in the focus group. Get persona IDs from GET /personas.

Required array length: 1 - 20 elements
Example:
questions
object[]
required

Array of questions for the focus group.

Required array length: 1 - 50 elements

Response

Focus group created and processing started.

id
string

Unique focus group ID.

Example:

"cly2xyz3e0001efghij456789"

object
enum<string>
Available options:
focus_group
Example:

"focus_group"

status
enum<string>

Current processing status.

Available options:
pending,
generating,
completed,
failed
Example:

"pending"

created_at
integer

Unix timestamp of creation.

Example:

1706380800

name
string
Example:

"Product Feedback Study Q1 2026"

sample_size
integer
Example:

50

credits_charged
integer

Total credits charged for this focus group.

Example:

500

personas
object[]
questions
object[]