import os
from davinci_sdk import DavinciClient
with DavinciClient(api_key=os.environ["DAVINCI_API_KEY"]) as client:
chats = client.chats.list(project_id).chats
with client.sessions.create(project_id) as session:
session.switch_chat(chats[0].id)
session.send_message("Where did we leave the bracket?")
import { DavinciClient } from '@celedon/davinci-sdk';
const client = new DavinciClient({
apiKey: process.env.DAVINCI_API_KEY!,
});
const { chats } = await client.chats.list(projectId);
const session = await client.sessions.create(projectId);
await session.switchChat(chats[0].id);
await session.sendMessage('Where did we leave the bracket?');
Move a session into another chat, or start a fresh one
Sets which chat the session’s prompts go to. Name a chatId from listChats
to carry on that conversation — the agent picks it up with its history.
Omit chatId, or send null, to start a fresh chat; like a new session’s
first chat, it is only stored once you send something in it.
A run in the session’s previous chat keeps going to the end, and that chat
stays in your list if anything was said in it. Read its messages to follow
the run, or switch back to carry on in it. Closing the session stops every
run it has going.
A chat belongs to one session at a time. If another of your sessions is in
the chat you name, or left a run going there, this session takes it over:
the other session’s run in it is stopped, and if it was in that chat it
continues in a fresh one. Its ids are returned in takenOverFrom.
Your API chats also appear in the web app, where you can watch a session
work and take a chat over. The session’s run there stops, and its prompts
to that chat answer 409 CHAT_TAKEN_OVER until a session reopens the chat
here. Reopening takes it back from the web app, including when it is the
chat the session is already in. A chat with a run going in the web app
cannot be opened or reopened until that run ends; the switch answers
409 CHAT_IN_USE and changes nothing.
Otherwise, naming the chat the session is already in changes nothing.
import os
from davinci_sdk import DavinciClient
with DavinciClient(api_key=os.environ["DAVINCI_API_KEY"]) as client:
chats = client.chats.list(project_id).chats
with client.sessions.create(project_id) as session:
session.switch_chat(chats[0].id)
session.send_message("Where did we leave the bracket?")
import { DavinciClient } from '@celedon/davinci-sdk';
const client = new DavinciClient({
apiKey: process.env.DAVINCI_API_KEY!,
});
const { chats } = await client.chats.list(projectId);
const session = await client.sessions.create(projectId);
await session.switchChat(chats[0].id);
await session.sendMessage('Where did we leave the bracket?');
Personal access token. The scopes granted at issuance determine both which
operations the key may call and the ceiling on the resource permissions it
can exercise. Each scope family is a ladder: projects:manage implies
projects:write and projects:read; cards:manage implies cards:write
and cards:read; and teams:manage implies teams:write and teams:read.
These are named API capability bundles, not blanket domain roles:
manage exposes only the permissions enumerated for that scope and never
bypasses the acting user's current role-based access.
Path Parameters
projectId
string
required
Project id. May be compound in the form {projectId}--{branchName}.
Minimum string length: 1
sessionId
string<uuid>
required
Session id from createSession.
Body
application/json
chatId
string<uuid> | null
The chat to carry on in. Omit it, or send null, to start a fresh chat.
Response
The session is in the chat.
sessionId
string<uuid>
required
previousChatId
string<uuid>
required
The chat the session was in before. The same as chat.id when nothing changed.
chat
object
required
Hide child attributes
chat.id
string<uuid>
required
chat.title
string | null
required
Named from the conversation's opening unless renameChat set it; null
until it has one.
chat.messageCount
integer
required
Entries stored in the conversation — prompts, replies, and tool use. Zero
for a fresh chat nothing has been sent in yet.
Required range: x >= 0
chat.createdAt
string<date-time> | null
required
Null for a fresh chat, which is not stored until its first message.
chat.updatedAt
string<date-time> | null
required
Last activity. Null for a fresh chat.
takenOverFrom
string<uuid>[]
Your other sessions this chat was taken from. Each one's run here was
stopped, and one that was in the chat was moved to a fresh one. Absent
when no session had the chat.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Davinci","colors":{"primary":"#7e57c2","light":"#9575cd","dark":"#9575cd"},"logo":{"light":"https://mintcdn.com/celedonsolutions/Jrllsva0Wnxsp6y9/logo/logo_small_bright.svg?fit=max\u0026auto=format\u0026n=Jrllsva0Wnxsp6y9\u0026q=85\u0026s=41189259a1bfc87c7f7cf8cf9f61193b","dark":"https://mintcdn.com/celedonsolutions/Jrllsva0Wnxsp6y9/logo/logo_small_dark.svg?fit=max\u0026auto=format\u0026n=Jrllsva0Wnxsp6y9\u0026q=85\u0026s=07e028cf677688639943764e164f3dc5"},"favicon":"https://mintcdn.com/celedonsolutions/Jrllsva0Wnxsp6y9/logo/fav_icon_dark.svg?fit=max\u0026auto=format\u0026n=Jrllsva0Wnxsp6y9\u0026q=85\u0026s=8b0ee429fa65e1bd9438e780cd413367","api":{"openapi":{"source":"openapi/davinci-public.v2.yaml","directory":"api-reference"},"params":{"expanded":"all"},"playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required","languages":["bash","python","typescript","javascript"],"prefill":true,"autogenerate":true},"url":"full"},"appearance":{"default":"dark","strict":false},"navbar":{"links":[{"href":"/pages/release-notes/v5.3.5","label":"v5.3.5"},{"href":"https://www.celedon.solutions/","label":"Celedon Solutions"}],"primary":{"type":"button","label":"Use Davinci","href":"https://davinci-app.com"}},"footer":{"socials":{"bluesky":"https://bsky.app/profile/celedon.solutions","x":"https://x.com/Celedon_inc","linkedin":"https://www.linkedin.com/company/celedon-solutions-inc","github":"https://github.com/Celedon-Solutions"},"links":[{"header":"Company","items":[{"label":"About","href":"https://celedon.solutions/about"},{"label":"Careers","href":"https://celedon.solutions/careers"},{"label":"Contact","href":"https://celedon.solutions/contact"}]},{"header":"Legal","items":[{"label":"Terms of Service","href":"https://celedon.solutions/terms-of-service"},{"label":"Credit Policy","href":"https://celedon.solutions/credit-policy"},{"label":"Privacy Policy","href":"https://celedon.solutions/privacy-policy"},{"label":"Third Party Policy","href":"https://celedon.solutions/third-party-policies"}]}]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"celedonsolutions","hasAudioNarration":false,"actualSubdomain":"celedonsolutions","customDomains":["docs.davinci-app.com"],"gitSource":{"type":"github","owner":"celedon-solutions","repo":"davinci-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6afdf9561258598915902065","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"Developer API","count":112},{"language":"default","tag":"API Reference","count":110},{"language":"default","tag":"Modeling Guide","count":66},{"language":"default","tag":"Release Notes Archive","count":60},{"language":"default","tag":"Davinci Editor","count":39},{"language":"default","tag":"Teams","count":33},{"language":"default","tag":"Object Types","count":28},{"language":"default","tag":"Cards","count":28},{"language":"default","tag":"Object Views","count":27},{"language":"default","tag":"Release Notes","count":25}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"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":"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":"editor-metadata","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},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"sidebar-scroll.css","content":"#sidebar{top:4rem}#sidebar-content{max-height:calc(100vh - 4rem);overflow-y:auto;overflow-x:hidden;overscroll-behavior:contain;padding-bottom:2rem}#sidebar-content ul{gap:1px}#sidebar-content ul>li+li{margin-top:1px}#sidebar-content ul a,#sidebar-content ul button{padding-top:0.2rem;padding-bottom:0.2rem;min-height:1.5rem}#sidebar-content #sidebar-title,#sidebar-content h5{margin-bottom:0.35rem}#sidebar-content .mt-6,#sidebar-content .mt-8{margin-top:1rem}"},{"filePath":"diagrams.css","content":".centered-diagram .mermaid svg{margin-left:auto;margin-right:auto}"}],"page":{"pagePath":"api-reference/chats/move-a-session-into-another-chat-or-start-a-fresh-one","slug":"/api-reference/chats/move-a-session-into-another-chat-or-start-a-fresh-one","pageMetadata":{"title":"Move a session into another chat, or start a fresh one","description":"Sets which chat the session's prompts go to. Name a `chatId` from `listChats`\nto carry on that conversation — the agent picks it up with its history.\nOmit `chatId`, or send `null`, to start a fresh chat; like a new session's\nfirst chat, it is only stored once you send something in it.\n\nA run in the session's previous chat keeps going to the end, and that chat\nstays in your list if anything was said in it. Read its messages to follow\nthe run, or switch back to carry on in it. Closing the session stops every\nrun it has going.\n\nA chat belongs to one session at a time. If another of your sessions is in\nthe chat you name, or left a run going there, this session takes it over:\nthe other session's run in it is stopped, and if it was in that chat it\ncontinues in a fresh one. Its ids are returned in `takenOverFrom`.\n\nYour API chats also appear in the web app, where you can watch a session\nwork and take a chat over. The session's run there stops, and its prompts\nto that chat answer `409 CHAT_TAKEN_OVER` until a session reopens the chat\nhere. Reopening takes it back from the web app, including when it is the\nchat the session is already in. A chat with a run going in the web app\ncannot be opened or reopened until that run ends; the switch answers\n`409 CHAT_IN_USE` and changes nothing.\n\nOtherwise, naming the chat the session is already in changes nothing.\n","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml put /api/v2/projects/{projectId}/sessions/{sessionId}/chat","href":"/api-reference/chats/move-a-session-into-another-chat-or-start-a-fresh-one","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 p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Sets which chat the session’s prompts go to. Name a \", _jsx(_components.code, {\n children: \"chatId\"\n }), \" from \", _jsx(_components.code, {\n children: \"listChats\"\n }), \"\\nto carry on that conversation — the agent picks it up with its history.\\nOmit \", _jsx(_components.code, {\n children: \"chatId\"\n }), \", or send \", _jsx(_components.code, {\n children: \"null\"\n }), \", to start a fresh chat; like a new session’s\\nfirst chat, it is only stored once you send something in it.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"A run in the session’s previous chat keeps going to the end, and that chat\\nstays in your list if anything was said in it. Read its messages to follow\\nthe run, or switch back to carry on in it. Closing the session stops every\\nrun it has going.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"A chat belongs to one session at a time. If another of your sessions is in\\nthe chat you name, or left a run going there, this session takes it over:\\nthe other session’s run in it is stopped, and if it was in that chat it\\ncontinues in a fresh one. Its ids are returned in \", _jsx(_components.code, {\n children: \"takenOverFrom\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Your API chats also appear in the web app, where you can watch a session\\nwork and take a chat over. The session’s run there stops, and its prompts\\nto that chat answer \", _jsx(_components.code, {\n children: \"409 CHAT_TAKEN_OVER\"\n }), \" until a session reopens the chat\\nhere. Reopening takes it back from the web app, including when it is the\\nchat the session is already in. A chat with a run going in the web app\\ncannot be opened or reopened until that run ends; the switch answers\\n\", _jsx(_components.code, {\n children: \"409 CHAT_IN_USE\"\n }), \" and changes nothing.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Otherwise, naming the chat the session is already in changes nothing.\"\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":"Move a session into another chat, or start a fresh one","description":"Sets which chat the session's prompts go to. Name a `chatId` from `listChats`\nto carry on that conversation — the agent picks it up with its history.\nOmit `chatId`, or send `null`, to start a fresh chat; like a new session's\nfirst chat, it is only stored once you send something in it.\n\nA run in the session's previous chat keeps going to the end, and that chat\nstays in your list if anything was said in it. Read its messages to follow\nthe run, or switch back to carry on in it. Closing the session stops every\nrun it has going.\n\nA chat belongs to one session at a time. If another of your sessions is in\nthe chat you name, or left a run going there, this session takes it over:\nthe other session's run in it is stopped, and if it was in that chat it\ncontinues in a fresh one. Its ids are returned in `takenOverFrom`.\n\nYour API chats also appear in the web app, where you can watch a session\nwork and take a chat over. The session's run there stops, and its prompts\nto that chat answer `409 CHAT_TAKEN_OVER` until a session reopens the chat\nhere. Reopening takes it back from the web app, including when it is the\nchat the session is already in. A chat with a run going in the web app\ncannot be opened or reopened until that run ends; the switch answers\n`409 CHAT_IN_USE` and changes nothing.\n\nOtherwise, naming the chat the session is already in changes nothing.\n","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml put /api/v2/projects/{projectId}/sessions/{sessionId}/chat","href":"/api-reference/chats/move-a-session-into-another-chat-or-start-a-fresh-one","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"switchSessionChat","tags":["Chats"],"summary":"Move a session into another chat, or start a fresh one","description":"Sets which chat the session's prompts go to. Name a `chatId` from `listChats`\nto carry on that conversation — the agent picks it up with its history.\nOmit `chatId`, or send `null`, to start a fresh chat; like a new session's\nfirst chat, it is only stored once you send something in it.\n\nA run in the session's previous chat keeps going to the end, and that chat\nstays in your list if anything was said in it. Read its messages to follow\nthe run, or switch back to carry on in it. Closing the session stops every\nrun it has going.\n\nA chat belongs to one session at a time. If another of your sessions is in\nthe chat you name, or left a run going there, this session takes it over:\nthe other session's run in it is stopped, and if it was in that chat it\ncontinues in a fresh one. Its ids are returned in `takenOverFrom`.\n\nYour API chats also appear in the web app, where you can watch a session\nwork and take a chat over. The session's run there stops, and its prompts\nto that chat answer `409 CHAT_TAKEN_OVER` until a session reopens the chat\nhere. Reopening takes it back from the web app, including when it is the\nchat the session is already in. A chat with a run going in the web app\ncannot be opened or reopened until that run ends; the switch answers\n`409 CHAT_IN_USE` and changes nothing.\n\nOtherwise, naming the chat the session is already in changes nothing.\n","security":["09a85856-bbdc-4b8d-b818-e452bb61d256"],"x-routing-server-source":"RoutingServer/agentChat/agentChat.routes.js","x-required-scopes":["sessions:manage"],"x-sdk-methods":{"typescript":"session.switchChat","python":"session.switch_chat"},"x-codeSamples":[{"lang":"typescript","label":"TypeScript SDK","source":"import { DavinciClient } from '@celedon/davinci-sdk';\n\nconst client = new DavinciClient({\n apiKey: process.env.DAVINCI_API_KEY!,\n});\n\nconst { chats } = await client.chats.list(projectId);\nconst session = await client.sessions.create(projectId);\nawait session.switchChat(chats[0].id);\nawait session.sendMessage('Where did we leave the bracket?');\n"},{"lang":"python","label":"Python SDK","source":"import os\nfrom davinci_sdk import DavinciClient\n\nwith DavinciClient(api_key=os.environ[\"DAVINCI_API_KEY\"]) as client:\n chats = client.chats.list(project_id).chats\n with client.sessions.create(project_id) as session:\n session.switch_chat(chats[0].id)\n session.send_message(\"Where did we leave the bracket?\")\n"}],"requestBody":"c7303946-dc38-4d8d-a27d-24c5ab2a22ea","responses":{"200":"f0c4b339-5ca4-40f3-bc23-d2f3efd4bd72","400":"c8764415-8553-45e5-9b84-f941a76941b7","401":"48261390-bbc8-4d4b-b55d-821d846a00bd","403":"429cfb35-7fa9-447f-bd87-dc846788498d","404":"e7a265a0-a4c4-4d39-aaf4-4d41fce85d20","409":"765533c4-f900-48fd-a9dc-2f1230864434","429":"fdd087c9-5a6b-4a74-9ade-e7315a60eb58","500":"10e33ce0-a691-4d4d-ace9-3f9114cc3dca"},"method":"put","type":"path","servers":["f440d231-e623-4563-8ff3-a41b6569a8c2","9e35f479-c3b2-4a87-8a2a-335ecab35020"],"path":"/api/v2/projects/{projectId}/sessions/{sessionId}/chat","baseUrlOptions":["https://davinci-app.com","https://davinci-app.com/data"],"title":"Move a session into another chat, or start a fresh one","codeSamples":[{"label":"TypeScript SDK","lang":"typescript","source":"import { DavinciClient } from '@celedon/davinci-sdk';\n\nconst client = new DavinciClient({\n apiKey: process.env.DAVINCI_API_KEY!,\n});\n\nconst { chats } = await client.chats.list(projectId);\nconst session = await client.sessions.create(projectId);\nawait session.switchChat(chats[0].id);\nawait session.sendMessage('Where did we leave the bracket?');\n"},{"label":"Python SDK","lang":"python","source":"import os\nfrom davinci_sdk import DavinciClient\n\nwith DavinciClient(api_key=os.environ[\"DAVINCI_API_KEY\"]) as client:\n chats = client.chats.list(project_id).chats\n with client.sessions.create(project_id) as session:\n session.switch_chat(chats[0].id)\n session.send_message(\"Where did we leave the bracket?\")\n"}],"requestExampleLanguages":["bash","python","typescript","javascript"],"requiredOnlyExamples":true,"requestExampleType":"codeSamples","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.chatId.oneOf.0":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}],"urlDisplay":"full"},"dependencies":{"parameters":{"9063e2a2-ba31-43f4-a0c4-d7cb23b42ae1":{"name":"projectId","in":"path","required":true,"schema":{"type":"string","minLength":1,"isRequired":true,"description":"Project id. May be compound in the form `{projectId}--{branchName}`.","uniqueKey":"","typeLabel":"string"},"description":"Project id. May be compound in the form `{projectId}--{branchName}`."},"e0847638-4386-4a36-a260-ddad94221606":{"name":"sessionId","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"description":"Session id from `createSession`.","uniqueKey":"","typeLabel":"string\u003cuuid>"},"description":"Session id from `createSession`."}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"chatId":{"oneOf":[{"type":"string","format":"uuid","description":"The chat to carry on in. Omit it, or send null, to start a fresh chat.\n","uniqueKey":"chatId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"The chat to carry on in. Omit it, or send null, to start a fresh chat.\n","uniqueKey":"chatId.oneOf.1","typeLabel":"null"}],"uniqueKey":"chatId","typeLabel":"string\u003cuuid> | null"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"chatId":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"f0c4b339-5ca4-40f3-bc23-d2f3efd4bd72":{"description":"The session is in the chat.","content":{"application/json":{"schema":{"type":"object","required":["sessionId","previousChatId","chat"],"properties":{"sessionId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"sessionId","typeLabel":"string\u003cuuid>"},"previousChatId":{"type":"string","format":"uuid","description":"The chat the session was in before. The same as `chat.id` when nothing changed.","isRequired":true,"uniqueKey":"previousChatId","typeLabel":"string\u003cuuid>"},"chat":{"type":"object","required":["id","title","messageCount","createdAt","updatedAt"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"chat.id","typeLabel":"string\u003cuuid>"},"title":{"oneOf":[{"type":"string","description":"Named from the conversation's opening unless `renameChat` set it; null\nuntil it has one.\n","isRequired":true,"uniqueKey":"chat.title.oneOf.0","typeLabel":"string"},{"type":"null","description":"Named from the conversation's opening unless `renameChat` set it; null\nuntil it has one.\n","isRequired":true,"uniqueKey":"chat.title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"chat.title","typeLabel":"string | null"},"messageCount":{"type":"integer","minimum":0,"description":"Entries stored in the conversation — prompts, replies, and tool use. Zero\nfor a fresh chat nothing has been sent in yet.\n","isRequired":true,"uniqueKey":"chat.messageCount","typeLabel":"integer"},"createdAt":{"oneOf":[{"type":"string","format":"date-time","description":"Null for a fresh chat, which is not stored until its first message.","isRequired":true,"uniqueKey":"chat.createdAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Null for a fresh chat, which is not stored until its first message.","isRequired":true,"uniqueKey":"chat.createdAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"chat.createdAt","typeLabel":"string\u003cdate-time> | null"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time","description":"Last activity. Null for a fresh chat.","isRequired":true,"uniqueKey":"chat.updatedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Last activity. Null for a fresh chat.","isRequired":true,"uniqueKey":"chat.updatedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"chat.updatedAt","typeLabel":"string\u003cdate-time> | null"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"chat","typeLabel":"object"},"takenOverFrom":{"type":"array","description":"Your other sessions this chat was taken from. Each one's run here was\nstopped, and one that was in the chat was moved to a fresh one. Absent\nwhen no session had the chat.\n","items":{"type":"string","format":"uuid","uniqueKey":"takenOverFrom.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"takenOverFrom","typeLabel":"string\u003cuuid>[]"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"sessionId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","previousChatId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","chat":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","title":"\u003cstring>","messageCount":1,"createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z"},"takenOverFrom":["3c90c3cc-0d44-4b50-8888-8dd25736052a"]}}},"exampleType":"generated"}},"exampleType":"generated"},"c8764415-8553-45e5-9b84-f941a76941b7":{"description":"`chatId` is not a chat id. Error code is `INVALID_CHAT_ID`.","content":{"application/json":{"schema":{"description":"The error shape for every failure on this API, whether it was refused by the\ncredential layer before reaching a domain or by the domain itself.\n\nBranch on `code`, which is stable. `message` is for a person reading a log or\na dialog and may be reworded. `details` carries fields specific to one\nfailure — a project-limit refusal reports its numbers there — and is absent\nwhen there are none.\n","type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"\u003cstring>","message":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"48261390-bbc8-4d4b-b55d-821d846a00bd":{"description":"No credential was supplied, or the supplied credential is malformed, expired,\nor revoked. A credential that is present but unusable is never downgraded to\nan anonymous request.\n","content":{"application/json":{"schema":{"description":"The error shape for every failure on this API, whether it was refused by the\ncredential layer before reaching a domain or by the domain itself.\n\nBranch on `code`, which is stable. `message` is for a person reading a log or\na dialog and may be reworded. `details` carries fields specific to one\nfailure — a project-limit refusal reports its numbers there — and is absent\nwhen there are none.\n","type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"\u003cstring>","message":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"429cfb35-7fa9-447f-bd87-dc846788498d":{"description":"Authenticated but not authorized. Either the acting user lacks the required\nresource permission, the key's scope ceiling excludes it, or the endpoint\nrejects this credential type (`CREDENTIAL_NOT_PERMITTED`).\n","content":{"application/json":{"schema":{"description":"The error shape for every failure on this API, whether it was refused by the\ncredential layer before reaching a domain or by the domain itself.\n\nBranch on `code`, which is stable. `message` is for a person reading a log or\na dialog and may be reworded. `details` carries fields specific to one\nfailure — a project-limit refusal reports its numbers there — and is absent\nwhen there are none.\n","type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"\u003cstring>","message":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"e7a265a0-a4c4-4d39-aaf4-4d41fce85d20":{"description":"No such session (`SESSION_NOT_FOUND`), or no such chat among yours in this\nproject (`CHAT_NOT_FOUND`).\n","content":{"application/json":{"schema":{"description":"The error shape for every failure on this API, whether it was refused by the\ncredential layer before reaching a domain or by the domain itself.\n\nBranch on `code`, which is stable. `message` is for a person reading a log or\na dialog and may be reworded. `details` carries fields specific to one\nfailure — a project-limit refusal reports its numbers there — and is absent\nwhen there are none.\n","type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"\u003cstring>","message":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"765533c4-f900-48fd-a9dc-2f1230864434":{"description":"Another session moved into the same chat at the same moment\n(`CHAT_SWITCH_CONFLICT`; retry), or the chat has a run going in the web\napp (`CHAT_IN_USE`; retry once it ends).\n","content":{"application/json":{"schema":{"description":"The error shape for every failure on this API, whether it was refused by the\ncredential layer before reaching a domain or by the domain itself.\n\nBranch on `code`, which is stable. `message` is for a person reading a log or\na dialog and may be reworded. `details` carries fields specific to one\nfailure — a project-limit refusal reports its numbers there — and is absent\nwhen there are none.\n","type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"\u003cstring>","message":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"fdd087c9-5a6b-4a74-9ade-e7315a60eb58":{"description":"Request rate exceeded, either globally or for this key.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."}},"content":{"application/json":{"schema":{"description":"The error shape for every failure on this API, whether it was refused by the\ncredential layer before reaching a domain or by the domain itself.\n\nBranch on `code`, which is stable. `message` is for a person reading a log or\na dialog and may be reworded. `details` carries fields specific to one\nfailure — a project-limit refusal reports its numbers there — and is absent\nwhen there are none.\n","type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"\u003cstring>","message":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"10e33ce0-a691-4d4d-ace9-3f9114cc3dca":{"description":"Unexpected server error.","content":{"application/json":{"schema":{"description":"The error shape for every failure on this API, whether it was refused by the\ncredential layer before reaching a domain or by the domain itself.\n\nBranch on `code`, which is stable. `message` is for a person reading a log or\na dialog and may be reworded. `details` carries fields specific to one\nfailure — a project-limit refusal reports its numbers there — and is absent\nwhen there are none.\n","type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"\u003cstring>","message":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"09a85856-bbdc-4b8d-b818-e452bb61d256":{"ApiKeyBearer":{"type":"http","scheme":"bearer","bearerFormat":"dav_ak_live_... or dav_ak_test_...","x-default":"dav_ak_live_your_token","description":"Personal access token. The scopes granted at issuance determine both which\noperations the key may call and the ceiling on the resource permissions it\ncan exercise. Each scope family is a ladder: `projects:manage` implies\n`projects:write` and `projects:read`; `cards:manage` implies `cards:write`\nand `cards:read`; and `teams:manage` implies `teams:write` and `teams:read`.\nThese are named API capability bundles, not blanket domain roles:\n`manage` exposes only the permissions enumerated for that scope and never\nbypasses the acting user's current role-based access.\n","scopes":[],"schemeName":"ApiKeyBearer"}}},"servers":{"f440d231-e623-4563-8ff3-a41b6569a8c2":{"url":"https://davinci-app.com","description":"Production (control plane)"},"9e35f479-c3b2-4a87-8a2a-335ecab35020":{"url":"https://davinci-app.com/data","description":"Production (data plane). Serves the operations marked `x-plane: data`, using a session's grant rather than an API key."}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"dav_ak_live_... or dav_ak_test_...","x-default":"dav_ak_live_your_token","description":"Personal access token. The scopes granted at issuance determine both which\noperations the key may call and the ceiling on the resource permissions it\ncan exercise. Each scope family is a ladder: `projects:manage` implies\n`projects:write` and `projects:read`; `cards:manage` implies `cards:write`\nand `cards:read`; and `teams:manage` implies `teams:write` and `teams:read`.\nThese are named API capability bundles, not blanket domain roles:\n`manage` exposes only the permissions enumerated for that scope and never\nbypasses the acting user's current role-based access.\n","scopes":[],"schemeName":"ApiKeyBearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Personal access token. The scopes granted at issuance determine both which\noperations the key may call and the ceiling on the resource permissions it\ncan exercise. Each scope family is a ladder: `projects:manage` implies\n`projects:write` and `projects:read`; `cards:manage` implies `cards:write`\nand `cards:read`; and `teams:manage` implies `teams:write` and `teams:read`.\nThese are named API capability bundles, not blanket domain roles:\n`manage` exposes only the permissions enumerated for that scope and never\nbypasses the acting user's current role-based access.\n","format":"bearer","default":"dav_ak_live_your_token","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKeyBearer","name":"Authorization"}],"title":"ApiKeyBearer"}]},"originalFileLocation":"openapi/davinci-public.v2.yaml"},"subdomain":"celedonsolutions","siteName":"Davinci","title":"Move a session into another chat, or start a fresh one - Davinci","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T18:41:42.248Z","originalFileLocation":"api-reference/chats/move-a-session-into-another-chat-or-start-a-fresh-one.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=\"dark\"}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=\"Sets which chat the session\u0026#x27;s prompts go to. Name a chatId from listChats to carry on that conversation — the agent picks it up with its history. Omit chatId, or send null, to start a fresh chat; like a new session\u0026#x27;s first chat, it is only stored once you send something in it. A run in the session\u0026#x27;s previous chat keeps going to the end, and that chat stays in your list if anything was said in it. Read its messages to follow the run, or switch back to carry on in it. Closing the session stops every run it has going. A chat belongs to one session at a time. If another of your sessions is in the chat you name, or left a run going there, this session takes it over: the other session\u0026#x27;s run in it is stopped, and if it was in that chat it continues in a fresh one. Its ids are returned in takenOverFrom. Your API chats also appear in the web app, where you can watch a session work and take a chat over. The session\u0026#x27;s run there stops, and its prompts to that chat answer 409 CHAT_TAKEN_OVER until a session reopens the chat here. Reopening takes it back from the web app, including when it is the chat the session is already in. A chat with a run going in the web app cannot be opened or reopened until that run ends; the switch answers 409 CHAT_IN_USE and changes nothing. Otherwise, naming the chat the session is already in changes nothing.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Davinci\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/celedonsolutions/oDVafbys7dzUhWoI/_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/celedonsolutions/oDVafbys7dzUhWoI/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/celedonsolutions/oDVafbys7dzUhWoI/_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/celedonsolutions/oDVafbys7dzUhWoI/_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/celedonsolutions/oDVafbys7dzUhWoI/_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/celedonsolutions/oDVafbys7dzUhWoI/_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/celedonsolutions/oDVafbys7dzUhWoI/_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/celedonsolutions/oDVafbys7dzUhWoI/_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/celedonsolutions/oDVafbys7dzUhWoI/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Move a session into another chat, or start a fresh one - Davinci\">\u003cmeta data-mint-head property=\"og:description\" content=\"Sets which chat the session\u0026#x27;s prompts go to. Name a chatId from listChats to carry on that conversation — the agent picks it up with its history. Omit chatId, or send null, to start a fresh chat; like a new session\u0026#x27;s first chat, it is only stored once you send something in it. A run in the session\u0026#x27;s previous chat keeps going to the end, and that chat stays in your list if anything was said in it. Read its messages to follow the run, or switch back to carry on in it. Closing the session stops every run it has going. A chat belongs to one session at a time. If another of your sessions is in the chat you name, or left a run going there, this session takes it over: the other session\u0026#x27;s run in it is stopped, and if it was in that chat it continues in a fresh one. Its ids are returned in takenOverFrom. Your API chats also appear in the web app, where you can watch a session work and take a chat over. The session\u0026#x27;s run there stops, and its prompts to that chat answer 409 CHAT_TAKEN_OVER until a session reopens the chat here. Reopening takes it back from the web app, including when it is the chat the session is already in. A chat with a run going in the web app cannot be opened or reopened until that run ends; the switch answers 409 CHAT_IN_USE and changes nothing. Otherwise, naming the chat the session is already in changes nothing.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Davinci\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.davinci-app.com/api-reference/chats/move-a-session-into-another-chat-or-start-a-fresh-one\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://celedonsolutions.mintlify.site/_mintlify/api/og/v2?division=Chats\u0026amp;title=Move+a+session+into+another+chat%2C+or+start+a+fresh+one\u0026amp;description=Sets+which+chat+the+session%27s+prompts+go+to.+Name+a+%60chatId%60+from+%60listChats%60%0Ato+carry+on+that+conversation+%E2%80%94+the+agent+picks+it+up+with+its+history.%0AOmit+%60chat\u0026amp;theme=78d8ed9f672a237868c29fac\u0026amp;signature=dc5f71adba8c1e9644a4277ba37d7943c33812d45833d3af6d9f820940cfcc50\">\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=\"Move a session into another chat, or start a fresh one - Davinci\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Sets which chat the session\u0026#x27;s prompts go to. Name a chatId from listChats to carry on that conversation — the agent picks it up with its history. Omit chatId, or send null, to start a fresh chat; like a new session\u0026#x27;s first chat, it is only stored once you send something in it. A run in the session\u0026#x27;s previous chat keeps going to the end, and that chat stays in your list if anything was said in it. Read its messages to follow the run, or switch back to carry on in it. Closing the session stops every run it has going. A chat belongs to one session at a time. If another of your sessions is in the chat you name, or left a run going there, this session takes it over: the other session\u0026#x27;s run in it is stopped, and if it was in that chat it continues in a fresh one. Its ids are returned in takenOverFrom. Your API chats also appear in the web app, where you can watch a session work and take a chat over. The session\u0026#x27;s run there stops, and its prompts to that chat answer 409 CHAT_TAKEN_OVER until a session reopens the chat here. Reopening takes it back from the web app, including when it is the chat the session is already in. A chat with a run going in the web app cannot be opened or reopened until that run ends; the switch answers 409 CHAT_IN_USE and changes nothing. Otherwise, naming the chat the session is already in changes nothing.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://celedonsolutions.mintlify.site/_mintlify/api/og/v2?division=Chats\u0026amp;title=Move+a+session+into+another+chat%2C+or+start+a+fresh+one\u0026amp;description=Sets+which+chat+the+session%27s+prompts+go+to.+Name+a+%60chatId%60+from+%60listChats%60%0Ato+carry+on+that+conversation+%E2%80%94+the+agent+picks+it+up+with+its+history.%0AOmit+%60chat\u0026amp;theme=78d8ed9f672a237868c29fac\u0026amp;signature=dc5f71adba8c1e9644a4277ba37d7943c33812d45833d3af6d9f820940cfcc50\">\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/celedonsolutions/oDVafbys7dzUhWoI/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Davinci\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7e57c2\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.davinci-app.com/api-reference/chats/move-a-session-into-another-chat-or-start-a-fresh-one\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/chats/move-a-session-into-another-chat-or-start-a-fresh-one.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.davinci-app.com/#organization\",\"name\":\"Davinci\",\"url\":\"https://docs.davinci-app.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/celedonsolutions/Jrllsva0Wnxsp6y9/logo/logo_small_bright.svg?fit=max\u0026auto=format\u0026n=Jrllsva0Wnxsp6y9\u0026q=85\u0026s=41189259a1bfc87c7f7cf8cf9f61193b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.davinci-app.com#website\",\"name\":\"Davinci\",\"url\":\"https://docs.davinci-app.com\",\"publisher\":{\"@id\":\"https://docs.davinci-app.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.davinci-app.com/api-reference/chats/move-a-session-into-another-chat-or-start-a-fresh-one#webpage\",\"url\":\"https://docs.davinci-app.com/api-reference/chats/move-a-session-into-another-chat-or-start-a-fresh-one\",\"name\":\"Move a session into another chat, or start a fresh one\",\"description\":\"Sets which chat the session's prompts go to. Name a chatId from listChats to carry on that conversation — the agent picks it up with its history. Omit chatId, or send null, to start a fresh chat; like a new session's first chat, it is only stored once you send something in it. A run in the session's previous chat keeps going to the end, and that chat stays in your list if anything was said in it. Read its messages to follow the run, or switch back to carry on in it. Closing the session stops every run it has going. A chat belongs to one session at a time. If another of your sessions is in the chat you name, or left a run going there, this session takes it over: the other session's run in it is stopped, and if it was in that chat it continues in a fresh one. Its ids are returned in takenOverFrom. Your API chats also appear in the web app, where you can watch a session work and take a chat over. The session's run there stops, and its prompts to that chat answer 409 CHAT_TAKEN_OVER until a session reopens the chat here. Reopening takes it back from the web app, including when it is the chat the session is already in. A chat with a run going in the web app cannot be opened or reopened until that run ends; the switch answers 409 CHAT_IN_USE and changes nothing. Otherwise, naming the chat the session is already in changes nothing.\",\"dateModified\":\"2026-11-18T18:41:42.248Z\",\"isPartOf\":{\"@id\":\"https://docs.davinci-app.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.davinci-app.com/api-reference/chats/move-a-session-into-another-chat-or-start-a-fresh-one#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.davinci-app.com/api-reference/chats/move-a-session-into-another-chat-or-start-a-fresh-one#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Developer API\",\"item\":\"https://docs.davinci-app.com/pages/api/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API Reference\",\"item\":\"https://docs.davinci-app.com/api-reference/agentmodels/list-available-agent-models\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Move a session into another chat, or start a fresh one\",\"item\":\"https://docs.davinci-app.com/api-reference/chats/move-a-session-into-another-chat-or-start-a-fresh-one\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.davinci-app.com/api-reference/chats/move-a-session-into-another-chat-or-start-a-fresh-one#apireference\",\"headline\":\"Move a session into another chat, or start a fresh one\",\"name\":\"Move a session into another chat, or start a fresh one\",\"description\":\"Sets which chat the session's prompts go to. Name a chatId from listChats to carry on that conversation — the agent picks it up with its history. Omit chatId, or send null, to start a fresh chat; like a new session's first chat, it is only stored once you send something in it. A run in the session's previous chat keeps going to the end, and that chat stays in your list if anything was said in it. Read its messages to follow the run, or switch back to carry on in it. Closing the session stops every run it has going. A chat belongs to one session at a time. If another of your sessions is in the chat you name, or left a run going there, this session takes it over: the other session's run in it is stopped, and if it was in that chat it continues in a fresh one. Its ids are returned in takenOverFrom. Your API chats also appear in the web app, where you can watch a session work and take a chat over. The session's run there stops, and its prompts to that chat answer 409 CHAT_TAKEN_OVER until a session reopens the chat here. Reopening takes it back from the web app, including when it is the chat the session is already in. A chat with a run going in the web app cannot be opened or reopened until that run ends; the switch answers 409 CHAT_IN_USE and changes nothing. Otherwise, naming the chat the session is already in changes nothing.\",\"url\":\"https://docs.davinci-app.com/api-reference/chats/move-a-session-into-another-chat-or-start-a-fresh-one\",\"mainEntityOfPage\":{\"@id\":\"https://docs.davinci-app.com/api-reference/chats/move-a-session-into-another-chat-or-start-a-fresh-one#webpage\"},\"dateModified\":\"2026-11-18T18:41:42.248Z\",\"publisher\":{\"@id\":\"https://docs.davinci-app.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.davinci-app.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Davinci\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Davinci\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/chats/move-a-session-into-another-chat-or-start-a-fresh-one.md","siteName":"Davinci","nav":{"global":null,"groups":[{"group":"Getting Started","icon":"rocket","pages":[{"title":"Welcome to Davinci","href":"/pages/getting-started/introduction"},{"title":"Quickstart","href":"/pages/getting-started/quickstart"},{"title":"Sign Up For Davinci","href":"/pages/getting-started/signup"},{"title":"Individual Plans","href":"/pages/getting-started/plans"},{"title":"Key Concepts","href":"/pages/getting-started/key-concepts"},{"title":"Common FAQs","href":"/pages/getting-started/faq"}]},{"group":"Davinci Browser","icon":"globe","pages":[{"title":"Browser Overview","href":"/pages/browser/overview"},{"title":"Browser Navigation","href":"/pages/browser/navigation"},{"title":"Projects","href":"/pages/browser/projects"},{"title":"Organizations","href":"/pages/browser/organizations"},{"title":"Teams","href":"/pages/browser/teams"},{"title":"Groups","href":"/pages/browser/groups"},{"title":"Roles And Permissions","href":"/pages/browser/roles-permissions"},{"title":"User Account","href":"/pages/browser/account"},{"title":"Notifications","href":"/pages/browser/notifications"},{"group":"Usage, Plans, And Billing","pages":[{"title":"Usage, Plans, And Billing","href":"/pages/browser/usage-plans-billing/overview"},{"title":"Change An Individual Plan","href":"/pages/browser/usage-plans-billing/change-individual-plan"},{"title":"Add An Organization","href":"/pages/browser/usage-plans-billing/add-organization"},{"title":"Upgrade To A Group","href":"/pages/browser/usage-plans-billing/upgrade-to-group"},{"title":"Cancel Or Unsubscribe","href":"/pages/browser/usage-plans-billing/cancel-or-unsubscribe"}]}]},{"group":"Davinci Editor","icon":"pen-ruler","pages":[{"title":"Editor Overview","href":"/pages/editor/overview"},{"title":"Editor","href":"/pages/editor/interface"},{"title":"Model Area","href":"/pages/editor/model-area"},{"group":"Panels","pages":[{"title":"Left Panel","href":"/pages/editor/panels/left-panel"},{"title":"Right Panel","href":"/pages/editor/panels/right-panel"}]},{"group":"Widgets","pages":[{"title":"Widgets","href":"/pages/editor/widgets/overview"},{"title":"Model","href":"/pages/editor/widgets/model"},{"title":"Skills \u0026 Rules","tag":"New","href":"/pages/editor/widgets/skills-rules"},{"title":"Davinci Agent","href":"/pages/editor/widgets/agent-chat"},{"title":"Source Control","href":"/pages/editor/widgets/source-control"},{"title":"Search","href":"/pages/editor/widgets/search"},{"title":"Comments","href":"/pages/editor/widgets/comments"},{"title":"Validation","href":"/pages/editor/widgets/validation"},{"title":"Terminal","href":"/pages/editor/widgets/terminal"}]},{"title":"Hotkeys","href":"/pages/editor/hotkeys"},{"title":"Modeling Basics","href":"/pages/editor/modeling-basics"},{"group":"Project Settings","pages":[{"title":"Summary","href":"/pages/editor/project-settings/project"},{"title":"Files \u0026 File Storage","href":"/pages/editor/project-settings/files"},{"title":"Toolboxes","href":"/pages/editor/project-settings/toolboxes"},{"title":"Units","href":"/pages/editor/project-settings/unit-settings"},{"title":"Schema","href":"/pages/editor/project-settings/relationship-settings"},{"title":"Secrets","href":"/pages/editor/project-settings/secrets"},{"title":"Dependencies","href":"/pages/editor/project-settings/dependencies"},{"title":"Tags","href":"/pages/editor/project-settings/tags"},{"title":"Risk Categories","href":"/pages/editor/project-settings/risk"},{"title":"Persona Settings","href":"/pages/editor/project-settings/persona-settings"},{"title":"MCP Configuration","href":"/pages/editor/project-settings/mcp"}]},{"group":"Collaboration In The Editor","pages":[{"title":"Collaboration Overview","href":"/pages/editor/collaboration/overview"},{"title":"Real-Time Editing","href":"/pages/editor/collaboration/real-time-editing"},{"title":"Object Locking","href":"/pages/editor/collaboration/object-locking"}]},{"title":"Files And References","href":"/pages/editor/files-and-references"},{"title":"Pages","href":"/pages/editor/pages"},{"group":"AI Agent","pages":[{"title":"Workspaces","href":"/pages/editor/agent/workspaces"},{"title":"Agent Guide","href":"/pages/editor/agent/agents"},{"title":"Personas \u0026 Background","href":"/pages/editor/agent/persona"},{"title":"Planning","tag":"New","href":"/pages/editor/agent/planning"},{"title":"Agent Tools","href":"/pages/editor/agent/agent-tools"},{"title":"Tips","href":"/pages/editor/agent/tips"}]},{"title":"Exports","href":"/pages/editor/exports"}]},{"group":"Integrations","icon":"plug","pages":[{"title":"Integrations Overview","href":"/pages/integrations/overview"},{"title":"Onshape Integration","tag":"In Testing","hidden":true,"href":"/pages/integrations/onshape"}]},{"group":"Modeling Guide","icon":"cube","pages":[{"group":"Overview","pages":[{"title":"Introduction","href":"/pages/modeling/overview/systemmodeling"},{"title":"System Modeling Language","href":"/pages/modeling/overview/language"},{"title":"The @ System","href":"/pages/modeling/overview/mentions"},{"title":"SysML v1.x Import","href":"/pages/modeling/overview/imports"},{"title":"SysML v2 Export","href":"/pages/modeling/overview/sysml-export"}]},{"group":"Common","pages":[{"title":"Equations","href":"/pages/modeling/common/equations"},{"title":"Relationships","href":"/pages/modeling/common/relationships"},{"title":"Object Inheritance","href":"/pages/modeling/common/inheritance"},{"title":"Project Subclasses","href":"/pages/modeling/common/subclasses"},{"title":"Units","href":"/pages/modeling/common/units"}]},{"group":"Scripts","pages":[{"title":"Python Database API","href":"/pages/modeling/python-database-api"}]},{"group":"Object Views","pages":[{"title":"Activity View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/activity-icon.png","href":"/pages/user-guide/views/activity"},{"title":"Artifact View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/artifact-icon.png","href":"/pages/user-guide/views/artifact"},{"title":"Block View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/block-icon.png","href":"/pages/user-guide/views/block"},{"title":"Code View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/code-icon.png","href":"/pages/user-guide/views/code"},{"title":"Connectome View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/connectome-icon.png","href":"/pages/user-guide/views/connectome"},{"title":"Dependency Graph View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/dependency-icon.svg","href":"/pages/user-guide/views/dependency-graph"},{"title":"Design Space Explorer","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/design-space-icon.png","href":"/pages/user-guide/views/design-space-explorer"},{"title":"Digital Thread View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/digital-thread-icon.png","href":"/pages/user-guide/views/digital-thread"},{"title":"Gantt View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/gantt-icon.png","href":"/pages/user-guide/views/gantt"},{"title":"Geometric View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/geometry.svg","hidden":true,"href":"/pages/user-guide/views/geometric"},{"title":"Geometry View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/geometry.svg","hidden":true,"href":"/pages/user-guide/views/geometry"},{"title":"Help View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/help-icon.png","href":"/pages/user-guide/views/help"},{"title":"History View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/history-icon.png","href":"/pages/user-guide/views/history"},{"title":"Jupyter Notebooks","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/code-icon.png","href":"/pages/user-guide/views/notebooks"},{"title":"Package View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/package-icon.png","href":"/pages/user-guide/views/package"},{"title":"Pie Chart View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/pie-icon.png","href":"/pages/user-guide/views/pie"},{"title":"Plot View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/plot-icon.png","href":"/pages/user-guide/views/plot"},{"title":"Properties View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/properties-icon.png","href":"/pages/user-guide/views/properties"},{"title":"Reference View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/reference-icon.png","href":"/pages/user-guide/views/reference"},{"title":"Review View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/review-icon.svg","href":"/pages/user-guide/views/review"},{"title":"Risk View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/risk-icon.png","href":"/pages/user-guide/views/risk"},{"title":"Rollup View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/tree-icon.png","href":"/pages/user-guide/views/rollup"},{"title":"Sequence View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/sequence-icon.png","href":"/pages/user-guide/views/sequence"},{"title":"Simulation View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/simulation.svg","href":"/pages/user-guide/views/simulation"},{"title":"Slide View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/slide-view-icon.png","href":"/pages/user-guide/views/slide"},{"title":"State View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/state-icon.png","href":"/pages/user-guide/views/state"},{"title":"Table View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/table-icon.png","href":"/pages/user-guide/views/table"},{"title":"Toolbox View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/toolbox-icon.png","href":"/pages/user-guide/views/toolbox"},{"title":"Tree View","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/tree-icon.png","href":"/pages/user-guide/views/tree"}]},{"group":"Object Types","pages":[{"title":"Schema","href":"/pages/modeling/objects/objects"},{"group":"Structure","pages":[{"title":"Parts","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/part.svg","href":"/pages/modeling/objects/parts"},{"title":"Packages","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/package.svg","href":"/pages/modeling/objects/packages"},{"title":"Entities","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/entity.svg","href":"/pages/modeling/objects/entities"},{"title":"Requirements","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/requirement.svg","href":"/pages/modeling/objects/requirements"},{"title":"Tests","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/test.svg","href":"/pages/modeling/objects/tests"},{"title":"Capability","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/capability.svg","href":"/pages/modeling/objects/capability"},{"title":"Linkages","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/linkage.svg","href":"/pages/modeling/objects/linkages"}]},{"group":"Values","pages":[{"title":"Attributes","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/attribute.svg","href":"/pages/modeling/objects/attributes"},{"title":"Constraints","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/constraint.svg","href":"/pages/modeling/objects/constraints"},{"title":"Resource","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/resource.svg","href":"/pages/modeling/objects/resource"},{"title":"Risk","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/risk.svg","href":"/pages/modeling/objects/risk"}]},{"group":"Artifacts","pages":[{"title":"Documents","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/document.svg","href":"/pages/modeling/objects/documents"},{"title":"Tables","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/table.svg","href":"/pages/modeling/objects/tables"},{"title":"Matrix","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/matrix.svg","href":"/pages/modeling/objects/matrix"},{"title":"Figures","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/figure.svg","href":"/pages/modeling/objects/figure"},{"title":"Slides","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/slide.svg","href":"/pages/modeling/objects/slide"}]},{"group":"Behavior","pages":[{"title":"Actions","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/action.svg","href":"/pages/modeling/objects/actions"},{"title":"State","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/state.svg","href":"/pages/modeling/objects/states"},{"title":"Transition","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/transition.svg","href":"/pages/modeling/objects/transitions"},{"title":"Tasks","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/task.svg","href":"/pages/modeling/objects/task"}]},{"group":"Interface","pages":[{"title":"Ports","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/port.svg","href":"/pages/modeling/objects/ports"},{"title":"Interfaces","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/interface.svg","href":"/pages/modeling/objects/interface"},{"title":"Item","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/item.svg","href":"/pages/modeling/objects/item"}]},{"group":"Analysis","pages":[{"title":"Code","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/code.svg","href":"/pages/modeling/objects/code"},{"title":"Toolbox","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/toolbox.svg","href":"/pages/modeling/objects/toolbox"},{"title":"Trade Study","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/study.svg","href":"/pages/modeling/objects/trade"}]},{"group":"CAD","pages":[{"title":"Geometry","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/geometry.svg","hidden":true,"href":"/pages/modeling/objects/geometry"},{"title":"Assembly","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/assembly.svg","hidden":true,"href":"/pages/modeling/objects/assembly"}]},{"group":"Reference","pages":[{"title":"Reference","icon":"https://mintlify.s3.us-west-1.amazonaws.com/celedonsolutions/images/objecticons/reference.svg","href":"/pages/modeling/objects/reference"}]}]}]},{"group":"Administration","icon":"shield-halved","pages":[{"title":"Administration Overview","href":"/pages/admin/overview"},{"group":"Users And Resources","pages":[{"title":"Users, Entitlements, And Access","href":"/pages/admin/user-access"},{"title":"Groups And Entitlements","href":"/pages/admin/groups-and-entitlements"},{"title":"Projects, Organizations, And Tenants","href":"/pages/admin/resources-and-tenants"}]},{"group":"Platform Management","pages":[{"title":"Usage And Costs","href":"/pages/admin/usage-and-billing"},{"title":"System Settings And Authentication","href":"/pages/admin/system-settings-authentication"},{"title":"Operations And Communications","href":"/pages/admin/operations"}]},{"group":"LLM Control Plane","pages":[{"title":"LLM Control Plane","href":"/pages/admin/llm-control-plane"},{"title":"Choosing Models","mode":"wide","href":"/pages/admin/llm-model-guide"},{"title":"LLM Provider Configuration","href":"/pages/admin/llm-provider-configuration"},{"title":"LLM Model Offering Configuration","href":"/pages/admin/llm-offering-configuration"}]}]},{"group":"Developer API","icon":"code","pages":[{"group":"API Guides","pages":[{"title":"Introduction","href":"/pages/api/introduction"},{"title":"Personal Access Tokens","href":"/pages/api/personal-access-tokens"}]},{"group":"API Reference","icon":"folder-tree","pages":[{"group":"AgentModels","pages":[{"title":"List available agent models","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/agent/models","href":"/api-reference/agentmodels/list-available-agent-models"}]},{"group":"Projects","pages":[{"title":"List accessible projects","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects","href":"/api-reference/projects/list-accessible-projects"},{"title":"Create a project","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/projects","href":"/api-reference/projects/create-a-project"},{"title":"Get project metadata","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}","href":"/api-reference/projects/get-project-metadata"},{"title":"Delete a project","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml delete /api/v2/projects/{projectId}","href":"/api-reference/projects/delete-a-project"},{"title":"Update project metadata","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml patch /api/v2/projects/{projectId}","href":"/api-reference/projects/update-project-metadata"},{"title":"Open a project","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/projects/{projectId}/open","href":"/api-reference/projects/open-a-project"},{"title":"Close a project","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/projects/{projectId}/close","href":"/api-reference/projects/close-a-project"},{"title":"List project branches","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/branches","href":"/api-reference/projects/list-project-branches"},{"title":"List public packages","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/packages","href":"/api-reference/projects/list-public-packages"},{"title":"List personas","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/personas","href":"/api-reference/projects/list-personas"},{"title":"List attached files","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/files","href":"/api-reference/projects/list-attached-files"},{"title":"Delete an attached file","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml delete /api/v2/projects/{projectId}/files/{fileId}","href":"/api-reference/projects/delete-an-attached-file"},{"title":"Download an attached file","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/files/{fileId}/content","href":"/api-reference/projects/download-an-attached-file"}]},{"group":"Branches","pages":[{"title":"Create a branch","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/projects/{projectId}/branches","href":"/api-reference/branches/create-a-branch"},{"title":"Delete a branch","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml delete /api/v2/projects/{projectId}/branches/{branch}","href":"/api-reference/branches/delete-a-branch"},{"title":"Commit a branch","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/projects/{projectId}/branches/{branch}/commits","href":"/api-reference/branches/commit-a-branch"},{"title":"Read uncommitted changes","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/branches/{branch}/changes","href":"/api-reference/branches/read-uncommitted-changes"},{"title":"Read an object's commit history","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/objects/{objectId}/history","href":"/api-reference/branches/read-an-objects-commit-history"}]},{"group":"Content","pages":[{"title":"Read the object tree","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/tree","href":"/api-reference/content/read-the-object-tree"},{"title":"Add objects","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/projects/{projectId}/objects","href":"/api-reference/content/add-objects"},{"title":"Read an object","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/objects/{objectId}","href":"/api-reference/content/read-an-object"},{"title":"Delete an object","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml delete /api/v2/projects/{projectId}/objects/{objectId}","href":"/api-reference/content/delete-an-object"},{"title":"Export an object to a file","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/projects/{projectId}/objects/{objectId}/exports","href":"/api-reference/content/export-an-object-to-a-file"}]},{"group":"Sessions","pages":[{"title":"Open a session and mint a data-plane grant","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/projects/{projectId}/sessions","href":"/api-reference/sessions/open-a-session-and-mint-a-data-plane-grant"},{"title":"Read a session, refresh its grant, and check the agent","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/sessions/{sessionId}","href":"/api-reference/sessions/read-a-session-refresh-its-grant-and-check-the-agent"},{"title":"Close a session","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml delete /api/v2/projects/{projectId}/sessions/{sessionId}","href":"/api-reference/sessions/close-a-session"},{"title":"Read the session's conversation","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/sessions/{sessionId}/messages","href":"/api-reference/sessions/read-the-sessions-conversation"},{"title":"Send a prompt to the session's agent","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/projects/{projectId}/sessions/{sessionId}/messages","href":"/api-reference/sessions/send-a-prompt-to-the-sessions-agent"},{"title":"Stop the agent without closing the session","description":"Halts the run in the session's current chat, or in the chat named by `chatId`.\nThe session survives, the project stays open, and the conversation so far is\nkept — so you can send a new prompt afterwards without starting over. Runs in\nthe session's other chats carry on. Use `deleteSession` when you actually want\nto finish; that stops all of them.\n\nStopping when nothing is running is not an error; `stopped` is `false` and the\nstatus is whatever it already was. That makes this safe to call defensively,\nfor instance when abandoning a run you may or may not have started.\n","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/projects/{projectId}/sessions/{sessionId}/stop","href":"/api-reference/sessions/stop-the-agent-without-closing-the-session"}]},{"group":"Chats","pages":[{"title":"Move a session into another chat, or start a fresh one","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml put /api/v2/projects/{projectId}/sessions/{sessionId}/chat","href":"/api-reference/chats/move-a-session-into-another-chat-or-start-a-fresh-one"},{"title":"List your chats in a project","description":"Your API chats in the project, most recently active first. Only chats in\nwhich something was sent are listed — a session's fresh chat appears once\nits first message is.\n\nChats are per user: a collaborator on the same project has their own.\n","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/chats","href":"/api-reference/chats/list-your-chats-in-a-project"},{"title":"Delete a chat","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml delete /api/v2/projects/{projectId}/chats/{chatId}","href":"/api-reference/chats/delete-a-chat"},{"title":"Rename a chat","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml patch /api/v2/projects/{projectId}/chats/{chatId}","href":"/api-reference/chats/rename-a-chat"},{"title":"Read a chat's conversation","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/chats/{chatId}/messages","href":"/api-reference/chats/read-a-chats-conversation"},{"title":"Fetch an image sent with a prompt","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/chats/{chatId}/messages/{messageId}/images/{index}","href":"/api-reference/chats/fetch-an-image-sent-with-a-prompt"}]},{"group":"Tools","pages":[{"title":"Invoke one of the agent's tools directly","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/projects/{projectId}/sessions/{sessionId}/tools/invoke","href":"/api-reference/tools/invoke-one-of-the-agents-tools-directly"}]},{"group":"Usage","pages":[{"title":"What you spent","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/usage","href":"/api-reference/usage/what-you-spent"},{"title":"What you spent on one project","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/usage","href":"/api-reference/usage/what-you-spent-on-one-project"},{"title":"What one session spent","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/sessions/{sessionId}/usage","href":"/api-reference/usage/what-one-session-spent"}]},{"group":"Files","pages":[{"title":"Upload a file to a project","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v1/file/upload/{ownerId}/{userId}/{projectId}/{connectionId}/{parentId}","href":"/api-reference/files/upload-a-file-to-a-project"},{"title":"Download a file from a project","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v1/file/download/{ownerId}/{projectId}/{fileName}","href":"/api-reference/files/download-a-file-from-a-project"}]},{"group":"Evaluations","pages":[{"title":"Create an ephemeral evaluation sandbox","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/evaluation-runs","href":"/api-reference/evaluations/create-an-ephemeral-evaluation-sandbox"},{"title":"Get an evaluation sandbox run","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/evaluation-runs/{runId}","href":"/api-reference/evaluations/get-an-evaluation-sandbox-run"},{"title":"Clean up an evaluation sandbox","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml delete /api/v2/evaluation-runs/{runId}","href":"/api-reference/evaluations/clean-up-an-evaluation-sandbox"}]},{"group":"Tests","pages":[{"title":"Start an authored Test asynchronously","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/projects/{projectId}/tests/{testId}/runs","href":"/api-reference/tests/start-an-authored-test-asynchronously"},{"title":"Get Test-run status and evidence","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/tests/{testId}/runs/{runId}","href":"/api-reference/tests/get-test-run-status-and-evidence"},{"title":"Cancel a Test run","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml delete /api/v2/projects/{projectId}/tests/{testId}/runs/{runId}","href":"/api-reference/tests/cancel-a-test-run"}]},{"group":"Organizations","pages":[{"title":"List accessible organizations","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/orgs","href":"/api-reference/organizations/list-accessible-organizations"}]},{"group":"Cards","pages":[{"title":"List cards assigned to you across projects","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/users/me/cards","href":"/api-reference/cards/list-cards-assigned-to-you-across-projects"},{"title":"Search project cards","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/cards","href":"/api-reference/cards/search-project-cards"},{"title":"Create a card","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/projects/{projectId}/cards","href":"/api-reference/cards/create-a-card"},{"title":"Get project card filter options","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/cards/filter-options","href":"/api-reference/cards/get-project-card-filter-options"},{"title":"List cards related to seed cards","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/cards/related","href":"/api-reference/cards/list-cards-related-to-seed-cards"},{"title":"List users assignable to project cards","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/cards/assignable-members","href":"/api-reference/cards/list-users-assignable-to-project-cards"},{"title":"Get a card","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/cards/{cardId}","href":"/api-reference/cards/get-a-card"},{"title":"Delete a card","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml delete /api/v2/projects/{projectId}/cards/{cardId}","href":"/api-reference/cards/delete-a-card"},{"title":"Update a card","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml patch /api/v2/projects/{projectId}/cards/{cardId}","href":"/api-reference/cards/update-a-card"},{"title":"Get card details","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/cards/{cardId}/details","href":"/api-reference/cards/get-card-details"},{"title":"List card history","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/cards/{cardId}/history","href":"/api-reference/cards/list-card-history"},{"title":"List card comments","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/cards/{cardId}/comments","href":"/api-reference/cards/list-card-comments"},{"title":"Add a card comment","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/projects/{projectId}/cards/{cardId}/comments","href":"/api-reference/cards/add-a-card-comment"},{"title":"Delete a card comment","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml delete /api/v2/projects/{projectId}/cards/{cardId}/comments/{commentId}","href":"/api-reference/cards/delete-a-card-comment"},{"title":"Edit a card comment","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml patch /api/v2/projects/{projectId}/cards/{cardId}/comments/{commentId}","href":"/api-reference/cards/edit-a-card-comment"},{"title":"Replace all tags on a card","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml put /api/v2/projects/{projectId}/cards/{cardId}/tags","href":"/api-reference/cards/replace-all-tags-on-a-card"},{"title":"Add a tag to a card","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/projects/{projectId}/cards/{cardId}/tags","href":"/api-reference/cards/add-a-tag-to-a-card"},{"title":"Remove a tag from a card","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml delete /api/v2/projects/{projectId}/cards/{cardId}/tags/{tagId}","href":"/api-reference/cards/remove-a-tag-from-a-card"},{"title":"Link a user to a card","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/projects/{projectId}/cards/{cardId}/user-links","href":"/api-reference/cards/link-a-user-to-a-card"},{"title":"Remove a user link from a card","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml delete /api/v2/projects/{projectId}/cards/{cardId}/user-links/{linkId}","href":"/api-reference/cards/remove-a-user-link-from-a-card"},{"title":"Link two cards","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/projects/{projectId}/cards/{cardId}/card-links","href":"/api-reference/cards/link-two-cards"},{"title":"Remove a card-to-card link","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml delete /api/v2/projects/{projectId}/cards/{cardId}/card-links/{linkId}","href":"/api-reference/cards/remove-a-card-to-card-link"},{"title":"Link a design object to a card","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/projects/{projectId}/cards/{cardId}/object-links","href":"/api-reference/cards/link-a-design-object-to-a-card"},{"title":"Remove a design-object link","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml delete /api/v2/projects/{projectId}/cards/{cardId}/object-links/{linkId}","href":"/api-reference/cards/remove-a-design-object-link"},{"title":"List the project's card-tag catalog","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/projects/{projectId}/card-tags","href":"/api-reference/cards/list-the-projects-card-tag-catalog"},{"title":"Create a card tag","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/projects/{projectId}/card-tags","href":"/api-reference/cards/create-a-card-tag"},{"title":"Delete a card tag","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml delete /api/v2/projects/{projectId}/card-tags/{tagId}","href":"/api-reference/cards/delete-a-card-tag"},{"title":"Update a card tag","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml patch /api/v2/projects/{projectId}/card-tags/{tagId}","href":"/api-reference/cards/update-a-card-tag"}]},{"group":"Teams","pages":[{"title":"List visible teams","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/orgs/{orgId}/teams","href":"/api-reference/teams/list-visible-teams"},{"title":"Create a team","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/orgs/{orgId}/teams","href":"/api-reference/teams/create-a-team"},{"title":"Get a team","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/orgs/{orgId}/teams/{teamId}","href":"/api-reference/teams/get-a-team"},{"title":"Delete a team","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml delete /api/v2/orgs/{orgId}/teams/{teamId}","href":"/api-reference/teams/delete-a-team"},{"title":"Update a team","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml patch /api/v2/orgs/{orgId}/teams/{teamId}","href":"/api-reference/teams/update-a-team"},{"title":"Get the team board index","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/orgs/{orgId}/teams/{teamId}/index","href":"/api-reference/teams/get-the-team-board-index"},{"title":"Get active team planning work","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/orgs/{orgId}/teams/{teamId}/overview","href":"/api-reference/teams/get-active-team-planning-work"},{"title":"Get the team reports summary","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/orgs/{orgId}/teams/{teamId}/reports","href":"/api-reference/teams/get-the-team-reports-summary"},{"title":"Get team analytics","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/orgs/{orgId}/teams/{teamId}/charts","href":"/api-reference/teams/get-team-analytics"},{"title":"List projects linked to a team","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/orgs/{orgId}/teams/{teamId}/projects","href":"/api-reference/teams/list-projects-linked-to-a-team"},{"title":"Link a project to a team","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/orgs/{orgId}/teams/{teamId}/projects","href":"/api-reference/teams/link-a-project-to-a-team"},{"title":"Unlink a project from a team","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml delete /api/v2/orgs/{orgId}/teams/{teamId}/projects/{projectId}","href":"/api-reference/teams/unlink-a-project-from-a-team"},{"title":"List team workflow statuses","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/orgs/{orgId}/teams/{teamId}/statuses","href":"/api-reference/teams/list-team-workflow-statuses"},{"title":"Create a workflow status","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/orgs/{orgId}/teams/{teamId}/statuses","href":"/api-reference/teams/create-a-workflow-status"},{"title":"Delete a workflow status","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml delete /api/v2/orgs/{orgId}/teams/{teamId}/statuses/{statusId}","href":"/api-reference/teams/delete-a-workflow-status"},{"title":"Update a workflow status","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml patch /api/v2/orgs/{orgId}/teams/{teamId}/statuses/{statusId}","href":"/api-reference/teams/update-a-workflow-status"},{"title":"Close every open card in a workflow status","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/orgs/{orgId}/teams/{teamId}/statuses/{statusId}/closures","href":"/api-reference/teams/close-every-open-card-in-a-workflow-status"},{"title":"Create a planned sprint","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/orgs/{orgId}/teams/{teamId}/sprints","href":"/api-reference/teams/create-a-planned-sprint"},{"title":"List completed team sprints","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/orgs/{orgId}/teams/{teamId}/sprints/completed","href":"/api-reference/teams/list-completed-team-sprints"},{"title":"Get a sprint","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/orgs/{orgId}/teams/{teamId}/sprints/{sprintId}","href":"/api-reference/teams/get-a-sprint"},{"title":"Delete a sprint","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml delete /api/v2/orgs/{orgId}/teams/{teamId}/sprints/{sprintId}","href":"/api-reference/teams/delete-a-sprint"},{"title":"Update sprint details","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml patch /api/v2/orgs/{orgId}/teams/{teamId}/sprints/{sprintId}","href":"/api-reference/teams/update-sprint-details"},{"title":"Start a planned sprint","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/orgs/{orgId}/teams/{teamId}/sprints/{sprintId}/start","href":"/api-reference/teams/start-a-planned-sprint"},{"title":"Complete an active sprint","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/orgs/{orgId}/teams/{teamId}/sprints/{sprintId}/complete","href":"/api-reference/teams/complete-an-active-sprint"},{"title":"Get sprint details","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/orgs/{orgId}/teams/{teamId}/sprints/{sprintId}/details","href":"/api-reference/teams/get-sprint-details"},{"title":"Get sprint burndown or burnup","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/orgs/{orgId}/teams/{teamId}/sprints/{sprintId}/charts","href":"/api-reference/teams/get-sprint-burndown-or-burnup"},{"title":"Search linked-Project Cards available to add","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/orgs/{orgId}/teams/{teamId}/available-cards","href":"/api-reference/teams/search-linked-project-cards-available-to-add"},{"title":"Atomically create and place a Project Card","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/orgs/{orgId}/teams/{teamId}/project-cards","href":"/api-reference/teams/atomically-create-and-place-a-project-card"},{"title":"List cards on a team board","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml get /api/v2/orgs/{orgId}/teams/{teamId}/cards","href":"/api-reference/teams/list-cards-on-a-team-board"},{"title":"Add a card to a team board","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml post /api/v2/orgs/{orgId}/teams/{teamId}/cards","href":"/api-reference/teams/add-a-card-to-a-team-board"},{"title":"Move a board card between sprints","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml patch /api/v2/orgs/{orgId}/teams/{teamId}/cards/{cardId}/sprint-link","href":"/api-reference/teams/move-a-board-card-between-sprints"},{"title":"Change a board card's workflow status","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml patch /api/v2/orgs/{orgId}/teams/{teamId}/cards/{cardId}/status","href":"/api-reference/teams/change-a-board-cards-workflow-status"},{"title":"Remove a card from a team board","deprecated":null,"version":null,"openapi":"/openapi/davinci-public.v2.yaml delete /api/v2/orgs/{orgId}/teams/{teamId}/cards/{cardId}","href":"/api-reference/teams/remove-a-card-from-a-team-board"}]}]}]},{"group":"Examples","icon":"book-sparkles","pages":[{"title":"Overview","href":"/examples/index"},{"title":"Systems Model from an OV-1","icon":"diagram-project","href":"/examples/OV1_example"},{"title":"Technical Decomposition from PDFs","icon":"file-lines","href":"/examples/Technical_Decomposition_Example"},{"title":"Requirements Management \u0026 Traceability","icon":"list-check","href":"/examples/Requirements_Management_Example"},{"title":"Document Generation with Templates","icon":"file-contract","href":"/examples/Document_Templates_Example"},{"title":"Organization Process Modeling","icon":"sitemap","href":"/examples/Organization_Process_Example"}]},{"group":"Release Notes","icon":"clock","pages":[{"title":"Version 5.3.5 - Document Cross-References \u0026 SVG Images","href":"/pages/release-notes/v5.3.5"},{"group":"Prior Versions","pages":[{"title":"Version 5.3.4 - Matrix Filters, Agent Commits \u0026 Performance","href":"/pages/release-notes/v5.3.4"},{"title":"Version 5.3.3 - Avatar Settings","href":"/pages/release-notes/v5.3.3"},{"title":"Version 5.3.2 - Default Personas, Slides \u0026 Performance","href":"/pages/release-notes/v5.3.2"},{"title":"Version 5.3.1 - Office Import, Notebooks \u0026 API Exports","href":"/pages/release-notes/v5.3.1"},{"title":"Version 5.3.0 - Reviews, Trade Studies \u0026 Schema Customization","href":"/pages/release-notes/v5.3.0"},{"title":"Version 5.2.8 - Reference Processing Fix","href":"/pages/release-notes/v5.2.8"},{"title":"Version 5.2.7 - Simulation Meshing Fixes","href":"/pages/release-notes/v5.2.7"},{"title":"Version 5.2.6 - Documents, Tables \u0026 SysML Diagrams","href":"/pages/release-notes/v5.2.6"},{"title":"Version 5.2.5 - Organization AI Funding \u0026 Matrix Sorting","href":"/pages/release-notes/v5.2.5"},{"title":"Version 5.2.4 - Slide Image Formatting","href":"/pages/release-notes/v5.2.4"},{"title":"Version 5.2.3 - Slide Export Fixes","href":"/pages/release-notes/v5.2.3"},{"title":"Version 5.2.2 - Explore Page Fix","href":"/pages/release-notes/v5.2.2"},{"title":"Version 5.2.1 - Sever Inheritance \u0026 Risk Equations","href":"/pages/release-notes/v5.2.1"},{"title":"Version 5.2.0 - Simulation, Engineering Workflows \u0026 Collaboration","href":"/pages/release-notes/v5.2.0"},{"title":"Version 5.1.7 - Workspace \u0026 Billing Reliability","href":"/pages/release-notes/v5.1.7"},{"title":"Version 5.1.6 - Task Card \u0026 Billing Fixes","href":"/pages/release-notes/v5.1.6"},{"title":"Version 5.1.5 - Design \u0026 Collaboration Updates","href":"/pages/release-notes/v5.1.5"},{"title":"Version 5.1.4 - Performance \u0026 Reliability","href":"/pages/release-notes/v5.1.4"},{"title":"Version 5.1.3 - Source Control View Patch","href":"/pages/release-notes/v5.1.3"},{"title":"Version 5.1.2 - Card Refinements","href":"/pages/release-notes/v5.1.2"},{"title":"Version 5.1.1 - Engineering Workflow Updates","href":"/pages/release-notes/v5.1.1"},{"title":"Version 5.1.0 - Task Cards, Teams \u0026 Sprints","href":"/pages/release-notes/v5.1.0"},{"title":"Version 5.0.0 - CAD, Circuits \u0026 Simulation","href":"/pages/release-notes/v5.0.0"},{"title":"Release Notes Archive","href":"/pages/release-notes/archive"}]}]},{"group":"Release Notes Archive","icon":"box-archive","hidden":true,"searchable":true,"pages":[{"title":"Version 4.6.0 - Figures, Inheritance \u0026 Test Modeling","href":"/pages/release-notes/v4.6.0"},{"title":"Version 4.5.3 - Directory Sign-In \u0026 Account Linking","href":"/pages/release-notes/v4.5.3"},{"title":"Version 4.5.2 - Maintenance Update","href":"/pages/release-notes/v4.5.2"},{"title":"Version 4.5.1 - Trial Teams \u0026 Team Billing","href":"/pages/release-notes/v4.5.1"},{"title":"Version 4.5.0 - Arrays, Callable Equations \u0026 Large File Workflows","href":"/pages/release-notes/v4.5.0"},{"title":"Version 4.4.0 - Skills, SysML Import \u0026 Richer Engineering Artifacts","href":"/pages/release-notes/v4.4.0"},{"title":"Version 4.3.2 - Editor \u0026 Settings Maintenance","href":"/pages/release-notes/v4.3.2"},{"title":"Version 4.3.1 - Document Editing Patch","href":"/pages/release-notes/v4.3.1"},{"title":"Version 4.3.0 - API, Model Review \u0026 Planning","href":"/pages/release-notes/v4.3.0"},{"title":"Version 4.2.20 - Permissions, Sessions \u0026 Billing Resilience","href":"/pages/release-notes/v4.2.20"},{"title":"Version 4.2.19 - Scratchpad Interaction Patch","href":"/pages/release-notes/v4.2.19"},{"title":"Version 4.2.18 - Invitations, Org Projects \u0026 Scratchpad Fixes","href":"/pages/release-notes/v4.2.18"},{"title":"Version 4.2.17 - Task \u0026 Reference Handling Fixes","href":"/pages/release-notes/v4.2.17"},{"title":"Version 4.2.16 - Scratchpad \u0026 Project Start Improvements","href":"/pages/release-notes/v4.2.16"},{"title":"Version 4.2.15 - Agent Planning Preview","href":"/pages/release-notes/v4.2.15"},{"title":"Version 4.2.14 - Image Metadata \u0026 Reliability","href":"/pages/release-notes/v4.2.14"},{"title":"Version 4.2.13 - Importer \u0026 Avatar Performance Fixes","href":"/pages/release-notes/v4.2.13"},{"title":"Version 4.2.12 - Reference Export Fixes","href":"/pages/release-notes/v4.2.12"},{"title":"Version 4.2.11 - Organization Administration","href":"/pages/release-notes/v4.2.11"},{"title":"Version 4.2.10 - Project Transfer Patch","href":"/pages/release-notes/v4.2.10"},{"title":"Version 4.2.9 - Post-Release Patch","href":"/pages/release-notes/v4.2.9"},{"title":"Version 4.2.8 - Air-Gapped Deployment Support","href":"/pages/release-notes/v4.2.8"},{"title":"Version 4.2.7 - Self-Hosted Administration","href":"/pages/release-notes/v4.2.7"},{"title":"Version 4.2.6 - Post-Release Patch","href":"/pages/release-notes/v4.2.6"},{"title":"Version 4.2.5 - Orgs \u0026 Public Project Fixes","href":"/pages/release-notes/v4.2.5"},{"title":"Version 4.2.4 - Post-Release Patch","href":"/pages/release-notes/v4.2.4"},{"title":"Version 4.2.3 - Business Metrics Update","href":"/pages/release-notes/v4.2.3"},{"title":"Version 4.2.2 - Platform Deployment Foundation","href":"/pages/release-notes/v4.2.2"},{"title":"Version 4.2.1 - Post-Release Bug Patch","href":"/pages/release-notes/v4.2.1"},{"title":"Version 4.2.0 - New Home Experience \u0026 Teams","href":"/pages/release-notes/v4.2.0"},{"title":"Version 4.1.11 - Post-Release Patch","href":"/pages/release-notes/v4.1.11"},{"title":"Version 4.1.10 - Post-Release Patch","href":"/pages/release-notes/v4.1.10"},{"title":"Version 4.1.9 - Post-Release Patch","href":"/pages/release-notes/v4.1.9"},{"title":"Version 4.1.8 - Post-Release Patch","href":"/pages/release-notes/v4.1.8"},{"title":"Version 4.1.7 - Post-Release Patch","href":"/pages/release-notes/v4.1.7"},{"title":"Version 4.1.6 - Routing Updates","href":"/pages/release-notes/v4.1.6"},{"title":"Version 4.1.5 - SysML Interoperability \u0026 Modeling Enhancements","href":"/pages/release-notes/v4.1.5"},{"title":"Version 4.1.4 - Smarter Agent Reading \u0026 Matrix Expansion","href":"/pages/release-notes/v4.1.4"},{"title":"Version 4.1.3 - Settings Rebuild \u0026 Sequence View Improvements","href":"/pages/release-notes/v4.1.3"},{"title":"Version 4.1.2 - System Reviews, Validation \u0026 Action Graphs","href":"/pages/release-notes/v4.1.2"},{"title":"Version 4.1.1 - Keyboard Shortcuts, Document Sections \u0026 MFA","href":"/pages/release-notes/v4.1.1"},{"title":"Version 4.1.0 - Programmatic API \u0026 Agent Overhaul","href":"/pages/release-notes/v4.1.0"},{"title":"Version 4.0.7 - Post-Release Bug Patch 7","href":"/pages/release-notes/v4.0.7"},{"title":"Version 4.0.6 - Post-Release Bug Patch 6","href":"/pages/release-notes/v4.0.6"},{"title":"Version 4.0.5 - Post-Release Bug Patch 5","href":"/pages/release-notes/v4.0.5"},{"title":"Version 4.0.4 - Post-Release Bug Patch 4","href":"/pages/release-notes/v4.0.4"},{"title":"Version 4.0.3 - Post-Release Bug Patch 3","href":"/pages/release-notes/v4.0.3"},{"title":"Version 4.0.2 - Post-Release Bug Patch 2","href":"/pages/release-notes/v4.0.2"},{"title":"Version 4.0.1 - Post-Release Bug Patch","href":"/pages/release-notes/v4.0.1"},{"title":"Version 4.0.0 - Major Systems Update","href":"/pages/release-notes/v4.0.0"},{"title":"Version 3.7.2 - Comments, Code and Chat Update","href":"/pages/release-notes/v3.7.2"},{"title":"Version 3.6.2 - Task, Resource and Risk Update","href":"/pages/release-notes/v3.6.2"},{"title":"Version 3.5.2 - Tags and Matrix Update","href":"/pages/release-notes/v3.5.2"},{"title":"Version 3.4.1 - Multimedia Update","href":"/pages/release-notes/v3.4.1"},{"title":"Version 3.3.0 - Multi-Workspace Redesign","href":"/pages/release-notes/v3.3.0"},{"title":"Version 3.2.0 - Markdown Support","href":"/pages/release-notes/v3.2.0"},{"title":"Version 3.1.0 - Agent Toolboxes","href":"/pages/release-notes/v3.1.0"},{"title":"Version 3.0.1 - Stability Release","href":"/pages/release-notes/v3.0.1"},{"title":"Version 3.0.0 - Agents","href":"/pages/release-notes/v3.0.0"},{"title":"Version 2.0.0 - Initial Public Release","href":"/pages/release-notes/v2.0.0"}]}]},"basePath":"","title":"Move a session into another chat, or start a fresh one - Davinci","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B6WFFOBL.js","utils-BN5um1KA.js","cloneDeep-C3md22mN.js","_Uint8Array-DLlL8L26.js","isObject-FP1Yky1u.js","utils-BSmbkXJR.js","addUniqueKeysToSchema-2tqcVnUE.js","snippetPresets-CtWfvr2J.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DkKHBy30.js","isEqual-O3q7y6pq.js","usePlaygroundInputsStore-Brc5H9UJ.js","shallow-C4L4xvbs.js","getApiPlaygroundDisplay-2bxyq_aI.js","CodeSnippet-BJu8ddd5.js","CodeSnippets-dazWmoqB.js","Page-CnLhKuUV.js","getPastedJson-Chy3Qa1S.js","icon-CyO7h3jh.js","MethodPill-Dle0_91v.js","DuplicateIcon-CVvWAf4a.js","createIcon-Di07A27B.js","DynamicMarkdown-C4w9kavL.js","SectionHeading-XiBebVYC.js","axios-vUo_bRtp.js","Markdown-DTeL0SpS.js","dist-OCScizqf.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-KcneGfMY.js"]}