Cut a segment out of a user model: the simulated users whose attributes
match every filter. It joins your user models and runs like any other. A
segment needs at least 100 simulated users; when the filters match fewer,
the 400 says how many matched and nothing is created. It is shared with
your organisation, or only you without one.
Each attribute mapped to the values to keep, using exact values from /v1/user-models/{id}/attributes, e.g. {"age": ["45-54", "55-64"], "location": ["london"]}. A simulated user is in the segment when their value is one of the listed values for every attribute given.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Semilattice","colors":{"primary":"#4B4FCF","light":"#4B4FCF","dark":"#4B4FCF"},"logo":{"light":"https://mintcdn.com/semilattice/Bq2OGFClOPtUvJA7/logo/light.svg?fit=max\u0026auto=format\u0026n=Bq2OGFClOPtUvJA7\u0026q=85\u0026s=16b9d08d8fe11ee44445bcd18b9166ca","dark":"https://mintcdn.com/semilattice/Bq2OGFClOPtUvJA7/logo/dark.svg?fit=max\u0026auto=format\u0026n=Bq2OGFClOPtUvJA7\u0026q=85\u0026s=601fe8dd927c3df64dd78cb2ac8a7747"},"favicon":"https://mintcdn.com/semilattice/SZYVJM_YQEB-edCc/favicon.png?fit=max\u0026auto=format\u0026n=SZYVJM_YQEB-edCc\u0026q=85\u0026s=bdff4d38bdf7f7e2d593e25158331fb4","background":{"color":{"light":"#F7F7FA","dark":"#121213"}},"navbar":{"links":[{"href":"https://semilattice.ai/user-in-the-loop","label":"Guide"},{"href":"mailto:support@semilattice.ai","label":"Support"}],"primary":{"type":"button","label":"Open the app","href":"https://app.semilattice.ai"}},"footer":{"socials":{"website":"https://semilattice.ai","x":"https://x.com/semilatticeai","github":"https://github.com/semilattice-research","linkedin":"https://www.linkedin.com/company/semilattice"}},"icons":{"library":"lucide"},"banner":{"content":"Public Anacreon user models launch in November 2026. [What you can do until then](/user-models#public-user-models)","dismissible":true},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"semilattice","hasAudioNarration":false,"actualSubdomain":"semilattice","customDomains":["docs.semilattice.ai"],"gitSource":{"type":"github","owner":"semilattice-research","repo":"semilattice","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae004a1f8b39350bf14f55a","collectionId":"ce0909d7-d3a0-4fdf-b5a2-d0b57c2905a6","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae004a1f8b39350bf14f55a"},"entitlements":{},"buildId":"6ae0ba46b2d56c99c7a5f495","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"API Reference","count":24},{"language":"default","tag":"Endpoints","count":23},{"language":"default","tag":"Simulations","count":8},{"language":"default","tag":"Get Started","count":7},{"language":"default","tag":"Measurement \u0026 Trust","count":6},{"language":"default","tag":"Documentation","count":5},{"language":"default","tag":"Rounds","count":5},{"language":"default","tag":"MCP","count":4},{"language":"default","tag":"Context","count":4},{"language":"default","tag":"Projects","count":4}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"global.css","content":":root{--sl-accent:#4B4FCF;--sl-accent-secondary:#3B3FA8;--sl-highlight:#F45AA8;--sl-signal:#00B7B3;--sl-fg:#1A1A1E;--sl-fg-dim:#7B7B86;--sl-bg:#F7F7FA;--sl-muted:#ECECF2;--sl-border:#DADAE3;--sl-dark-bg:#121213;--sl-dark-fg:#E6E6EA}.body-content h1{letter-spacing:-.03em;line-height:1.15}.body-content h2{letter-spacing:-.02em;line-height:1.25;margin-top:2.5rem}.body-content h3{letter-spacing:-.015em}.body-content p{line-height:1.75}.body-content [class*=Update]{margin-bottom:3rem;padding-bottom:3rem}.art-cabinet{margin-top:6rem;padding-top:4rem;border-top:1px solid var(--sl-border)}.art-cabinet-header{text-align:center;margin-bottom:3rem}.art-cabinet-header h2{font-size:.75rem;text-transform:uppercase;letter-spacing:.15em;color:var(--sl-fg-dim);font-weight:500;margin:0}.art-cabinet-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(280px,1fr));gap:1.5rem;max-width:720px;margin:0 auto}.art-piece{position:relative;aspect-ratio:4/3;border-radius:12px;overflow:hidden;cursor:pointer;background:var(--sl-muted);border:1px solid var(--sl-border);transition:border-color .3s ease,box-shadow .3s ease}.art-piece:hover{border-color:var(--sl-accent);box-shadow:0 4px 24px rgba(75,79,207,.08)}.art-piece canvas{width:100%;height:100%;display:block}.art-piece-label{position:absolute;bottom:0;left:0;right:0;padding:12px 16px;background:linear-gradient(transparent,rgba(26,26,30,.7));color:#fff;font-size:.7rem;letter-spacing:.08em;text-transform:uppercase;font-weight:500;opacity:0;transition:opacity .3s ease}.art-piece:hover .art-piece-label,.art-piece:hover .art-piece-play{opacity:1}.art-piece-play{position:absolute;top:50%;left:50%;transform:translate(-50%,-50%);width:48px;height:48px;border-radius:50%;background:rgba(255,255,255,.9);border:0;cursor:pointer;display:flex;align-items:center;justify-content:center;opacity:0;transition:opacity .3s ease,transform .3s ease;box-shadow:0 2px 12px rgba(0,0,0,.1)}.art-piece-play:hover{transform:translate(-50%,-50%) scale(1.1)}.art-piece-play svg{width:18px;height:18px;fill:var(--sl-accent);margin-left:2px}.art-piece.playing .art-piece-play{opacity:0}.art-piece.playing .art-piece-label{opacity:1}"}],"page":{"pagePath":"api-reference/user-models/create-a-segment","slug":"/api-reference/user-models/create-a-segment","pageMetadata":{"title":"Create a segment","description":"Cut a segment out of a user model: the simulated users whose attributes\nmatch every filter. It joins your user models and runs like any other. A\nsegment needs at least 100 simulated users; when the filters match fewer,\nthe 400 says how many matched and nothing is created. It is shared with\nyour organisation, or only you without one.","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json post /v1/user-models/{user_model_id}/segments","href":"/api-reference/user-models/create-a-segment","autogeneratedByOpenApi":true},"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: \"Cut a segment out of a user model: the simulated users whose attributes\\nmatch every filter. It joins your user models and runs like any other. A\\nsegment needs at least 100 simulated users; when the filters match fewer,\\nthe 400 says how many matched and nothing is created. It is shared with\\nyour organisation, or only you without one.\"\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a segment","description":"Cut a segment out of a user model: the simulated users whose attributes\nmatch every filter. It joins your user models and runs like any other. A\nsegment needs at least 100 simulated users; when the filters match fewer,\nthe 400 says how many matched and nothing is created. It is shared with\nyour organisation, or only you without one.","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json post /v1/user-models/{user_model_id}/segments","href":"/api-reference/user-models/create-a-segment","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["User Models"],"summary":"Create a segment","description":"Cut a segment out of a user model: the simulated users whose attributes\nmatch every filter. It joins your user models and runs like any other. A\nsegment needs at least 100 simulated users; when the filters match fewer,\nthe 400 says how many matched and nothing is created. It is shared with\nyour organisation, or only you without one.","operationId":"create_segment_route_v1_user_models__user_model_id__segments_post","parameters":["d2e76873-3a50-4287-8687-6b1866779c30","ea43b685-b5ec-48bc-b161-3ca77dff3f85"],"requestBody":"c858d3a7-eb9f-4733-95f8-59489fcbacec","responses":{"201":"7f6c0c0f-3e82-4cd5-b314-713e0ab28d56","422":"aab9df03-2d70-42bb-8d74-dcd3c523355c"},"method":"post","type":"path","servers":["0d692ee6-151f-46bf-ae0f-7de1f65c6a62"],"security":["3b8fd187-d78d-4155-bead-4dd6dd83d03c"],"path":"/v1/user-models/{user_model_id}/segments","baseUrlOptions":["https://api.semilattice.ai"],"title":"Create a segment","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"d2e76873-3a50-4287-8687-6b1866779c30":{"name":"user_model_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"User Model Id","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}},"ea43b685-b5ec-48bc-b161-3ca77dff3f85":{"name":"authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization","isRequired":false,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name","description":"A short name, e.g. 'Londoners 45-64'","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"filters":{"additionalProperties":{"items":{"type":"string","uniqueKey":"filters.additionalProperties.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"filters.additionalProperties","typeLabel":"string[]"},"type":"object","title":"Filters","description":"Each attribute mapped to the values to keep, using exact values from /v1/user-models/{id}/attributes, e.g. {\"age\": [\"45-54\", \"55-64\"], \"location\": [\"london\"]}. A simulated user is in the segment when their value is one of the listed values for every attribute given.","isRequired":true,"uniqueKey":"filters","typeLabel":"Filters · object"},"description":{"type":"string","maxLength":2000,"title":"Description","default":"","uniqueKey":"description","typeLabel":"string"}},"type":"object","required":["name","filters"],"title":"CreateSegmentBody","uniqueKey":"","typeLabel":"CreateSegmentBody · object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>","filters":{},"description":""}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"7f6c0c0f-3e82-4cd5-b314-713e0ab28d56":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"exampleType":"generated"},"aab9df03-2d70-42bb-8d74-dcd3c523355c":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"3b8fd187-d78d-4155-bead-4dd6dd83d03c":{"BearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"0d692ee6-151f-46bf-ae0f-7de1f65c6a62":{"url":"https://api.semilattice.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"https://api.semilattice.ai/openapi.json"},"subdomain":"semilattice","siteName":"Semilattice","title":"Create a segment - Semilattice","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T14:51:20.812Z","originalFileLocation":"api-reference/user-models/create-a-segment.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=\"Cut a segment out of a user model: the simulated users whose attributes match every filter. It joins your user models and runs like any other. A segment needs at least 100 simulated users; when the filters match fewer, the 400 says how many matched and nothing is created. It is shared with your organisation, or only you without one.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Semilattice\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/semilattice/r0JBpKcdeZoKYb0T/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/semilattice/r0JBpKcdeZoKYb0T/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/semilattice/r0JBpKcdeZoKYb0T/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/semilattice/r0JBpKcdeZoKYb0T/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/semilattice/r0JBpKcdeZoKYb0T/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/semilattice/r0JBpKcdeZoKYb0T/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/semilattice/r0JBpKcdeZoKYb0T/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/semilattice/r0JBpKcdeZoKYb0T/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/semilattice/r0JBpKcdeZoKYb0T/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a segment - Semilattice\">\u003cmeta data-mint-head property=\"og:description\" content=\"Cut a segment out of a user model: the simulated users whose attributes match every filter. It joins your user models and runs like any other. A segment needs at least 100 simulated users; when the filters match fewer, the 400 says how many matched and nothing is created. It is shared with your organisation, or only you without one.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Semilattice\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.semilattice.ai/api-reference/user-models/create-a-segment\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://semilattice.mintlify.app/_mintlify/api/og/v2?division=User+Models\u0026amp;title=Create+a+segment\u0026amp;description=Cut+a+segment+out+of+a+user+model%3A+the+simulated+users+whose+attributes%0Amatch+every+filter.+It+joins+your+user+models+and+runs+like+any+other.+A%0Asegment+needs+a\u0026amp;theme=16269cd9edbbf4ce42d662fe\u0026amp;signature=8c8cc9d7c7be26401c6b89feaa2d399e31001a59b426a77e00db47305c9acf46\">\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 a segment - Semilattice\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Cut a segment out of a user model: the simulated users whose attributes match every filter. It joins your user models and runs like any other. A segment needs at least 100 simulated users; when the filters match fewer, the 400 says how many matched and nothing is created. It is shared with your organisation, or only you without one.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://semilattice.mintlify.app/_mintlify/api/og/v2?division=User+Models\u0026amp;title=Create+a+segment\u0026amp;description=Cut+a+segment+out+of+a+user+model%3A+the+simulated+users+whose+attributes%0Amatch+every+filter.+It+joins+your+user+models+and+runs+like+any+other.+A%0Asegment+needs+a\u0026amp;theme=16269cd9edbbf4ce42d662fe\u0026amp;signature=8c8cc9d7c7be26401c6b89feaa2d399e31001a59b426a77e00db47305c9acf46\">\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=\"/mintlify-assets/_mintlify/favicons/semilattice/r0JBpKcdeZoKYb0T/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Semilattice\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4B4FCF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.semilattice.ai/api-reference/user-models/create-a-segment\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/user-models/create-a-segment.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.semilattice.ai/#organization\",\"name\":\"Semilattice\",\"url\":\"https://docs.semilattice.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/semilattice/Bq2OGFClOPtUvJA7/logo/light.svg?fit=max\u0026auto=format\u0026n=Bq2OGFClOPtUvJA7\u0026q=85\u0026s=16b9d08d8fe11ee44445bcd18b9166ca\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.semilattice.ai#website\",\"name\":\"Semilattice\",\"url\":\"https://docs.semilattice.ai\",\"publisher\":{\"@id\":\"https://docs.semilattice.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.semilattice.ai/api-reference/user-models/create-a-segment#webpage\",\"url\":\"https://docs.semilattice.ai/api-reference/user-models/create-a-segment\",\"name\":\"Create a segment\",\"description\":\"Cut a segment out of a user model: the simulated users whose attributes match every filter. It joins your user models and runs like any other. A segment needs at least 100 simulated users; when the filters match fewer, the 400 says how many matched and nothing is created. It is shared with your organisation, or only you without one.\",\"dateModified\":\"2026-10-27T14:51:20.812Z\",\"isPartOf\":{\"@id\":\"https://docs.semilattice.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.semilattice.ai/api-reference/user-models/create-a-segment#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.semilattice.ai/api-reference/user-models/create-a-segment#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.semilattice.ai/api-reference/user-models/list-user-models\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"User Models\",\"item\":\"https://docs.semilattice.ai/api-reference/user-models/list-user-models\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create a segment\",\"item\":\"https://docs.semilattice.ai/api-reference/user-models/create-a-segment\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.semilattice.ai/api-reference/user-models/create-a-segment#apireference\",\"headline\":\"Create a segment\",\"name\":\"Create a segment\",\"description\":\"Cut a segment out of a user model: the simulated users whose attributes match every filter. It joins your user models and runs like any other. A segment needs at least 100 simulated users; when the filters match fewer, the 400 says how many matched and nothing is created. It is shared with your organisation, or only you without one.\",\"url\":\"https://docs.semilattice.ai/api-reference/user-models/create-a-segment\",\"mainEntityOfPage\":{\"@id\":\"https://docs.semilattice.ai/api-reference/user-models/create-a-segment#webpage\"},\"dateModified\":\"2026-10-27T14:51:20.812Z\",\"publisher\":{\"@id\":\"https://docs.semilattice.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.semilattice.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Semilattice\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Semilattice","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/introduction"}]},{"tab":"API Reference","groups":[{"group":"Get Started","icon":"rocket","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Endpoints","pages":[{"group":"User Models","pages":[{"title":"List user models","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json get /v1/user-models","href":"/api-reference/user-models/list-user-models"},{"title":"List a user model's attributes","description":"List the attributes a user model's simulated users carry (age, location,\nincome...) with every stored value and how many simulated users hold it.\nValues are fixed tokens such as `east_midlands`, so read them here before\ncreating a segment. Only user models built with Anacreon can be segmented,\nand a segment can't be segmented again.","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json get /v1/user-models/{user_model_id}/attributes","href":"/api-reference/user-models/list-a-user-models-attributes"},{"title":"Create a segment","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json post /v1/user-models/{user_model_id}/segments","href":"/api-reference/user-models/create-a-segment"},{"title":"Edit a segment","description":"Change a segment you created: its name, description or filters. Leave\nout what stays the same. New filters replace the old ones whole and still\nneed at least 100 simulated users. Once a simulation has used the segment\nits filters are locked, so that simulation's results still describe the\nsame people; you can still rename it.","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json patch /v1/user-models/{segment_id}","href":"/api-reference/user-models/edit-a-segment"}]},{"group":"Simulation Schema","pages":[{"title":"Discover goals and inputs","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json get /v1/simulation-schema","href":"/api-reference/simulation-schema/discover-goals-and-inputs"}]},{"group":"Simulations","pages":[{"title":"List simulations","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json get /v1/simulations","href":"/api-reference/simulations/list-simulations"},{"title":"Create a simulation","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json post /v1/simulations","href":"/api-reference/simulations/create-a-simulation"},{"title":"Get a simulation","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json get /v1/simulations/{simulation_id}","href":"/api-reference/simulations/get-a-simulation"},{"title":"Delete a simulation","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json delete /v1/simulations/{simulation_id}","href":"/api-reference/simulations/delete-a-simulation"},{"title":"Move a simulation into a project","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json patch /v1/simulations/{simulation_id}","href":"/api-reference/simulations/move-a-simulation-into-a-project"},{"title":"Edit the plan","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json patch /v1/simulations/{simulation_id}/plan","href":"/api-reference/simulations/edit-the-plan"},{"title":"Run a simulation","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json post /v1/simulations/{simulation_id}/run","href":"/api-reference/simulations/run-a-simulation"},{"title":"Make a simulation public","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json post /v1/simulations/{simulation_id}/share","href":"/api-reference/simulations/make-a-simulation-public"}]},{"group":"Projects","pages":[{"title":"List projects","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json get /v1/projects","href":"/api-reference/projects/list-projects"},{"title":"Create a project","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json post /v1/projects","href":"/api-reference/projects/create-a-project"},{"title":"Get a project","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json get /v1/projects/{project_id}","href":"/api-reference/projects/get-a-project"},{"title":"Rename a project","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json patch /v1/projects/{project_id}","href":"/api-reference/projects/rename-a-project"}]},{"group":"Rounds","pages":[{"title":"Start a round","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json post /v1/projects/{project_id}/rounds","href":"/api-reference/rounds/start-a-round"},{"title":"Rename a round","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json patch /v1/projects/{project_id}/rounds/{round_id}","href":"/api-reference/rounds/rename-a-round"},{"title":"Attach a round's artefact","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json post /v1/projects/{project_id}/rounds/{round_id}/artefact","href":"/api-reference/rounds/attach-a-rounds-artefact"},{"title":"Upload a round's artefact","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json post /v1/projects/{project_id}/rounds/{round_id}/artefact/file","href":"/api-reference/rounds/upload-a-rounds-artefact"},{"title":"Regenerate a round's synthesis","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json post /v1/projects/{project_id}/rounds/{round_id}/synthesis","href":"/api-reference/rounds/regenerate-a-rounds-synthesis"}]},{"group":"Context","pages":[{"title":"Get your default context","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json get /v1/context","href":"/api-reference/context/get-your-default-context"},{"title":"List contexts","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json get /v1/contexts","href":"/api-reference/context/list-contexts"},{"title":"Create a context","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json post /v1/contexts","href":"/api-reference/context/create-a-context"},{"title":"Get a context","deprecated":null,"version":null,"openapi":"https://api.semilattice.ai/openapi.json get /v1/contexts/{context_id}","href":"/api-reference/context/get-a-context"}]}]}]},{"tab":"Measurement \u0026 Trust","pages":[{"title":"Measurement \u0026 Trust","href":"/measurement"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"title":"Create a segment - Semilattice","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-BVNUlwBc.js","dist-aeztFa9U.js","lib--scc4DXi.js","lib-B8HbPgcC.js","clsx-rL8ZCCw4.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-rfhihCWU.js","utils-BmH1XFxk.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BcNsxPKB.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BAES3tkd.js","snippetPresets-DCMQBKLP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D6l_bzE9.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BOktbnNh.js","shallow-BCs8SgM7.js","getApiPlaygroundDisplay-DEmW5bJB.js","CodeSnippet-CpZOpB9C.js","CodeSnippets-BOBDqibl.js","Page-D5fEM6aW.js","getPastedJson-DH2JBvmr.js","icon-BBJH-kKh.js","MethodPill-D2Sd5NLC.js","DuplicateIcon-CGgfL2qN.js","createIcon-BKudBBzi.js","DynamicMarkdown-85clUA0i.js","SectionHeading-D0JiMgDx.js","axios-vUo_bRtp.js","Markdown-Cfiy0xZO.js","AssistantPageLink-BywkCr5C.js"]}