Creates a randomizer from content that already exists in the study. Each arm shows one question or one existing question group; when an arm lists several question_ids, they are moved into a new group for that arm automatically. An arm may be left empty as a placeholder, but every arm needs a target before participants can be routed to it.
string
required
The study ID.
string
required
Internal name, e.g. "Concept test".
array
required
2 to 12 arms. Each arm: label (string), weight_basis_points (integer, 1–10000; all arms must total exactly 10000), and one of question_ids (array of question IDs), question_id (a single question), or question_group_id (an existing group), or none of them for an empty arm.
integer
Top-level position after the arm content is moved into the arms. Omit to append.
Response
201 with the created randomizer, same shape as List randomizers.
A question or group can belong to only one arm, and logic rules must never jump between arms — a participant only ever sees one.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Versive","description":"Documentation for Versive — the AI-powered user research and testing platform","colors":{"primary":"#00786F","light":"#2BB3A8","dark":"#00786F"},"logo":{"light":"https://mintcdn.com/versive/Og7M_uVBtd7MTGJK/logo/light.svg?fit=max\u0026auto=format\u0026n=Og7M_uVBtd7MTGJK\u0026q=85\u0026s=3de4d6717f3a65645f417a61cc68828d","dark":"https://mintcdn.com/versive/Og7M_uVBtd7MTGJK/logo/dark.svg?fit=max\u0026auto=format\u0026n=Og7M_uVBtd7MTGJK\u0026q=85\u0026s=dd51cb606f5301040c8219b572a717fc","href":"https://getversive.com"},"favicon":"https://mintcdn.com/versive/-C2_T5LPeZ5Csg69/favicon.ico?fit=max\u0026auto=format\u0026n=-C2_T5LPeZ5Csg69\u0026q=85\u0026s=ec8e3723f4e24346fcea7c20b5e480ce","api":{"mdx":{"auth":{"method":"bearer"},"server":"https://api.getversive.com/api/v1"}},"navbar":{"links":[{"href":"mailto:[email protected]","label":"Support"}],"primary":{"type":"button","label":"Open Versive","href":"https://getversive.com/login"}},"footer":{"socials":{"website":"https://getversive.com","linkedin":"https://www.linkedin.com/company/versivehq"}},"icons":{"library":"tabler"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"versive","hasAudioNarration":false,"actualSubdomain":"versive","customDomains":["docs.getversive.com"],"gitSource":{"type":"github","owner":"trymirio","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afb8e0bc23367ba6fcedbdd","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"API reference","count":47},{"language":"default","tag":"Documentation","count":27},{"language":"default","tag":"Studies","count":27},{"language":"default","tag":"AI tests","count":7},{"language":"default","tag":"Interviews","count":5},{"language":"default","tag":"Getting started","count":5},{"language":"default","tag":"Quotas","count":5},{"language":"default","tag":"Question logic","count":4},{"language":"default","tag":"Questions","count":4},{"language":"default","tag":"Randomizers","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/randomizers/create-randomizer","slug":"/api-reference/randomizers/create-randomizer","pageMetadata":{"title":"Create randomizer","api":"POST /randomizers","description":"Create a weighted split test over existing questions or groups","href":"/api-reference/randomizers/create-randomizer"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create a weighted split test over existing questions or groups\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,..._provideComponents(),...props.components},{Heading,ParamField,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Creates a randomizer from content that already exists in the study. Each arm shows one question or one existing question group; when an arm lists several `,_jsx(_components.code,{children:`question_ids`}),`, they are moved into a new group for that arm automatically. An arm may be left empty as a placeholder, but every arm needs a target before participants can be routed to it.`]}),`\n`,_jsx(ParamField,{body:`study_id`,type:`string`,required:true,id:`param-study-id`,children:`The study ID.`}),`\n`,_jsxs(ParamField,{body:`name`,type:`string`,required:true,id:`param-name`,children:[`Internal name, e.g. `,_jsx(_components.code,{children:`\"Concept test\"`}),`.`]}),`\n`,_jsx(ParamField,{body:`arms`,type:`array`,required:true,id:`param-arms`,children:_jsxs(_components.p,{children:[`2 to 12 arms. Each arm: `,_jsx(_components.code,{children:`label`}),` (string), `,_jsx(_components.code,{children:`weight_basis_points`}),` (integer, 1–10000; all arms must total exactly 10000), and one of `,_jsx(_components.code,{children:`question_ids`}),` (array of question IDs), `,_jsx(_components.code,{children:`question_id`}),` (a single question), or `,_jsx(_components.code,{children:`question_group_id`}),` (an existing group), or none of them for an empty arm.`]})}),`\n`,_jsx(ParamField,{body:`display_order`,type:`integer`,id:`param-display-order`,children:`Top-level position after the arm content is moved into the arms. Omit to append.`}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`201`}),` with the created randomizer, same shape as `,_jsx(_components.a,{href:`/api-reference/randomizers/list-randomizers`,children:`List randomizers`}),`.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`A question or group can belong to only one arm, and logic rules must never jump between arms — a participant only ever sees one.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create randomizer","api":"POST /randomizers","description":"Create a weighted split test over existing questions or groups","href":"/api-reference/randomizers/create-randomizer"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock,Heading,ParamField,RequestExample,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Creates a randomizer from content that already exists in the study. Each arm shows one question or one existing question group; when an arm lists several `,_jsx(_components.code,{children:`question_ids`}),`, they are moved into a new group for that arm automatically. An arm may be left empty as a placeholder, but every arm needs a target before participants can be routed to it.`]}),`\n`,_jsx(ParamField,{body:`study_id`,type:`string`,required:true,id:`param-study-id`,children:`The study ID.`}),`\n`,_jsxs(ParamField,{body:`name`,type:`string`,required:true,id:`param-name`,children:[`Internal name, e.g. `,_jsx(_components.code,{children:`\"Concept test\"`}),`.`]}),`\n`,_jsx(ParamField,{body:`arms`,type:`array`,required:true,id:`param-arms`,children:_jsxs(_components.p,{children:[`2 to 12 arms. Each arm: `,_jsx(_components.code,{children:`label`}),` (string), `,_jsx(_components.code,{children:`weight_basis_points`}),` (integer, 1–10000; all arms must total exactly 10000), and one of `,_jsx(_components.code,{children:`question_ids`}),` (array of question IDs), `,_jsx(_components.code,{children:`question_id`}),` (a single question), or `,_jsx(_components.code,{children:`question_group_id`}),` (an existing group), or none of them for an empty arm.`]})}),`\n`,_jsx(ParamField,{body:`display_order`,type:`integer`,id:`param-display-order`,children:`Top-level position after the arm content is moved into the arms. Omit to append.`}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`201`}),` with the created randomizer, same shape as `,_jsx(_components.a,{href:`/api-reference/randomizers/list-randomizers`,children:`List randomizers`}),`.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`A question or group can belong to only one arm, and logic rules must never jump between arms — a participant only ever sees one.`})}),`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`11`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`11`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -X POST https://api.getversive.com/api/v1/randomizers \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Authorization: Bearer $VERSIVE_API_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -d `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"study_id\": \"9b2f7c1e-4a4b-4f6e-9a1d-1c2d3e4f5a6b\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"name\": \"Concept test\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"arms\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` { \"label\": \"Concept A\", \"weight_basis_points\": 5000, \"question_ids\": [\"c1d2e3f4-0000-4000-8000-000000000001\"] },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` { \"label\": \"Concept B\", \"weight_basis_points\": 5000, \"question_group_id\": \"d4e5f6a7-0000-4000-8000-000000000002\" }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create randomizer","api":"POST /randomizers","description":"Create a weighted split test over existing questions or groups","href":"/api-reference/randomizers/create-randomizer"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Response","slug":"response","depth":3,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"11\">\u003cspan class=\"line\">\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> -X POST https://api.getversive.com/api/v1/randomizers \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> -H \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Authorization: Bearer $VERSIVE_API_KEY\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> -H \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Content-Type: application/json\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> -d \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"study_id\": \"9b2f7c1e-4a4b-4f6e-9a1d-1c2d3e4f5a6b\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"name\": \"Concept test\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"arms\": [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> { \"label\": \"Concept A\", \"weight_basis_points\": 5000, \"question_ids\": [\"c1d2e3f4-0000-4000-8000-000000000001\"] },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> { \"label\": \"Concept B\", \"weight_basis_points\": 5000, \"question_group_id\": \"d4e5f6a7-0000-4000-8000-000000000002\" }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Create randomizer","path":"/randomizers","servers":[{"url":"https://api.getversive.com/api/v1"}],"method":"post","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"study_id":[{"type":"string","description":"The study ID.","required":true}],"name":[{"type":"string","description":"Internal name, e.g. `\"Concept test\"` .","required":true}],"arms":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"2 to 12 arms. Each arm: `label` (string), `weight_basis_points` (integer, 1–10000; all arms must total exactly 10000), and one of `question_ids` (array of question IDs), `question_id` (a single question), or `question_group_id` (an existing group), or none of them for an empty arm.","required":true}],"display_order":[{"type":"integer","description":"Top-level position after the arm content is moved into the arms. Omit to append."}]}}],"examples":{"example":{"value":{"study_id":"\u003cstring>","name":"\u003cstring>","arms":[{}],"display_order":123}}}}}},"response":{},"deprecated":false}},"jsLinks":[],"subdomain":"versive","siteName":"Versive","title":"Create randomizer - Versive","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-24T14:17:05.089Z","originalFileLocation":"api-reference/randomizers/create-randomizer.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create a weighted split test over existing questions or groups\">\u003cmeta data-mint-head name=\"application-name\" content=\"Versive\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/x-icon\" sizes=\"180x180\" href=\"https://mintcdn.com/versive/-C2_T5LPeZ5Csg69/favicon.ico?fit=max\u0026amp;auto=format\u0026amp;n=-C2_T5LPeZ5Csg69\u0026amp;q=85\u0026amp;s=ec8e3723f4e24346fcea7c20b5e480ce\">\u003clink data-mint-head rel=\"icon\" type=\"image/x-icon\" sizes=\"32x32\" href=\"https://mintcdn.com/versive/-C2_T5LPeZ5Csg69/favicon.ico?fit=max\u0026amp;auto=format\u0026amp;n=-C2_T5LPeZ5Csg69\u0026amp;q=85\u0026amp;s=ec8e3723f4e24346fcea7c20b5e480ce\">\u003clink data-mint-head rel=\"icon\" type=\"image/x-icon\" sizes=\"16x16\" href=\"https://mintcdn.com/versive/-C2_T5LPeZ5Csg69/favicon.ico?fit=max\u0026amp;auto=format\u0026amp;n=-C2_T5LPeZ5Csg69\u0026amp;q=85\u0026amp;s=ec8e3723f4e24346fcea7c20b5e480ce\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintcdn.com/versive/-C2_T5LPeZ5Csg69/favicon.ico?fit=max\u0026amp;auto=format\u0026amp;n=-C2_T5LPeZ5Csg69\u0026amp;q=85\u0026amp;s=ec8e3723f4e24346fcea7c20b5e480ce\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create randomizer - Versive\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a weighted split test over existing questions or groups\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Versive\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.getversive.com/api-reference/randomizers/create-randomizer\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://versive.mintlify.site/_mintlify/api/og/v2?division=Randomizers\u0026amp;title=Create+randomizer\u0026amp;description=Create+a+weighted+split+test+over+existing+questions+or+groups\u0026amp;theme=320d8c7891ebe44ce8a03901\u0026amp;signature=c75c107b88530b8fb29692ff62b46216c17a9d5d0859fb5b3c096d06c2b1ecfc\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create randomizer - Versive\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a weighted split test over existing questions or groups\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://versive.mintlify.site/_mintlify/api/og/v2?division=Randomizers\u0026amp;title=Create+randomizer\u0026amp;description=Create+a+weighted+split+test+over+existing+questions+or+groups\u0026amp;theme=320d8c7891ebe44ce8a03901\u0026amp;signature=c75c107b88530b8fb29692ff62b46216c17a9d5d0859fb5b3c096d06c2b1ecfc\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/versive/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Versive\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#00786F\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.getversive.com/api-reference/randomizers/create-randomizer\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/randomizers/create-randomizer.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.getversive.com/#organization\",\"name\":\"Versive\",\"url\":\"https://docs.getversive.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/versive/Og7M_uVBtd7MTGJK/logo/light.svg?fit=max\u0026auto=format\u0026n=Og7M_uVBtd7MTGJK\u0026q=85\u0026s=3de4d6717f3a65645f417a61cc68828d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.getversive.com#website\",\"name\":\"Versive\",\"url\":\"https://docs.getversive.com\",\"publisher\":{\"@id\":\"https://docs.getversive.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.getversive.com/api-reference/randomizers/create-randomizer#webpage\",\"url\":\"https://docs.getversive.com/api-reference/randomizers/create-randomizer\",\"name\":\"Create randomizer\",\"description\":\"Create a weighted split test over existing questions or groups\",\"dateModified\":\"2026-09-24T14:17:05.089Z\",\"isPartOf\":{\"@id\":\"https://docs.getversive.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.getversive.com/api-reference/randomizers/create-randomizer#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.getversive.com/api-reference/randomizers/create-randomizer#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Randomizers\",\"item\":\"https://docs.getversive.com/api-reference/randomizers/list-randomizers\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create randomizer\",\"item\":\"https://docs.getversive.com/api-reference/randomizers/create-randomizer\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.getversive.com/api-reference/randomizers/create-randomizer#apireference\",\"headline\":\"Create randomizer\",\"name\":\"Create randomizer\",\"description\":\"Create a weighted split test over existing questions or groups\",\"url\":\"https://docs.getversive.com/api-reference/randomizers/create-randomizer\",\"mainEntityOfPage\":{\"@id\":\"https://docs.getversive.com/api-reference/randomizers/create-randomizer#webpage\"},\"dateModified\":\"2026-09-24T14:17:05.089Z\",\"publisher\":{\"@id\":\"https://docs.getversive.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.getversive.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Versive\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Versive\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/randomizers/create-randomizer.md","siteName":"Versive","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API reference","groups":[{"group":"Getting started","pages":[{"title":"API introduction","sidebarTitle":"Introduction","href":"/api-reference/introduction"},{"title":"Versioning and compatibility","sidebarTitle":"Versioning","href":"/api-reference/versioning"},{"title":"Webhooks","sidebarTitle":"Webhooks","href":"/api-reference/webhooks"}]},{"group":"Studies","pages":[{"title":"Create study","api":"POST /studies","href":"/api-reference/studies/create-study"},{"title":"List studies","api":"GET /studies","href":"/api-reference/studies/list-studies"},{"title":"Get study","api":"GET /studies/{id}","href":"/api-reference/studies/get-study"},{"title":"Update study","api":"PUT /studies/{id}","href":"/api-reference/studies/update-study"},{"title":"Get study metrics","api":"GET /studies/{id}/metrics","href":"/api-reference/studies/get-study-metrics"},{"title":"Review study","api":"GET /studies/{id}/review","href":"/api-reference/studies/review-study"},{"title":"Estimate study length","api":"POST /studies/length-estimate","href":"/api-reference/studies/estimate-study-length"},{"title":"Translate study","api":"POST /studies/{id}/translate","href":"/api-reference/studies/translate-study"},{"title":"List study translations","api":"GET /studies/{id}/translations","href":"/api-reference/studies/list-study-translations"},{"title":"Edit study with AI agent","api":"POST /studies/{study_id}/agent","href":"/api-reference/studies/agent-edit"},{"title":"Apply agent mutations","api":"POST /studies/{study_id}/agent/apply","href":"/api-reference/studies/agent-apply"},{"title":"AI edit questions (stateless)","api":"POST /studies/{study_id}/ai-edit","href":"/api-reference/studies/ai-edit"},{"title":"List available references","api":"GET /studies/{study_id}/available-references","href":"/api-reference/studies/available-references"}]},{"group":"Quotas","pages":[{"title":"Get study quotas","api":"GET /studies/{id}/quotas","href":"/api-reference/quotas/get-study-quotas"},{"title":"Update study quotas","api":"PUT /studies/{id}/quotas","href":"/api-reference/quotas/update-study-quotas"},{"title":"Get quota progress","api":"GET /studies/{id}/quotas/progress","href":"/api-reference/quotas/get-quota-progress"},{"title":"List question quotas","api":"GET /studies/{id}/question-quotas","href":"/api-reference/quotas/list-question-quotas"},{"title":"Update question quotas","api":"PUT /studies/{id}/questions/{question_id}/quotas","href":"/api-reference/quotas/update-question-quotas"}]},{"group":"Randomizers","pages":[{"title":"List randomizers","api":"GET /randomizers","description":"A study's randomizers (weighted split tests) with their arms","href":"/api-reference/randomizers/list-randomizers"},{"title":"Create randomizer","api":"POST /randomizers","href":"/api-reference/randomizers/create-randomizer"},{"title":"Update randomizer","api":"PUT /randomizers/{id}","description":"Replace a randomizer's name, arms, weights, and targets","href":"/api-reference/randomizers/update-randomizer"},{"title":"Remove randomizer","api":"POST /randomizers/{id}/remove","href":"/api-reference/randomizers/remove-randomizer"}]},{"group":"Questions","pages":[{"title":"List questions","api":"GET /questions","href":"/api-reference/questions/list-questions"},{"title":"Batch create/update questions","api":"POST /questions/batch","href":"/api-reference/questions/batch-questions"},{"title":"Update question","api":"PUT /questions/{question_id}","href":"/api-reference/questions/update-question"},{"title":"Delete question","api":"DELETE /questions/{question_id}","href":"/api-reference/questions/delete-question"}]},{"group":"Asset uploads","pages":[{"title":"Create asset upload","api":"POST /asset-uploads","href":"/api-reference/asset-uploads/create-asset-upload"},{"title":"Complete asset upload","api":"POST /asset-uploads/{upload_id}/complete","href":"/api-reference/asset-uploads/complete-asset-upload"}]},{"group":"Question logic","pages":[{"title":"List question logic","api":"GET /question-logic","href":"/api-reference/question-logic/list-question-logic"},{"title":"Create question logic","api":"POST /question-logic","href":"/api-reference/question-logic/create-question-logic"},{"title":"Update question logic","api":"PUT /question-logic/{logic_id}","href":"/api-reference/question-logic/update-question-logic"},{"title":"Delete question logic","api":"DELETE /question-logic/{logic_id}","href":"/api-reference/question-logic/delete-question-logic"}]},{"group":"Interviews","pages":[{"title":"Create interview","api":"POST /interviews","href":"/api-reference/interviews/create-interview"},{"title":"Get interview","api":"GET /interviews/{id}","href":"/api-reference/interviews/get-interview"},{"title":"Get interview by link token","api":"GET /interviews","href":"/api-reference/interviews/get-interview-by-vid"},{"title":"Get interview media","api":"GET /interviews/{id}/media","href":"/api-reference/interviews/get-interview-media"},{"title":"Update interview","api":"PUT /interviews/{id}","href":"/api-reference/interviews/update-interview"}]},{"group":"Insights","pages":[{"title":"Get interview insights","api":"GET /insights","href":"/api-reference/insights/get-insights"}]},{"group":"Translated questions","pages":[{"title":"List translated questions","api":"GET /translated-questions","href":"/api-reference/translated-questions/list-translated-questions"},{"title":"Get translated question","api":"GET /translated-questions/{translated_question_id}","href":"/api-reference/translated-questions/get-translated-question"},{"title":"Update translated question","api":"PUT /translated-questions/{translated_question_id}","href":"/api-reference/translated-questions/update-translated-question"}]},{"group":"Folders","pages":[{"title":"Create folder","api":"POST /folders","href":"/api-reference/folders/create-folder"},{"title":"List folders","api":"GET /folders","href":"/api-reference/folders/list-folders"},{"title":"Update folder","api":"PATCH /folders/{id}","href":"/api-reference/folders/update-folder"}]}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/overview"}]},{"tab":"SDK","pages":[{"title":"SDK","href":"/sdk/overview"}]}]},"basePath":"","title":"Create randomizer - Versive","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-BgGj2PGS.js","utils-BhNOqRKb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BAgRNUZo.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CGkb0TPw.js","snippetPresets-ChLkL1a6.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Ef10Jrbx.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DlVCnjU8.js","shallow-BA55zJxQ.js","getApiPlaygroundDisplay-DR09dKtp.js","CodeSnippet-BZ8J8Kll.js","CodeSnippets-CcguVheG.js","Page-C7x-eUfk.js","getPastedJson-D5UqeqBp.js","icon-DpD0l99C.js","MethodPill-Wg2NXsp_.js","DuplicateIcon-CCSyX8lh.js","createIcon-C4Ukv9HX.js","DynamicMarkdown-RhjEuCHC.js","SectionHeading-DL1MykRq.js","axios-vUo_bRtp.js"]}