{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Docs","colors":{"primary":"#0D9373","light":"#55D799","dark":"#0D9373"},"favicon":"https://mintcdn.com/omi/kuqgaBKwHOGhyCBK/favicon.ico?fit=max\u0026auto=format\u0026n=kuqgaBKwHOGhyCBK\u0026q=85\u0026s=218cc921327f517a91e40d837c39d5c6","navbar":{"links":[{"href":"https://help.omi.me","label":"Support"}],"primary":{"type":"button","label":"Buy Now","href":"https://www.omi.me/cart/50230946562340:1"}},"footer":{"socials":{"github":"https://github.com/BasedHardware/omi","discord":"https://discord.gg/TdRNp5U7cy","x":"https://x.com/omedotme","linkedin":"https://www.linkedin.com/company/omi-ai","instagram":"https://www.instagram.com/based_hardware"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"omi","hasAudioNarration":false,"actualSubdomain":"omi","customDomains":["docs.omi.me"],"gitSource":{"type":"github","owner":"basedhardware","repo":"omi","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae0ffa9349d8fb834e3f8b8","collectionId":"f76928cc-c507-4b78-b78a-a11c9c658d11","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae0ffa9349d8fb834e3f8b8"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae2ca089a6bd3ff6edae516","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"API Reference","count":68},{"language":"default","tag":"Documentation","count":34},{"language":"default","tag":"Core Development","count":18},{"language":"default","tag":"Conversations","count":15},{"language":"default","tag":"Getting Started","count":15},{"language":"default","tag":"Build Apps","count":13},{"language":"default","tag":"Memories","count":12},{"language":"default","tag":"Hardware","count":12},{"language":"default","tag":"Action Items","count":11},{"language":"default","tag":"Get Started","count":8}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"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":"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":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/conversations/create-conversation","slug":"/api-reference/conversations/create-conversation","pageMetadata":{"title":"Create Conversation","description":"Create a new conversation from text for the authenticated user.\n\nThis endpoint processes the provided text through the full conversation pipeline:\n- Generates structured data (title, overview, category, emoji)\n- Extracts action items (with deduplication)\n- Extracts memories (with quality filtering)\n- Determines if conversation should be discarded\n- Triggers app integrations\n- Triggers webhooks\n\n**Request Parameters:**\n- **text**: The conversation text/transcript (1-100,000 characters)\n- **text_source**: Source type - audio_transcript, message, or other_text (default: other_text)\n- **text_source_spec**: Additional source info (e.g., 'email', 'slack')\n- **started_at**: When conversation started (defaults to now)\n- **finished_at**: When conversation finished (defaults to started_at + 5 minutes)\n- **language**: Language code (default: 'en')\n- **geolocation**: Optional geolocation data\n\n**Response:**\n- Returns the created conversation ID and status\n- Use GET /v1/dev/user/conversations/{id} to retrieve full details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/dev/user/conversations","href":"/api-reference/conversations/create-conversation","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n li: \"li\",\n p: \"p\",\n strong: \"strong\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Create a new conversation from text for the authenticated user.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"This endpoint processes the provided text through the full conversation pipeline:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Generates structured data (title, overview, category, emoji)\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Extracts action items (with deduplication)\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Extracts memories (with quality filtering)\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Determines if conversation should be discarded\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Triggers app integrations\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Triggers webhooks\"\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.p, {\n children: _jsx(_components.strong, {\n children: \"Request Parameters:\"\n })\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.strong, {\n children: \"text\"\n }), \": The conversation text/transcript (1-100,000 characters)\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.strong, {\n children: \"text_source\"\n }), \": Source type - audio_transcript, message, or other_text (default: other_text)\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.strong, {\n children: \"text_source_spec\"\n }), \": Additional source info (e.g., ‘email’, ‘slack’)\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.strong, {\n children: \"started_at\"\n }), \": When conversation started (defaults to now)\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.strong, {\n children: \"finished_at\"\n }), \": When conversation finished (defaults to started_at + 5 minutes)\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.strong, {\n children: \"language\"\n }), \": Language code (default: ‘en’)\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.strong, {\n children: \"geolocation\"\n }), \": Optional geolocation data\"]\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.p, {\n children: _jsx(_components.strong, {\n children: \"Response:\"\n })\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Returns the created conversation ID and status\"\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"Use GET /v1/dev/user/conversations/\", \" to retrieve full details\"]\n }), \"\\n\"]\n })]\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 Conversation","description":"Create a new conversation from text for the authenticated user.\n\nThis endpoint processes the provided text through the full conversation pipeline:\n- Generates structured data (title, overview, category, emoji)\n- Extracts action items (with deduplication)\n- Extracts memories (with quality filtering)\n- Determines if conversation should be discarded\n- Triggers app integrations\n- Triggers webhooks\n\n**Request Parameters:**\n- **text**: The conversation text/transcript (1-100,000 characters)\n- **text_source**: Source type - audio_transcript, message, or other_text (default: other_text)\n- **text_source_spec**: Additional source info (e.g., 'email', 'slack')\n- **started_at**: When conversation started (defaults to now)\n- **finished_at**: When conversation finished (defaults to started_at + 5 minutes)\n- **language**: Language code (default: 'en')\n- **geolocation**: Optional geolocation data\n\n**Response:**\n- Returns the created conversation ID and status\n- Use GET /v1/dev/user/conversations/{id} to retrieve full details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/dev/user/conversations","href":"/api-reference/conversations/create-conversation","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Create a new conversation from text for the authenticated user.\n\nThis endpoint processes the provided text through the full conversation pipeline:\n- Generates structured data (title, overview, category, emoji)\n- Extracts action items (with deduplication)\n- Extracts memories (with quality filtering)\n- Determines if conversation should be discarded\n- Triggers app integrations\n- Triggers webhooks\n\n**Request Parameters:**\n- **text**: The conversation text/transcript (1-100,000 characters)\n- **text_source**: Source type - audio_transcript, message, or other_text (default: other_text)\n- **text_source_spec**: Additional source info (e.g., 'email', 'slack')\n- **started_at**: When conversation started (defaults to now)\n- **finished_at**: When conversation finished (defaults to started_at + 5 minutes)\n- **language**: Language code (default: 'en')\n- **geolocation**: Optional geolocation data\n\n**Response:**\n- Returns the created conversation ID and status\n- Use GET /v1/dev/user/conversations/{id} to retrieve full details","operationId":"createConversation","requestBody":"0b0392c4-911c-4829-8ac7-d8fe3d884682","responses":{"200":"c8cbb023-954a-4340-8883-4062adf35050","401":"0abf092b-c263-4cd1-b27f-34f4ab1ea2c6","403":"1aa1709b-1883-45cc-9887-1550384ef52f","422":"b39a2aa4-0c6c-4f9f-b52a-b98763ac1a6d"},"security":["280cd284-2492-416c-9d92-9e425b7d073c"],"summary":"Create Conversation","tags":["Conversations"],"method":"post","type":"path","servers":["3df1d04b-14eb-4e54-8b4d-eb4f08297b50"],"path":"/v1/dev/user/conversations","baseUrlOptions":["https://api.omi.me"],"title":"Create Conversation","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"properties":{"text":{"description":"The conversation text/transcript","maxLength":100000,"minLength":1,"title":"Text","type":"string","isRequired":true,"uniqueKey":"text","typeLabel":"string"},"finished_at":{"oneOf":[{"type":"string","title":"Finished At","description":"When the conversation finished (defaults to started_at + 5 minutes)","format":"date-time","uniqueKey":"finished_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Finished At","description":"When the conversation finished (defaults to started_at + 5 minutes)","uniqueKey":"finished_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"finished_at","typeLabel":"string\u003cdate-time> | null"},"geolocation":{"oneOf":[{"type":"object","title":"GeolocationInput","description":"Geolocation where conversation occurred","required":["latitude","longitude"],"properties":{"latitude":{"title":"Latitude","type":"number","isRequired":true,"uniqueKey":"geolocation.oneOf.0.latitude","typeLabel":"number"},"longitude":{"title":"Longitude","type":"number","isRequired":true,"uniqueKey":"geolocation.oneOf.0.longitude","typeLabel":"number"},"accuracy":{"oneOf":[{"type":"number","title":"Accuracy","minimum":0,"uniqueKey":"geolocation.oneOf.0.accuracy.oneOf.0","typeLabel":"number"},{"type":"null","title":"Accuracy","uniqueKey":"geolocation.oneOf.0.accuracy.oneOf.1","typeLabel":"null"}],"uniqueKey":"geolocation.oneOf.0.accuracy","typeLabel":"number | null"},"address":{"oneOf":[{"type":"string","title":"Address","uniqueKey":"geolocation.oneOf.0.address.oneOf.0","typeLabel":"string"},{"type":"null","title":"Address","uniqueKey":"geolocation.oneOf.0.address.oneOf.1","typeLabel":"null"}],"uniqueKey":"geolocation.oneOf.0.address","typeLabel":"string | null"},"altitude":{"oneOf":[{"type":"number","title":"Altitude","uniqueKey":"geolocation.oneOf.0.altitude.oneOf.0","typeLabel":"number"},{"type":"null","title":"Altitude","uniqueKey":"geolocation.oneOf.0.altitude.oneOf.1","typeLabel":"null"}],"uniqueKey":"geolocation.oneOf.0.altitude","typeLabel":"number | null"},"capture_source":{"oneOf":[{"type":"string","title":"Capture Source","enum":["current_position","last_known_position","manual","integration"],"uniqueKey":"geolocation.oneOf.0.capture_source.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Capture Source","uniqueKey":"geolocation.oneOf.0.capture_source.oneOf.1","typeLabel":"null"}],"uniqueKey":"geolocation.oneOf.0.capture_source","typeLabel":"enum\u003cstring> | null"},"captured_at":{"oneOf":[{"type":"string","title":"Captured At","format":"date-time","uniqueKey":"geolocation.oneOf.0.captured_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Captured At","uniqueKey":"geolocation.oneOf.0.captured_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"geolocation.oneOf.0.captured_at","typeLabel":"string\u003cdate-time> | null"},"google_place_id":{"oneOf":[{"type":"string","title":"Google Place Id","uniqueKey":"geolocation.oneOf.0.google_place_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Google Place Id","uniqueKey":"geolocation.oneOf.0.google_place_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"geolocation.oneOf.0.google_place_id","typeLabel":"string | null"},"location_type":{"oneOf":[{"type":"string","title":"Location Type","uniqueKey":"geolocation.oneOf.0.location_type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Location Type","uniqueKey":"geolocation.oneOf.0.location_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"geolocation.oneOf.0.location_type","typeLabel":"string | null"}},"uniqueKey":"geolocation.oneOf.0","typeLabel":"GeolocationInput · object"},{"type":"null","description":"Geolocation where conversation occurred","uniqueKey":"geolocation.oneOf.1","typeLabel":"null"}],"uniqueKey":"geolocation","typeLabel":"GeolocationInput · object | null"},"language":{"oneOf":[{"type":"string","title":"Language","description":"Language code (ISO 639-1, e.g., 'en', 'es', 'fr')","default":"en","uniqueKey":"language.oneOf.0","typeLabel":"string"},{"type":"null","title":"Language","description":"Language code (ISO 639-1, e.g., 'en', 'es', 'fr')","default":"en","uniqueKey":"language.oneOf.1","typeLabel":"null"}],"uniqueKey":"language","typeLabel":"string | null"},"started_at":{"oneOf":[{"type":"string","title":"Started At","description":"When the conversation started (defaults to now)","format":"date-time","uniqueKey":"started_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Started At","description":"When the conversation started (defaults to now)","uniqueKey":"started_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"started_at","typeLabel":"string\u003cdate-time> | null"},"text_source":{"enum":["audio_transcript","message","other_text"],"title":"ExternalIntegrationConversationSource","type":"string","default":"other_text","description":"Source type: audio_transcript, message, or other_text","uniqueKey":"text_source","typeLabel":"enum\u003cstring>"},"text_source_spec":{"oneOf":[{"type":"string","title":"Text Source Spec","description":"Additional source specification (e.g., 'email', 'slack', 'whatsapp')","uniqueKey":"text_source_spec.oneOf.0","typeLabel":"string"},{"type":"null","title":"Text Source Spec","description":"Additional source specification (e.g., 'email', 'slack', 'whatsapp')","uniqueKey":"text_source_spec.oneOf.1","typeLabel":"null"}],"uniqueKey":"text_source_spec","typeLabel":"string | null"}},"required":["text"],"title":"CreateConversationRequest","type":"object","uniqueKey":"","typeLabel":"CreateConversationRequest · object"},"examples":{"Example":{"title":"Example","value":{"text":"\u003cstring>","finished_at":"2023-11-07T05:31:56Z","geolocation":{"latitude":123,"longitude":123,"accuracy":1,"address":"\u003cstring>","altitude":123,"captured_at":"2023-11-07T05:31:56Z","google_place_id":"\u003cstring>","location_type":"\u003cstring>"},"language":"en","started_at":"2023-11-07T05:31:56Z","text_source":"other_text","text_source_spec":"\u003cstring>"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"c8cbb023-954a-4340-8883-4062adf35050":{"content":{"application/json":{"schema":{"properties":{"discarded":{"title":"Discarded","type":"boolean","isRequired":true,"uniqueKey":"discarded","typeLabel":"boolean"},"id":{"title":"Id","type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"status":{"title":"Status","type":"string","isRequired":true,"uniqueKey":"status","typeLabel":"string"},"meeting_treatment_eligible":{"default":false,"title":"Meeting Treatment Eligible","type":"boolean","uniqueKey":"meeting_treatment_eligible","typeLabel":"boolean"},"processing_deferred":{"default":false,"title":"Processing Deferred","type":"boolean","uniqueKey":"processing_deferred","typeLabel":"boolean"}},"required":["id","status","discarded"],"title":"ConversationCreateResponse","type":"object","uniqueKey":"","typeLabel":"ConversationCreateResponse · object"},"examples":{"Example":{"title":"Example","value":{"discarded":true,"id":"\u003cstring>","status":"\u003cstring>","meeting_treatment_eligible":false,"processing_deferred":false}}},"exampleType":"generated"}},"description":"Successful Response","exampleType":"generated"},"0abf092b-c263-4cd1-b27f-34f4ab1ea2c6":{"content":{"application/json":{"schema":{"properties":{"detail":{"oneOf":[{"type":"string","description":"Error detail returned by the API.","isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{}],"uniqueKey":"detail.oneOf.1.items.[INDEX]","typeLabel":"any"},"description":"Error detail returned by the API.","isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"any[]"},{"type":"object","description":"Error detail returned by the API.","isRequired":true,"uniqueKey":"detail.oneOf.2","typeLabel":"object"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"string | any[] | object"}},"required":["detail"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>"}}},"exampleType":"generated"}},"description":"Missing or invalid authentication credentials.","exampleType":"generated"},"1aa1709b-1883-45cc-9887-1550384ef52f":{"content":{"application/json":{"schema":{"properties":{"detail":{"oneOf":[{"type":"string","description":"Error detail returned by the API.","isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{}],"uniqueKey":"detail.oneOf.1.items.[INDEX]","typeLabel":"any"},"description":"Error detail returned by the API.","isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"any[]"},{"type":"object","description":"Error detail returned by the API.","isRequired":true,"uniqueKey":"detail.oneOf.2","typeLabel":"object"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"string | any[] | object"}},"required":["detail"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>"}}},"exampleType":"generated"}},"description":"Authenticated, but the token does not grant the required scope.","exampleType":"generated"},"b39a2aa4-0c6c-4f9f-b52a-b98763ac1a6d":{"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"},"title":"Location","type":"array","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"title":"Message","type":"string","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"title":"Error Type","type":"string","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"title":"Detail","type":"array","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"title":"HTTPValidationError","type":"object","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>"}]}}},"exampleType":"generated"}},"description":"Validation Error","exampleType":"generated"}},"security":{"280cd284-2492-416c-9d92-9e425b7d073c":{"developerApiKey":{"bearerFormat":"Omi Developer API key","description":"Send `Authorization: Bearer \u003comi_developer_api_key>`.","scheme":"bearer","type":"http","scopes":[],"schemeName":"developerApiKey"}}},"servers":{"3df1d04b-14eb-4e54-8b4d-eb4f08297b50":{"description":"Production","url":"https://api.omi.me"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"bearerFormat":"Omi Developer API key","description":"Send `Authorization: Bearer \u003comi_developer_api_key>`.","scheme":"bearer","type":"http","scopes":[],"schemeName":"developerApiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Send `Authorization: Bearer \u003comi_developer_api_key>`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"developerApiKey","name":"Authorization"}],"title":"developerApiKey"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"omi","siteName":"Docs","title":"Create Conversation - Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-23T00:12:29.050Z","originalFileLocation":"api-reference/conversations/create-conversation.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 new conversation from text for the authenticated user. This endpoint processes the provided text through the full conversation pipeline: - Generates structured data (title, overview, category, emoji) - Extracts action items (with deduplication) - Extracts memories (with quality filtering) - Determines if conversation should be discarded - Triggers app integrations - Triggers webhooks Request Parameters: - text: The conversation text/transcript (1-100,000 characters) - text_source: Source type - audio_transcript, message, or other_text (default: other_text) - text_source_spec: Additional source info (e.g., \u0026#x27;email\u0026#x27;, \u0026#x27;slack\u0026#x27;) - started_at: When conversation started (defaults to now) - finished_at: When conversation finished (defaults to started_at + 5 minutes) - language: Language code (default: \u0026#x27;en\u0026#x27;) - geolocation: Optional geolocation data Response: - Returns the created conversation ID and status - Use GET /v1/dev/user/conversations/{id} to retrieve full details\">\u003cmeta data-mint-head name=\"application-name\" content=\"Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/omi/V7sJ0-MmKz9-hzsp/_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/omi/V7sJ0-MmKz9-hzsp/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/omi/V7sJ0-MmKz9-hzsp/_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/omi/V7sJ0-MmKz9-hzsp/_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/omi/V7sJ0-MmKz9-hzsp/_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/omi/V7sJ0-MmKz9-hzsp/_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/omi/V7sJ0-MmKz9-hzsp/_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/omi/V7sJ0-MmKz9-hzsp/_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/omi/V7sJ0-MmKz9-hzsp/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Conversation - Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a new conversation from text for the authenticated user. This endpoint processes the provided text through the full conversation pipeline: - Generates structured data (title, overview, category, emoji) - Extracts action items (with deduplication) - Extracts memories (with quality filtering) - Determines if conversation should be discarded - Triggers app integrations - Triggers webhooks Request Parameters: - text: The conversation text/transcript (1-100,000 characters) - text_source: Source type - audio_transcript, message, or other_text (default: other_text) - text_source_spec: Additional source info (e.g., \u0026#x27;email\u0026#x27;, \u0026#x27;slack\u0026#x27;) - started_at: When conversation started (defaults to now) - finished_at: When conversation finished (defaults to started_at + 5 minutes) - language: Language code (default: \u0026#x27;en\u0026#x27;) - geolocation: Optional geolocation data Response: - Returns the created conversation ID and status - Use GET /v1/dev/user/conversations/{id} to retrieve full details\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.omi.me/api-reference/conversations/create-conversation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://omi.mintlify.app/_mintlify/api/og/v2?division=Conversations\u0026amp;title=Create+Conversation\u0026amp;description=Create+a+new+conversation+from+text+for+the+authenticated+user.%0A%0AThis+endpoint+processes+the+provided+text+through+the+full+conversation+pipeline%3A%0A-+Generates+s\u0026amp;theme=08f71a11b2a1fddfe6ddd773\u0026amp;signature=10e51ec91dfd0227a53b44cd78bcb748e2e80972895bd6631db93a73dc833b02\">\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 Conversation - Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a new conversation from text for the authenticated user. This endpoint processes the provided text through the full conversation pipeline: - Generates structured data (title, overview, category, emoji) - Extracts action items (with deduplication) - Extracts memories (with quality filtering) - Determines if conversation should be discarded - Triggers app integrations - Triggers webhooks Request Parameters: - text: The conversation text/transcript (1-100,000 characters) - text_source: Source type - audio_transcript, message, or other_text (default: other_text) - text_source_spec: Additional source info (e.g., \u0026#x27;email\u0026#x27;, \u0026#x27;slack\u0026#x27;) - started_at: When conversation started (defaults to now) - finished_at: When conversation finished (defaults to started_at + 5 minutes) - language: Language code (default: \u0026#x27;en\u0026#x27;) - geolocation: Optional geolocation data Response: - Returns the created conversation ID and status - Use GET /v1/dev/user/conversations/{id} to retrieve full details\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://omi.mintlify.app/_mintlify/api/og/v2?division=Conversations\u0026amp;title=Create+Conversation\u0026amp;description=Create+a+new+conversation+from+text+for+the+authenticated+user.%0A%0AThis+endpoint+processes+the+provided+text+through+the+full+conversation+pipeline%3A%0A-+Generates+s\u0026amp;theme=08f71a11b2a1fddfe6ddd773\u0026amp;signature=10e51ec91dfd0227a53b44cd78bcb748e2e80972895bd6631db93a73dc833b02\">\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/omi/V7sJ0-MmKz9-hzsp/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9373\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.omi.me/api-reference/conversations/create-conversation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/conversations/create-conversation.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.omi.me/#organization\",\"name\":\"Docs\",\"url\":\"https://docs.omi.me\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.omi.me#website\",\"name\":\"Docs\",\"url\":\"https://docs.omi.me\",\"publisher\":{\"@id\":\"https://docs.omi.me/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.omi.me/api-reference/conversations/create-conversation#webpage\",\"url\":\"https://docs.omi.me/api-reference/conversations/create-conversation\",\"name\":\"Create Conversation\",\"description\":\"Create a new conversation from text for the authenticated user. This endpoint processes the provided text through the full conversation pipeline: - Generates structured data (title, overview, category, emoji) - Extracts action items (with deduplication) - Extracts memories (with quality filtering) - Determines if conversation should be discarded - Triggers app integrations - Triggers webhooks Request Parameters: - text: The conversation text/transcript (1-100,000 characters) - text_source: Source type - audio_transcript, message, or other_text (default: other_text) - text_source_spec: Additional source info (e.g., 'email', 'slack') - started_at: When conversation started (defaults to now) - finished_at: When conversation finished (defaults to started_at + 5 minutes) - language: Language code (default: 'en') - geolocation: Optional geolocation data Response: - Returns the created conversation ID and status - Use GET /v1/dev/user/conversations/{id} to retrieve full details\",\"dateModified\":\"2026-10-23T00:12:29.050Z\",\"isPartOf\":{\"@id\":\"https://docs.omi.me#website\"},\"breadcrumb\":{\"@id\":\"https://docs.omi.me/api-reference/conversations/create-conversation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.omi.me/api-reference/conversations/create-conversation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Conversations\",\"item\":\"https://docs.omi.me/api-reference/conversations/ask-conversations\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Conversation\",\"item\":\"https://docs.omi.me/api-reference/conversations/create-conversation\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.omi.me/api-reference/conversations/create-conversation#apireference\",\"headline\":\"Create Conversation\",\"name\":\"Create Conversation\",\"description\":\"Create a new conversation from text for the authenticated user. This endpoint processes the provided text through the full conversation pipeline: - Generates structured data (title, overview, category, emoji) - Extracts action items (with deduplication) - Extracts memories (with quality filtering) - Determines if conversation should be discarded - Triggers app integrations - Triggers webhooks Request Parameters: - text: The conversation text/transcript (1-100,000 characters) - text_source: Source type - audio_transcript, message, or other_text (default: other_text) - text_source_spec: Additional source info (e.g., 'email', 'slack') - started_at: When conversation started (defaults to now) - finished_at: When conversation finished (defaults to started_at + 5 minutes) - language: Language code (default: 'en') - geolocation: Optional geolocation data Response: - Returns the created conversation ID and status - Use GET /v1/dev/user/conversations/{id} to retrieve full details\",\"url\":\"https://docs.omi.me/api-reference/conversations/create-conversation\",\"mainEntityOfPage\":{\"@id\":\"https://docs.omi.me/api-reference/conversations/create-conversation#webpage\"},\"dateModified\":\"2026-10-23T00:12:29.050Z\",\"publisher\":{\"@id\":\"https://docs.omi.me/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.omi.me#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Docs","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book","pages":[{"title":"Documentation","href":"/doc/get_started/introduction"}]},{"tab":"API Reference","icon":"square-terminal","groups":[{"group":"Overview","pages":[{"title":"API Reference","icon":"square-terminal","href":"/api-reference/introduction"},{"title":"Quick Start","icon":"square-terminal","href":"/doc/developer/api/overview"}]},{"group":"Memories","pages":[{"title":"Memories","icon":"brain","href":"/doc/developer/api/memories"},{"title":"List Memories","openapi":"GET /v1/dev/user/memories","href":"/api-reference/endpoint/memories/list"},{"title":"Create Memory","openapi":"POST /v1/dev/user/memories","href":"/api-reference/endpoint/memories/create"},{"title":"Create Memories (Batch)","openapi":"POST /v1/dev/user/memories/batch","href":"/api-reference/endpoint/memories/create-batch"},{"title":"Update Memory","openapi":"PATCH /v1/dev/user/memories/{memory_id}","href":"/api-reference/endpoint/memories/update"},{"title":"Delete Memory","openapi":"DELETE /v1/dev/user/memories/{memory_id}","href":"/api-reference/endpoint/memories/delete"}]},{"group":"Conversations","pages":[{"title":"Conversations","icon":"message","href":"/doc/developer/api/conversations"},{"title":"List Conversations","openapi":"GET /v1/dev/user/conversations","href":"/api-reference/endpoint/conversations/list"},{"title":"Create Conversation","openapi":"POST /v1/dev/user/conversations","href":"/api-reference/endpoint/conversations/create"},{"title":"Create from Transcript Segments","openapi":"POST /v1/dev/user/conversations/from-segments","href":"/api-reference/endpoint/conversations/create-from-segments"},{"title":"Get Conversation","openapi":"GET /v1/dev/user/conversations/{conversation_id}","href":"/api-reference/endpoint/conversations/get"},{"title":"Update Conversation","openapi":"PATCH /v1/dev/user/conversations/{conversation_id}","href":"/api-reference/endpoint/conversations/update"},{"title":"Delete Conversation","openapi":"DELETE /v1/dev/user/conversations/{conversation_id}","href":"/api-reference/endpoint/conversations/delete"}]},{"group":"Folders","pages":[{"title":"Folders","icon":"folder","href":"/doc/developer/api/folders"},{"title":"List Folders","openapi":"GET /v1/dev/user/folders","href":"/api-reference/endpoint/folders/list"}]},{"group":"Action Items","pages":[{"title":"Action Items","icon":"list-check","href":"/doc/developer/api/action-items"},{"title":"List Action Items","openapi":"GET /v1/dev/user/action-items","href":"/api-reference/endpoint/action-items/list"},{"title":"Create Action Item","openapi":"POST /v1/dev/user/action-items","href":"/api-reference/endpoint/action-items/create"},{"title":"Create Action Items (Batch)","openapi":"POST /v1/dev/user/action-items/batch","href":"/api-reference/endpoint/action-items/create-batch"},{"title":"Update Action Item","openapi":"PATCH /v1/dev/user/action-items/{action_item_id}","href":"/api-reference/endpoint/action-items/update"},{"title":"Delete Action Item","openapi":"DELETE /v1/dev/user/action-items/{action_item_id}","href":"/api-reference/endpoint/action-items/delete"}]},{"group":"Goals and Answers","pages":[{"title":"Goals","href":"/doc/developer/api/goals"},{"title":"Ask","href":"/doc/developer/api/ask"},{"title":"Daily Summaries","href":"/doc/developer/api/daily-summaries"}]},{"group":"Authentication","pages":[{"title":"API Keys","icon":"key","href":"/doc/developer/api/keys"},{"title":"Calling API Key","openapi":"GET /v1/dev/key","href":"/api-reference/endpoint/keys/current"},{"title":"List API Keys","openapi":"GET /v1/dev/keys","href":"/api-reference/endpoint/keys/list"},{"title":"Create API Key","openapi":"POST /v1/dev/keys","href":"/api-reference/endpoint/keys/create"},{"title":"Revoke API Key","openapi":"DELETE /v1/dev/keys/{key_id}","href":"/api-reference/endpoint/keys/revoke"}]},{"group":"API Keys","pages":[{"title":"Get calling API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/dev/key","href":"/api-reference/api-keys/get-calling-api-key"},{"title":"Get Keys","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/dev/keys","href":"/api-reference/api-keys/get-keys"},{"title":"Create Key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/dev/keys","href":"/api-reference/api-keys/create-key"},{"title":"Delete Key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/dev/keys/{key_id}","href":"/api-reference/api-keys/delete-key"}]},{"group":"Action Items","pages":[{"title":"Get Action Items","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/dev/user/action-items","href":"/api-reference/action-items/get-action-items"},{"title":"Create Action Item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/dev/user/action-items","href":"/api-reference/action-items/create-action-item"},{"title":"Create Action Items Batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/dev/user/action-items/batch","href":"/api-reference/action-items/create-action-items-batch"},{"title":"Delete Action Item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/dev/user/action-items/{action_item_id}","href":"/api-reference/action-items/delete-action-item"},{"title":"Update Action Item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/dev/user/action-items/{action_item_id}","href":"/api-reference/action-items/update-action-item"}]},{"group":"Conversations","pages":[{"title":"Ask Conversations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/dev/user/ask","href":"/api-reference/conversations/ask-conversations"},{"title":"Get Conversations","description":"Get conversations with optional transcript inclusion.\n\n- **include_transcript**: If True, includes full transcript_segments in the response\n- **folder_id**: Filter by folder ID (must be a non-empty string if provided)\n- **starred**: Filter by starred status (true/false)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/dev/user/conversations","href":"/api-reference/conversations/get-conversations"},{"title":"Create Conversation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/dev/user/conversations","href":"/api-reference/conversations/create-conversation"},{"title":"Create Conversation From Segments","description":"Create a new conversation from structured transcript segments.\n\nThis endpoint is for advanced integrations that have speaker diarization and timing information.\nIt processes the transcript segments through the full conversation pipeline.\n\n**Transcript Segments:**\n- **text**: The text spoken (required)\n- **speaker**: Speaker identifier like 'SPEAKER_00', 'SPEAKER_01' (default: 'SPEAKER_00')\n- **speaker_id**: Numeric speaker ID (auto-calculated from speaker if not provided)\n- **is_user**: Whether this segment is from the user (default: False)\n- **person_id**: ID of known person speaking (optional)\n- **start**: Start time in seconds, e.g., 0.0, 1.5, 60.2 (required)\n- **end**: End time in seconds, e.g., 1.5, 3.0, 65.8 (required)\n\n**Other Parameters:**\n- **source**: Source of conversation (default: external_integration). Options:\n - omi, friend, openglass, phone, desktop, apple_watch, bee, plaud, frame, etc.\n- **started_at**: When conversation started (defaults to now)\n- **finished_at**: When conversation finished (calculated from last segment if not provided)\n- **language**: Language code (default: 'en')\n- **geolocation**: Optional geolocation data\n- **folder_id**: Optional ID of one of your folders (from GET /v1/dev/user/folders); skips AI folder assignment\n- **calendar_meeting_context**: Optional calendar meeting (title, participants, start_time, duration_minutes,\n notes…) used as context for the summary\n\n**Example:**\n```json\n{\n \"transcript_segments\": [\n {\n \"text\": \"Hey, how are you doing?\",\n \"speaker\": \"SPEAKER_00\",\n \"is_user\": true,\n \"start\": 0.0,\n \"end\": 2.5\n },\n {\n \"text\": \"I'm doing great, thanks!\",\n \"speaker\": \"SPEAKER_01\",\n \"is_user\": false,\n \"start\": 2.8,\n \"end\": 5.2\n }\n ],\n \"source\": \"phone\",\n \"language\": \"en\"\n}\n```","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/dev/user/conversations/from-segments","href":"/api-reference/conversations/create-conversation-from-segments"},{"title":"Search Conversations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/dev/user/conversations/search","href":"/api-reference/conversations/search-conversations"},{"title":"Get Conversation Endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/dev/user/conversations/{conversation_id}","href":"/api-reference/conversations/get-conversation-endpoint"},{"title":"Delete Conversation Endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/dev/user/conversations/{conversation_id}","href":"/api-reference/conversations/delete-conversation-endpoint"},{"title":"Update Conversation Endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/dev/user/conversations/{conversation_id}","href":"/api-reference/conversations/update-conversation-endpoint"}]},{"group":"Daily Summaries","pages":[{"title":"Get Developer Daily Summaries","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/dev/user/daily-summaries","href":"/api-reference/daily-summaries/get-developer-daily-summaries"},{"title":"Get Developer Daily Summary","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/dev/user/daily-summaries/{summary_id}","href":"/api-reference/daily-summaries/get-developer-daily-summary"}]},{"group":"Folders","pages":[{"title":"Get User Folders","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/dev/user/folders","href":"/api-reference/folders/get-user-folders"}]},{"group":"Goals","pages":[{"title":"Get Goals","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/dev/user/goals","href":"/api-reference/goals/get-goals"},{"title":"Create Goal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/dev/user/goals","href":"/api-reference/goals/create-goal"},{"title":"Get Goal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/dev/user/goals/{goal_id}","href":"/api-reference/goals/get-goal"},{"title":"Delete Goal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/dev/user/goals/{goal_id}","href":"/api-reference/goals/delete-goal"},{"title":"Update Goal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/dev/user/goals/{goal_id}","href":"/api-reference/goals/update-goal"},{"title":"Get Goal History","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/dev/user/goals/{goal_id}/history","href":"/api-reference/goals/get-goal-history"},{"title":"Update Goal Progress","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/dev/user/goals/{goal_id}/progress","href":"/api-reference/goals/update-goal-progress"}]},{"group":"Memories","pages":[{"title":"Get Memories","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/dev/user/memories","href":"/api-reference/memories/get-memories"},{"title":"Create Memory","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/dev/user/memories","href":"/api-reference/memories/create-memory"},{"title":"Create Memories Batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/dev/user/memories/batch","href":"/api-reference/memories/create-memories-batch"},{"title":"Search Memories","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/dev/user/memories/search","href":"/api-reference/memories/search-memories"},{"title":"Delete Memory","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/dev/user/memories/{memory_id}","href":"/api-reference/memories/delete-memory"},{"title":"Update Memory","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/dev/user/memories/{memory_id}","href":"/api-reference/memories/update-memory"}]},{"group":"developer","pages":[{"title":"Search Memories Vector","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/dev/user/memories/vector/search","href":"/api-reference/developer/search-memories-vector"}]},{"group":"People","pages":[{"title":"Get People","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/dev/user/people","href":"/api-reference/people/get-people"}]},{"group":"Profile","pages":[{"title":"Get Profile","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/dev/user/profile","href":"/api-reference/profile/get-profile"}]},{"group":"Screen Activity","pages":[{"title":"Get Screen Activity","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/dev/user/screen-activity","href":"/api-reference/screen-activity/get-screen-activity"}]}]},{"tab":"Build Apps","icon":"puzzle-piece","pages":[{"title":"Build Apps","href":"/doc/developer/apps/Introduction"}]},{"tab":"Hardware","icon":"microchip","pages":[{"title":"Hardware","href":"/doc/hardware/OmiConsumer"}]},{"tab":"MCP","icon":"robot","pages":[{"title":"MCP","href":"/doc/developer/mcp/introduction"}]},{"tab":"CLI","icon":"terminal","pages":[{"title":"CLI","href":"/doc/developer/cli/introduction"}]}]},"title":"Create Conversation - Docs","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","Page-CBCH2P7b.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js","Markdown-Cc16CX65.js","clsx-Cs6nMGht.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-zbf22OZA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C_fs-y5n.js"]}