Skip to main content
POST
Creates a study in your organization. Versive applies sensible default configuration (interview mode, messages, screen-out defaults) and merges any config you provide over those defaults.
string
required
The study title.
string
Internal description of the study.
string
default:"VERSIVE_STUDY"
Study type. Use VERSIVE_STUDY (default) for AI-moderated studies.
string
default:"TEXT_AND_VOICE"
Conversation mode: TEXT_ONLY, TEXT_AND_VOICE, VOICE_WITH_PREVIEW, or VIDEO.
string
default:"FULL_ACCESS"
Controls which organization members can access the study. Use FULL_ACCESS, CAN_EDIT, CAN_EDIT_SURVEY_ONLY, CAN_VIEW, or INVITE_ONLY. This does not control participant access.
object
Study configuration overrides, merged over Versive’s defaults (AI interviewer settings, branding, languages, device rules, and so on).Branding and languages you omit here are filled in from your organization’s study defaults; values you send explicitly are kept as-is. A lang you send keeps its default language, and an empty support list still takes the organization’s supported languages. A support list you send stays, except for a language that becomes the study’s default. When the organization’s default language applies, the welcome, thank-you, and screen-out messages you omit (or send as Versive’s English defaults) are written in that language. When the organization has a default response limit, the new study gets that Total completes quota (returned as quota); change it with PUT /studies/{id}/quotas. Participants see a supported language only once the study is translated: after adding questions, call Translate a study.Participant colors are primaryColor, textColor and backgroundColor, each a 6-digit hex value like #18181B (any other value returns a 422). Leave textColor and backgroundColor out, or send an empty string, to take your organization’s defaults; with no defaults set, participants see dark text on white. See Branding.AI interviewer settings you omit (interviewerPersonality, guidelines, allowQuestionRephrasing, questionRephrasingInstructions, interviewMode) use the same defaults as a study created in the dashboard, so the interviewer may rephrase questions. Send "allowQuestionRephrasing": false to have questions asked word for word.Memory is set with enableMemory (boolean, off by default), memoryFocus and memoryUsageRules (strings, up to 300 characters each).The tutorial page switches are set with tutorial: { enabled, requireMicCheck, showMicTest, showTimerColors, showTroubleshooting }, all booleans. Switches you omit are off, so send "enabled": true to show the page. null counts as false. Unknown switches and any other value return 422.
object
Welcome screen: { title, body, ctaText }.
object
Tutorial page copy: { title, content, ctaText }, where content is HTML. Fields you omit use the default page (header Before you begin, three setup tips, button Continue). See Copy for the length limits, the HTML that’s kept, and the 422 errors. The page is only shown once config.tutorial.enabled is true.
object
Completion screen: { title, body, ctaText, ctaLink }.
object
Screen-out screen: { title, body, ctaText, ctaLink }. A default is applied if omitted.
string
Folder to create the study in.
object
Arbitrary key/value metadata stored on the study.
object
Insights configuration (e.g. analysis model).

Response

Returns the created study (status 201) with fields: id, title, description, metadata, type, mode, config, welcome_message, tutorial_message, thank_you_message, screen_out_message, status, quota, pause_url, access_policy, and created_at.