{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Aster Agents","colors":{"primary":"#0A3D2C","light":"#00DB65","dark":"#0A3D2C"},"logo":{"light":"https://mintcdn.com/asteragents/0Z3Pq736HygxwpDP/logo/light.svg?fit=max\u0026auto=format\u0026n=0Z3Pq736HygxwpDP\u0026q=85\u0026s=43ff25abf648e8e3684687fb287df4a7","dark":"https://mintcdn.com/asteragents/0Z3Pq736HygxwpDP/logo/dark.svg?fit=max\u0026auto=format\u0026n=0Z3Pq736HygxwpDP\u0026q=85\u0026s=3c8b99698119572eb40d6bffd7f3107c"},"favicon":"https://mintcdn.com/asteragents/0Z3Pq736HygxwpDP/favicon.png?fit=max\u0026auto=format\u0026n=0Z3Pq736HygxwpDP\u0026q=85\u0026s=719525076d6a63947582e582f81aea9c","api":{"openapi":["openapi.yaml"],"mdx":{"auth":{"method":"bearer"},"server":"https://www.asteragents.com/api"}},"background":{"decoration":"grid"},"navbar":{"links":[{"href":"mailto:patrick@asteragents.com","label":"Support"}],"primary":{"type":"button","label":"Control Hub","href":"https://www.asteragents.com/control-hub"}},"footer":{"socials":{"x":"https://x.com/aster__ave"}},"fonts":{"heading":{"family":"Cormorant Garamond","weight":500},"body":{"family":"Geist"}},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Aster Agents Dashboard","icon":"gauge","href":"https://www.asteragents.com/dashboard"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"asteragents","hasAudioNarration":false,"actualSubdomain":"asteragents","customDomains":["docs.asteragents.com"],"gitSource":{"type":"github","owner":"asterlabs-ai","repo":"asteragents","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aeaa9e3aa33bd93eb132be0","collectionId":"dd83f0ed-8523-404e-b97c-06455ca24442","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aeaa9e3aa33bd93eb132be0"},"entitlements":{},"buildId":"6aeb463852472789d84da577","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"Documentation","count":117},{"language":"default","tag":"Integrations","count":60},{"language":"default","tag":"API Reference","count":48},{"language":"default","tag":"Built-in Tools","count":28},{"language":"default","tag":"Operations \u0026 Commerce","count":13},{"language":"default","tag":"Organization Settings","count":11},{"language":"default","tag":"Web \u0026 Research","count":9},{"language":"default","tag":"Build Agents","count":8},{"language":"default","tag":"Investing \u0026 Research","count":8},{"language":"default","tag":"CRM \u0026 Sales","count":8}]},"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":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","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":"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":"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":"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":"full-page-search","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":"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":"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":"turbopuffer-dual-write","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},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/conversations/get-a-conversation-with-messages","slug":"/api-reference/conversations/get-a-conversation-with-messages","pageMetadata":{"title":"Get a conversation with messages","description":"Retrieve a conversation and all its messages by thread ID.\n\nThe conversation must belong to the authenticated user's organization.\n\n**Stream status values:**\n- `in_progress`: Response is currently being generated\n- `completed`: Response generation finished successfully\n- `stopped`: Response generation was manually stopped\n- `error`: Response generation encountered an error\n- `timeout`: Response generation timed out\n- `null`: No active stream\n","deprecated":null,"version":null,"openapi":"/openapi.yaml get /getConversation","href":"/api-reference/conversations/get-a-conversation-with-messages","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 code: \"code\",\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: \"Retrieve a conversation and all its messages by thread ID.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"The conversation must belong to the authenticated user’s organization.\"\n }), \"\\n\", _jsx(_components.p, {\n children: _jsx(_components.strong, {\n children: \"Stream status values:\"\n })\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"in_progress\"\n }), \": Response is currently being generated\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"completed\"\n }), \": Response generation finished successfully\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"stopped\"\n }), \": Response generation was manually stopped\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"error\"\n }), \": Response generation encountered an error\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"timeout\"\n }), \": Response generation timed out\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"null\"\n }), \": No active stream\"]\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":"Get a conversation with messages","description":"Retrieve a conversation and all its messages by thread ID.\n\nThe conversation must belong to the authenticated user's organization.\n\n**Stream status values:**\n- `in_progress`: Response is currently being generated\n- `completed`: Response generation finished successfully\n- `stopped`: Response generation was manually stopped\n- `error`: Response generation encountered an error\n- `timeout`: Response generation timed out\n- `null`: No active stream\n","deprecated":null,"version":null,"openapi":"/openapi.yaml get /getConversation","href":"/api-reference/conversations/get-a-conversation-with-messages","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Conversations"],"summary":"Get a conversation with messages","description":"Retrieve a conversation and all its messages by thread ID.\n\nThe conversation must belong to the authenticated user's organization.\n\n**Stream status values:**\n- `in_progress`: Response is currently being generated\n- `completed`: Response generation finished successfully\n- `stopped`: Response generation was manually stopped\n- `error`: Response generation encountered an error\n- `timeout`: Response generation timed out\n- `null`: No active stream\n","operationId":"getConversation","parameters":["2340f356-63ea-41e8-ad14-0ff31f1336e1"],"responses":{"200":"39aede4d-72d5-44f4-903c-ca49a665b373","400":"83ed53a0-04f2-459f-859c-c52e8e31b16d","404":"4aa9d7b6-bc3c-45b7-b22c-03989d9d1c16","405":"93198869-1c30-4905-bc0f-30a22ee624fe","500":"78c864ba-cd5f-404e-971a-4229b6e7c9c2"},"method":"get","type":"path","servers":["7b3613e1-cd10-434b-ad64-41c0fe7648cd","376a91ce-ce5e-4356-8e0a-4d472d86128f"],"security":["4e7db532-e431-44ba-96b0-259ce17bf485"],"path":"/getConversation","baseUrlOptions":["https://www.asteragents.com/api","http://localhost:3000/api"],"title":"Get a conversation with messages","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"2340f356-63ea-41e8-ad14-0ff31f1336e1":{"name":"threadId","in":"query","required":true,"description":"The UUID of the conversation thread","schema":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000","isRequired":true,"description":"The UUID of the conversation thread","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"39aede4d-72d5-44f4-903c-ca49a665b373":{"description":"Successfully retrieved conversation","content":{"application/json":{"schema":{"type":"object","required":["id","agentId","userId","createdAt","updatedAt","messages"],"properties":{"id":{"type":"string","format":"uuid","description":"Unique conversation identifier","example":"550e8400-e29b-41d4-a716-446655440000","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"agentId":{"type":"integer","description":"ID of the agent this conversation is with","example":123,"isRequired":true,"uniqueKey":"agentId","typeLabel":"integer"},"userId":{"type":"string","description":"Clerk user ID of the conversation owner","example":"user_2ABC123DEF","isRequired":true,"uniqueKey":"userId","typeLabel":"string"},"createdAt":{"type":"string","format":"date-time","description":"When the conversation was created","example":"2024-01-15T10:30:00.000Z","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","description":"When the conversation was last updated","example":"2024-01-15T10:35:00.000Z","isRequired":true,"uniqueKey":"updatedAt","typeLabel":"string\u003cdate-time>"},"messages":{"type":"array","description":"All messages in the conversation, ordered by creation time","items":{"type":"object","required":["id","role","parts"],"properties":{"id":{"type":"string","format":"uuid","description":"Unique message identifier","example":"660e8400-e29b-41d4-a716-446655440001","isRequired":true,"uniqueKey":"messages.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"role":{"type":"string","description":"Message role","enum":["user","assistant","system"],"example":"user","isRequired":true,"uniqueKey":"messages.items.[INDEX].role","typeLabel":"enum\u003cstring>"},"parts":{"type":"array","description":"Message content parts (text, tool calls, step markers, files).","items":{"type":"object","description":"A single part of a message. The `type` field discriminates the shape.\nTool calls use the AI SDK v5 format: the type is `tool-\u003ctoolName>`\n(e.g. `tool-search_knowledge_base`) — NOT a static `tool-invocation`/\n`tool-result`. The same part carries both the call `input` and, once the\ntool returns, the `output` (with `state` advancing to `output-available`).\n","required":["type"],"properties":{"type":{"type":"string","description":"Part type. One of `text`, `step-start`, `file`, or a dynamic\n`tool-\u003ctoolName>` value for tool calls.\n","example":"tool-search_knowledge_base","isRequired":true,"uniqueKey":"messages.items.[INDEX].parts.items.[INDEX].type","typeLabel":"string"},"text":{"type":"string","description":"Text content (for `text` parts). May contain citation markdown links `[label](cite:\u003cfileId>)` that resolve to a KB file id found in a tool part's `output`.","example":"Q3 revenue was $4,812,003. [Fact Sheet](cite:38437)","uniqueKey":"messages.items.[INDEX].parts.items.[INDEX].text","typeLabel":"string"},"toolCallId":{"type":"string","description":"Tool call id (for `tool-\u003ctoolName>` parts).","example":"call_aquVL0uiP6lBqaofHke9Gaa5","uniqueKey":"messages.items.[INDEX].parts.items.[INDEX].toolCallId","typeLabel":"string"},"state":{"type":"string","description":"Tool call lifecycle state (for `tool-\u003ctoolName>` parts).","example":"output-available","uniqueKey":"messages.items.[INDEX].parts.items.[INDEX].state","typeLabel":"string"},"input":{"type":"object","description":"The arguments the model passed to the tool (for `tool-\u003ctoolName>` parts).","uniqueKey":"messages.items.[INDEX].parts.items.[INDEX].input","typeLabel":"object"},"output":{"type":"object","description":"The tool's return value (for `tool-\u003ctoolName>` parts), typically `{ status, content }`.","uniqueKey":"messages.items.[INDEX].parts.items.[INDEX].output","typeLabel":"object"},"file":{"type":"object","description":"File attachment details (for `file` parts).","properties":{"name":{"type":"string","uniqueKey":"messages.items.[INDEX].parts.items.[INDEX].file.name","typeLabel":"string"},"contentType":{"type":"string","uniqueKey":"messages.items.[INDEX].parts.items.[INDEX].file.contentType","typeLabel":"string"},"url":{"type":"string","uniqueKey":"messages.items.[INDEX].parts.items.[INDEX].file.url","typeLabel":"string"}},"uniqueKey":"messages.items.[INDEX].parts.items.[INDEX].file","typeLabel":"object"}},"uniqueKey":"messages.items.[INDEX].parts.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"messages.items.[INDEX].parts","typeLabel":"object[]"},"usage":{"type":"object","description":"Per-message token usage (assistant messages only).","properties":{"inputTokens":{"type":"integer","uniqueKey":"messages.items.[INDEX].usage.inputTokens","typeLabel":"integer"},"outputTokens":{"type":"integer","uniqueKey":"messages.items.[INDEX].usage.outputTokens","typeLabel":"integer"},"totalTokens":{"type":"integer","uniqueKey":"messages.items.[INDEX].usage.totalTokens","typeLabel":"integer"},"cachedInputTokens":{"type":"integer","uniqueKey":"messages.items.[INDEX].usage.cachedInputTokens","typeLabel":"integer"},"reasoningTokens":{"type":"integer","uniqueKey":"messages.items.[INDEX].usage.reasoningTokens","typeLabel":"integer"}},"uniqueKey":"messages.items.[INDEX].usage","typeLabel":"object"},"finishReason":{"type":"string","description":"Why generation stopped (assistant messages only), e.g. \"stop\", \"tool-calls\", \"length\".","example":"stop","uniqueKey":"messages.items.[INDEX].finishReason","typeLabel":"string"}},"uniqueKey":"messages.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"messages","typeLabel":"object[]"},"organizationId":{"oneOf":[{"type":"string","description":"Organization the conversation belongs to","example":"org_xxx","uniqueKey":"organizationId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Organization the conversation belongs to","example":"org_xxx","uniqueKey":"organizationId.oneOf.1","typeLabel":"null"}],"uniqueKey":"organizationId","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","description":"Conversation name/title (auto-generated or user-defined)","example":"Help with quarterly report","uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Conversation name/title (auto-generated or user-defined)","example":"Help with quarterly report","uniqueKey":"name.oneOf.1","typeLabel":"null"}],"uniqueKey":"name","typeLabel":"string | null"},"upstreamConversationId":{"oneOf":[{"type":"string","format":"uuid","description":"Parent conversation ID for branched conversations","example":null,"uniqueKey":"upstreamConversationId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Parent conversation ID for branched conversations","example":null,"uniqueKey":"upstreamConversationId.oneOf.1","typeLabel":"null"}],"uniqueKey":"upstreamConversationId","typeLabel":"string\u003cuuid> | null"},"renderedSystemPrompt":{"oneOf":[{"type":"string","description":"The system prompt used for this conversation (for audit)","example":"You are a helpful assistant...","uniqueKey":"renderedSystemPrompt.oneOf.0","typeLabel":"string"},{"type":"null","description":"The system prompt used for this conversation (for audit)","example":"You are a helpful assistant...","uniqueKey":"renderedSystemPrompt.oneOf.1","typeLabel":"null"}],"uniqueKey":"renderedSystemPrompt","typeLabel":"string | null"},"streamStatus":{"oneOf":[{"type":"string","description":"Current streaming status","enum":["in_progress","completed","stopped","error","timeout"],"example":"completed","uniqueKey":"streamStatus.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Current streaming status","enum":["in_progress","completed","stopped","error","timeout"],"example":"completed","uniqueKey":"streamStatus.oneOf.1","typeLabel":"null"}],"uniqueKey":"streamStatus","typeLabel":"enum\u003cstring> | null"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time","description":"When the conversation was soft-deleted (null if active)","example":null,"uniqueKey":"deletedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When the conversation was soft-deleted (null if active)","example":null,"uniqueKey":"deletedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"deletedAt","typeLabel":"string\u003cdate-time> | null"},"isDeleted":{"type":"boolean","description":"Present and true if conversation was soft-deleted","example":false,"uniqueKey":"isDeleted","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"active":{"title":"active","value":{"id":"550e8400-e29b-41d4-a716-446655440000","agentId":123,"userId":"user_2ABC123DEF","organizationId":"org_xxx","name":"Help with quarterly report","upstreamConversationId":null,"renderedSystemPrompt":"You are a helpful assistant...","streamStatus":"completed","createdAt":"2024-01-15T10:30:00.000Z","updatedAt":"2024-01-15T10:35:00.000Z","deletedAt":null,"messages":[{"id":"660e8400-e29b-41d4-a716-446655440001","role":"user","parts":[{"type":"text","text":"Can you help me analyze this data?"}]},{"id":"660e8400-e29b-41d4-a716-446655440002","role":"assistant","parts":[{"type":"text","text":"Of course! I'd be happy to help you analyze the data."}]}]}},"deleted":{"title":"deleted","value":{"id":"550e8400-e29b-41d4-a716-446655440000","agentId":123,"userId":"user_2ABC123DEF","organizationId":"org_xxx","name":"Old conversation","isDeleted":true,"deletedAt":"2024-01-20T15:00:00.000Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"83ed53a0-04f2-459f-859c-c52e8e31b16d":{"description":"Bad request - missing threadId","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","example":"Bad Request","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","additionalProperties":true,"uniqueKey":"details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"threadId is required"},"examples":{"Example":{"title":"Example","value":{"error":"threadId is required"}}},"exampleType":"examples"}},"exampleType":"examples"},"4aa9d7b6-bc3c-45b7-b22c-03989d9d1c16":{"description":"Conversation not found or doesn't belong to your organization","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","example":"Bad Request","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","additionalProperties":true,"uniqueKey":"details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Conversation not found"},"examples":{"Example":{"title":"Example","value":{"error":"Conversation not found"}}},"exampleType":"examples"}},"exampleType":"examples"},"93198869-1c30-4905-bc0f-30a22ee624fe":{"description":"Method not allowed","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","example":"Bad Request","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","additionalProperties":true,"uniqueKey":"details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Method not allowed"},"examples":{"Example":{"title":"Example","value":{"error":"Method not allowed"}}},"exampleType":"examples"}},"exampleType":"examples"},"78c864ba-cd5f-404e-971a-4229b6e7c9c2":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","example":"Bad Request","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","additionalProperties":true,"uniqueKey":"details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Internal Server Error"},"examples":{"Example":{"title":"Example","value":{"error":"Internal Server Error"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"4e7db532-e431-44ba-96b0-259ce17bf485":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT token from Clerk authentication.\n\nMust be from a user with `org:admin` role.\n","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"7b3613e1-cd10-434b-ad64-41c0fe7648cd":{"url":"https://www.asteragents.com/api","description":"Production"},"376a91ce-ce5e-4356-8e0a-4d472d86128f":{"url":"http://localhost:3000/api","description":"Local development"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT token from Clerk authentication.\n\nMust be from a user with `org:admin` role.\n","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"JWT token from Clerk authentication.\n\nMust be from a user with `org:admin` role.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"asteragents","siteName":"Aster Agents","title":"Get a conversation with messages - Aster Agents","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T01:35:55.243Z","originalFileLocation":"api-reference/conversations/get-a-conversation-with-messages.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=\"Retrieve a conversation and all its messages by thread ID. The conversation must belong to the authenticated user\u0026#x27;s organization. Stream status values: - in_progress: Response is currently being generated - completed: Response generation finished successfully - stopped: Response generation was manually stopped - error: Response generation encountered an error - timeout: Response generation timed out - null: No active stream\">\u003cmeta data-mint-head name=\"application-name\" content=\"Aster Agents\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/asteragents/W3pIsOnA8TOqHKUx/_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/asteragents/W3pIsOnA8TOqHKUx/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/asteragents/W3pIsOnA8TOqHKUx/_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/asteragents/W3pIsOnA8TOqHKUx/_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/asteragents/W3pIsOnA8TOqHKUx/_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/asteragents/W3pIsOnA8TOqHKUx/_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/asteragents/W3pIsOnA8TOqHKUx/_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/asteragents/W3pIsOnA8TOqHKUx/_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/asteragents/W3pIsOnA8TOqHKUx/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a conversation with messages - Aster Agents\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve a conversation and all its messages by thread ID. The conversation must belong to the authenticated user\u0026#x27;s organization. Stream status values: - in_progress: Response is currently being generated - completed: Response generation finished successfully - stopped: Response generation was manually stopped - error: Response generation encountered an error - timeout: Response generation timed out - null: No active stream\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Aster Agents\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.asteragents.com/api-reference/conversations/get-a-conversation-with-messages\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://asteragents.mintlify.app/_mintlify/api/og/v2?division=Conversations+API\u0026amp;title=Get+a+conversation+with+messages\u0026amp;description=Retrieve+a+conversation+and+all+its+messages+by+thread+ID.%0A%0AThe+conversation+must+belong+to+the+authenticated+user%27s+organization.%0A%0A**Stream+status+values%3A**%0A-+\u0026amp;theme=4c6772eb85b444c37d4e9cf2\u0026amp;signature=13425b07c308fd2d70ea4b57acad4ae34c74375d3fa3671fd5b55606e83c4e57\">\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=\"Get a conversation with messages - Aster Agents\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve a conversation and all its messages by thread ID. The conversation must belong to the authenticated user\u0026#x27;s organization. Stream status values: - in_progress: Response is currently being generated - completed: Response generation finished successfully - stopped: Response generation was manually stopped - error: Response generation encountered an error - timeout: Response generation timed out - null: No active stream\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://asteragents.mintlify.app/_mintlify/api/og/v2?division=Conversations+API\u0026amp;title=Get+a+conversation+with+messages\u0026amp;description=Retrieve+a+conversation+and+all+its+messages+by+thread+ID.%0A%0AThe+conversation+must+belong+to+the+authenticated+user%27s+organization.%0A%0A**Stream+status+values%3A**%0A-+\u0026amp;theme=4c6772eb85b444c37d4e9cf2\u0026amp;signature=13425b07c308fd2d70ea4b57acad4ae34c74375d3fa3671fd5b55606e83c4e57\">\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/asteragents/W3pIsOnA8TOqHKUx/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Aster Agents\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0A3D2C\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.asteragents.com/api-reference/conversations/get-a-conversation-with-messages\">\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/get-a-conversation-with-messages.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.asteragents.com/#organization\",\"name\":\"Aster Agents\",\"url\":\"https://docs.asteragents.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/asteragents/0Z3Pq736HygxwpDP/logo/light.svg?fit=max\u0026auto=format\u0026n=0Z3Pq736HygxwpDP\u0026q=85\u0026s=43ff25abf648e8e3684687fb287df4a7\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.asteragents.com#website\",\"name\":\"Aster Agents\",\"url\":\"https://docs.asteragents.com\",\"publisher\":{\"@id\":\"https://docs.asteragents.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.asteragents.com/api-reference/conversations/get-a-conversation-with-messages#webpage\",\"url\":\"https://docs.asteragents.com/api-reference/conversations/get-a-conversation-with-messages\",\"name\":\"Get a conversation with messages\",\"description\":\"Retrieve a conversation and all its messages by thread ID. The conversation must belong to the authenticated user's organization. Stream status values: - in_progress: Response is currently being generated - completed: Response generation finished successfully - stopped: Response generation was manually stopped - error: Response generation encountered an error - timeout: Response generation timed out - null: No active stream\",\"dateModified\":\"2026-10-29T01:35:55.243Z\",\"isPartOf\":{\"@id\":\"https://docs.asteragents.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.asteragents.com/api-reference/conversations/get-a-conversation-with-messages#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.asteragents.com/api-reference/conversations/get-a-conversation-with-messages#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Conversations API\",\"item\":\"https://docs.asteragents.com/api-reference/conversations/invoke-an-agent-start-or-continue-a-conversation\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a conversation with messages\",\"item\":\"https://docs.asteragents.com/api-reference/conversations/get-a-conversation-with-messages\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.asteragents.com/api-reference/conversations/get-a-conversation-with-messages#apireference\",\"headline\":\"Get a conversation with messages\",\"name\":\"Get a conversation with messages\",\"description\":\"Retrieve a conversation and all its messages by thread ID. The conversation must belong to the authenticated user's organization. Stream status values: - in_progress: Response is currently being generated - completed: Response generation finished successfully - stopped: Response generation was manually stopped - error: Response generation encountered an error - timeout: Response generation timed out - null: No active stream\",\"url\":\"https://docs.asteragents.com/api-reference/conversations/get-a-conversation-with-messages\",\"mainEntityOfPage\":{\"@id\":\"https://docs.asteragents.com/api-reference/conversations/get-a-conversation-with-messages#webpage\"},\"dateModified\":\"2026-10-29T01:35:55.243Z\",\"publisher\":{\"@id\":\"https://docs.asteragents.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.asteragents.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Aster Agents\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Aster Agents","nav":{"global":{"anchors":[{"anchor":"Aster Agents Dashboard","icon":"gauge","href":"https://www.asteragents.com/dashboard"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Aster Agents API","href":"/api-reference/introduction"},{"title":"Build with Claude Code","href":"/api-reference/build-on-aster"}]},{"group":"Admin API","pages":[{"title":"List organization users","deprecated":null,"version":null,"openapi":"/openapi.yaml get /admin/users","href":"/api-reference/users/list-organization-users"},{"title":"Remove users from organization","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /admin/users","href":"/api-reference/users/remove-users-from-organization"},{"title":"List organization invitations","deprecated":null,"version":null,"openapi":"/openapi.yaml get /admin/invitations","href":"/api-reference/invitations/list-organization-invitations"},{"title":"Create bulk invitations","deprecated":null,"version":null,"openapi":"/openapi.yaml post /admin/invitations","href":"/api-reference/invitations/create-bulk-invitations"},{"title":"Revoke invitations","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /admin/invitations","href":"/api-reference/invitations/revoke-invitations"},{"title":"Update user metadata","deprecated":null,"version":null,"openapi":"/openapi.yaml post /admin/updateUserMetadata","href":"/api-reference/users/update-user-metadata"}]},{"group":"Files API","pages":[{"title":"Get presigned upload URL","deprecated":null,"version":null,"openapi":"/openapi.yaml post /upload/presigned","href":"/api-reference/files/get-presigned-upload-url"}]},{"group":"Agents API","pages":[{"title":"List agents","deprecated":null,"version":null,"openapi":"/openapi.yaml get /agents","href":"/api-reference/agents/list-agents"},{"title":"Create or update an agent","deprecated":null,"version":null,"openapi":"/openapi.yaml post /agents","href":"/api-reference/agents/create-or-update-an-agent"},{"title":"Delete an agent","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /agents","href":"/api-reference/agents/delete-an-agent"},{"title":"Sync agent tool schemas","deprecated":null,"version":null,"openapi":"/openapi.yaml post /agents/sync-tools","href":"/api-reference/agents/sync-agent-tool-schemas"},{"title":"List an agent's config version history","deprecated":null,"version":null,"openapi":"/openapi.yaml get /agents/versions","href":"/api-reference/agents/list-an-agents-config-version-history"},{"title":"Roll back to a version, or save a labeled checkpoint","deprecated":null,"version":null,"openapi":"/openapi.yaml post /agents/versions","href":"/api-reference/agents/roll-back-to-a-version-or-save-a-labeled-checkpoint"}]},{"group":"Tools API","pages":[{"title":"List available tools","deprecated":null,"version":null,"openapi":"/openapi.yaml get /tools","href":"/api-reference/tools/list-available-tools"}]},{"group":"Agent Tags API","pages":[{"title":"List agent tags","deprecated":null,"version":null,"openapi":"/openapi.yaml get /agent-tags","href":"/api-reference/agent-tags/list-agent-tags"},{"title":"Create an agent tag","deprecated":null,"version":null,"openapi":"/openapi.yaml post /agent-tags","href":"/api-reference/agent-tags/create-an-agent-tag"}]},{"group":"Knowledge Bases API","pages":[{"title":"List knowledge bases","deprecated":null,"version":null,"openapi":"/openapi.yaml get /kb/manage","href":"/api-reference/knowledge-base-management/list-knowledge-bases"},{"title":"Create a knowledge base","deprecated":null,"version":null,"openapi":"/openapi.yaml post /kb/manage","href":"/api-reference/knowledge-base-management/create-a-knowledge-base"},{"title":"Update a knowledge base","deprecated":null,"version":null,"openapi":"/openapi.yaml put /kb/manage","href":"/api-reference/knowledge-base-management/update-a-knowledge-base"},{"title":"Delete a knowledge base","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /kb/manage","href":"/api-reference/knowledge-base-management/delete-a-knowledge-base"},{"title":"Associate file with knowledge base","deprecated":null,"version":null,"openapi":"/openapi.yaml post /kb/files","href":"/api-reference/knowledge-bases/associate-file-with-knowledge-base"},{"title":"List files in a knowledge base","deprecated":null,"version":null,"openapi":"/openapi.yaml get /kb/files","href":"/api-reference/knowledge-bases/list-files-in-a-knowledge-base"},{"title":"Delete a file from a knowledge base","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /kb/files","href":"/api-reference/knowledge-bases/delete-a-file-from-a-knowledge-base"}]},{"group":"Skills API","pages":[{"title":"List skills or get a single skill","deprecated":null,"version":null,"openapi":"/openapi.yaml get /skills/manage","href":"/api-reference/skills/list-skills-or-get-a-single-skill"},{"title":"Create a skill","deprecated":null,"version":null,"openapi":"/openapi.yaml post /skills/manage","href":"/api-reference/skills/create-a-skill"},{"title":"Update a skill","deprecated":null,"version":null,"openapi":"/openapi.yaml put /skills/manage","href":"/api-reference/skills/update-a-skill"},{"title":"Delete a skill","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /skills/manage","href":"/api-reference/skills/delete-a-skill"},{"title":"List files for a skill","deprecated":null,"version":null,"openapi":"/openapi.yaml get /skills/files","href":"/api-reference/skill-files/list-files-for-a-skill"},{"title":"Upload a bundled file","deprecated":null,"version":null,"openapi":"/openapi.yaml post /skills/files","href":"/api-reference/skill-files/upload-a-bundled-file"},{"title":"Delete a bundled file","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /skills/files","href":"/api-reference/skill-files/delete-a-bundled-file"}]},{"group":"Conversations API","pages":[{"title":"Invoke an agent (start or continue a conversation)","description":"Send a message to an agent and run it. This is how you invoke an agent\nprogrammatically — `POST /agents` only *builds* agents; this *runs* them.\n\nThe agent must belong to the authenticated user's organization, and the\norg must have an API key configured for the agent's model provider\n(Control Hub → Providers) or the run will end with `streamStatus: \"error\"`.\n\n**Two response modes**, selected by the `X-Stream-Response` header:\n\n- **Non-streaming (recommended for API/automation)** — set\n `X-Stream-Response: false`. Returns **`202 Accepted`** immediately with\n `{ threadId, status: \"in_progress\" }` and an `X-Thread-ID` header, then\n runs the agent in the background. Poll\n `GET /getConversation?threadId={threadId}` until `streamStatus` is\n terminal (`completed` / `stopped` / `error` / `timeout`), then read the\n assistant message(s) from `messages`. This avoids platform request\n timeouts on long-running, multi-tool agents.\n- **Streaming** — omit the header (or send anything other than `false`).\n Returns **`200`** with a `text/event-stream` (AI SDK UI-message stream)\n and an `X-Thread-ID` header. Consume the SSE stream for incremental\n output. Most non-browser clients should prefer the non-streaming mode.\n\n**Conversation continuity:** omit `threadId` to start a new conversation\n(one is generated and returned in the `X-Thread-ID` header); pass an\nexisting `threadId` to continue that thread. The message body uses the\nv5 `parts` format.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /chat","href":"/api-reference/conversations/invoke-an-agent-start-or-continue-a-conversation"},{"title":"Get a conversation with messages","deprecated":null,"version":null,"openapi":"/openapi.yaml get /getConversation","href":"/api-reference/conversations/get-a-conversation-with-messages"}]},{"group":"Scheduled Tasks API","pages":[{"title":"List scheduled tasks (or get one)","description":"Without `taskId`, returns the caller's scheduled tasks as a **bare JSON\narray**. With `taskId`, returns that single task object. Admins may pass\n`allInOrg=true` to list every task in the org.\n\nRequires Control Hub access (any non-guest org role).\n","deprecated":null,"version":null,"openapi":"/openapi.yaml get /scheduled-tasks/manage","href":"/api-reference/scheduled-tasks/list-scheduled-tasks-or-get-one"},{"title":"Create a scheduled task","deprecated":null,"version":null,"openapi":"/openapi.yaml post /scheduled-tasks/manage","href":"/api-reference/scheduled-tasks/create-a-scheduled-task"},{"title":"Update a scheduled task","deprecated":null,"version":null,"openapi":"/openapi.yaml put /scheduled-tasks/manage","href":"/api-reference/scheduled-tasks/update-a-scheduled-task"},{"title":"Delete a scheduled task","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /scheduled-tasks/manage","href":"/api-reference/scheduled-tasks/delete-a-scheduled-task"},{"title":"Enable or disable a scheduled task","deprecated":null,"version":null,"openapi":"/openapi.yaml post /scheduled-tasks/toggle","href":"/api-reference/scheduled-tasks/enable-or-disable-a-scheduled-task"},{"title":"List task execution history (or stats)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /scheduled-tasks/executions","href":"/api-reference/scheduled-tasks/list-task-execution-history-or-stats"}]},{"group":"Organization Settings API","pages":[{"title":"Get organization settings","deprecated":null,"version":null,"openapi":"/openapi.yaml get /orgSettings","href":"/api-reference/organization-settings/get-organization-settings"},{"title":"Update organization settings","deprecated":null,"version":null,"openapi":"/openapi.yaml post /orgSettings","href":"/api-reference/organization-settings/update-organization-settings"}]},{"group":"Other Endpoints","pages":[{"title":"Chat with an AI Agent","api":"POST /chat","playground":{"mode":"show","request":{"paramFields":{"expanded":"topLevel"},"example":{"languages":["curl","python","javascript","php"]}}},"href":"/api-reference/endpoint/chat"},{"title":"Get Dashboard Stats","api":"GET /dashboard/getStats","href":"/api-reference/endpoint/dashboard-stats"},{"title":"Get Dashboard Interactions","api":"GET /dashboard/getInteractions","href":"/api-reference/endpoint/dashboard-interactions"}]},{"group":"Legacy Endpoints (Deprecated)","pages":[{"title":"Bulk User Invitation","api":"POST /admin/bulkInvite","playground":{"mode":"show","request":{"paramFields":{"expanded":"topLevel"},"example":{"languages":["curl","python","javascript"]}}},"href":"/api-reference/endpoint/bulk-invite"},{"title":"Bulk User Removal","api":"POST /admin/bulkRemove","deprecated":true,"playground":{"mode":"show","request":{"paramFields":{"expanded":"topLevel"},"example":{"languages":["curl","python","javascript"]}}},"href":"/api-reference/endpoint/bulk-remove"},{"title":"Get Organization Users","api":"GET /admin/getUsersInOrg","deprecated":true,"href":"/api-reference/endpoint/get-users-in-org"}]}]}]},"basePath":"","title":"Get a conversation with messages - Aster Agents","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}