import os
from davinci_sdk import DavinciClient
with DavinciClient(api_key=os.environ["DAVINCI_API_KEY"]) as client:
transcript = client.chats.messages(project_id, chat_id, limit=50)
for entry in transcript.messages:
print(entry.role, entry.kind, entry.text)
import { DavinciClient } from '@celedon/davinci-sdk';
const client = new DavinciClient({
apiKey: process.env.DAVINCI_API_KEY!,
});
const transcript = await client.chats.messages(projectId, chatId, { limit: 50 });
for (const entry of transcript.messages) {
console.log(entry.role, entry.kind, entry.text);
}
The transcript of any of your chats, whether or not a session is in it. The
shape matches listAgentMessages.
A chat one of your sessions is in is read from the running agent, so it is
current (source: live) and sessionId names that session. Any other chat
is read from its saved copy (source: persisted), which is complete because
nothing is running in it.
import os
from davinci_sdk import DavinciClient
with DavinciClient(api_key=os.environ["DAVINCI_API_KEY"]) as client:
transcript = client.chats.messages(project_id, chat_id, limit=50)
for entry in transcript.messages:
print(entry.role, entry.kind, entry.text)
import { DavinciClient } from '@celedon/davinci-sdk';
const client = new DavinciClient({
apiKey: process.env.DAVINCI_API_KEY!,
});
const transcript = await client.chats.messages(projectId, chatId, { limit: 50 });
for (const entry of transcript.messages) {
console.log(entry.role, entry.kind, entry.text);
}
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
chatId
string<uuid>
required
Chat id from listChats or a session's chatId.
Query Parameters
limit
integer
default:100
Most recent entries to return.
Required range: 1 <= x <= 500
Response
The conversation.
sessionId
string<uuid> | null
required
The session in this chat, when one is; null otherwise.
chatId
string<uuid>
required
taskId
string
required
source
enum<string>
required
Where the answer came from. live is the running agent's copy; persisted
is the saved copy; none means nothing has been said yet.
Available options:
live,
persisted,
none
status
enum<string>
required
no_session — the machine has no record of this session; it lapsed or the
project restarted. Create a new one.
project_not_running — the session is known but its project has unloaded.
idle — the session is live and no run has been started.
starting — a run is being set up.
running — a run is in progress.
paused — a run was stopped and can be continued with a new prompt.
completed — the run finished.
failed — the run ended in an error. agent.error says why, as does the
transcript.
unknown — the machine could not be reached for this field. Retry; anything
else in the same response is still valid.
paused, completed, and failed are terminal for a run.
Available options:
no_session,
project_not_running,
idle,
starting,
running,
paused,
completed,
failed,
unknown
entryCount
integer
required
Entries in the whole conversation, not just the returned window.
Required range: x >= 0
messages
object[]
required
Oldest first. Bounded by limit, taken from the end.
Hide child attributes
messages.index
integer
required
Position in the whole conversation, so a window can be placed.
Required range: x >= 0
messages.role
enum<string>
required
Available options:
user,
agent
messages.kind
string
required
text for what was said, thought for the agent's reasoning, tool for a
tool it used, error for a failure it hit. Treat an unrecognized value as
informational rather than as a problem — new kinds can appear.
messages.text
string
The content. For a tool entry, the tool's name.
messages.timestamp
integer | null
Milliseconds since the epoch.
messages.messageId
string
Present on your own prompts, matching what you sent.
messages.images
object[]
The images sent with one of your prompts, described rather than
included. Absent when the prompt had none.
Hide child attributes
messages.images.index
integer
required
Position among the prompt's images.
Required range: x >= 0
messages.images.mimeType
string
required
The format the model was given, after any downscaling.
messages.images.byteSize
integer
required
Size of the stored image in bytes.
Required range: x >= 0
messages.tool
object
Present only on entries whose kind is tool.
Hide child attributes
messages.tool.name
string | null
messages.tool.category
string | null
What kind of work the tool does, such as thinking for the agent's
reasoning, asking for a question to you, or editing. Treat an
unrecognized value as a general tool — new categories can appear.
messages.tool.status
string | null
working while it runs, complete when it succeeded, otherwise the severity
of what went wrong. A tool its run ended without finishing reads error.
messages.tool.params
any
The arguments the agent chose. Null when the tool takes none.
messages.tool.result
any
What the tool returned. Shape is the tool's own.
messages.tool.error
string
Present when the tool failed.
{"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/read-a-chats-conversation","slug":"/api-reference/chats/read-a-chats-conversation","pageMetadata":{"title":"Read a chat's conversation","description":"The transcript of any of your chats, whether or not a session is in it. The\nshape matches `listAgentMessages`.\n\nA chat one of your sessions is in is read from the running agent, so it is\ncurrent (`source: live`) and `sessionId` names that session. Any other chat\nis read from its saved copy (`source: persisted`), which is complete because\nnothing is running in it.\n","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","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: [\"The transcript of any of your chats, whether or not a session is in it. The\\nshape matches \", _jsx(_components.code, {\n children: \"listAgentMessages\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"A chat one of your sessions is in is read from the running agent, so it is\\ncurrent (\", _jsx(_components.code, {\n children: \"source: live\"\n }), \") and \", _jsx(_components.code, {\n children: \"sessionId\"\n }), \" names that session. Any other chat\\nis read from its saved copy (\", _jsx(_components.code, {\n children: \"source: persisted\"\n }), \"), which is complete because\\nnothing is running in it.\"]\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":"Read a chat's conversation","description":"The transcript of any of your chats, whether or not a session is in it. The\nshape matches `listAgentMessages`.\n\nA chat one of your sessions is in is read from the running agent, so it is\ncurrent (`source: live`) and `sessionId` names that session. Any other chat\nis read from its saved copy (`source: persisted`), which is complete because\nnothing is running in it.\n","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","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"listChatMessages","tags":["Chats"],"summary":"Read a chat's conversation","description":"The transcript of any of your chats, whether or not a session is in it. The\nshape matches `listAgentMessages`.\n\nA chat one of your sessions is in is read from the running agent, so it is\ncurrent (`source: live`) and `sessionId` names that session. Any other chat\nis read from its saved copy (`source: persisted`), which is complete because\nnothing is running in it.\n","security":["8428d7bb-503c-4d7c-97ac-a4c68fd25770"],"x-routing-server-source":"RoutingServer/agentChat/agentChat.routes.js","x-required-scopes":["projects:read"],"x-sdk-methods":{"typescript":"client.chats.messages","python":"client.chats.messages"},"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 transcript = await client.chats.messages(projectId, chatId, { limit: 50 });\nfor (const entry of transcript.messages) {\n console.log(entry.role, entry.kind, entry.text);\n}\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 transcript = client.chats.messages(project_id, chat_id, limit=50)\n for entry in transcript.messages:\n print(entry.role, entry.kind, entry.text)\n"}],"parameters":["ef8ec1be-61da-49a5-8e15-35ee9e45f8e3"],"responses":{"200":"63f9f81e-78f3-43b1-a631-6b429aac8f71","400":"d044f00d-bfc6-4e95-8e44-c5f565ff130f","401":"0a4c763b-0523-4c5e-87d3-263f260e18b9","403":"4540ef1f-cfac-4de1-8ac2-e284e13b7833","404":"ffe54f08-618c-40d2-a91e-d22716a9cfdf","429":"8b464bf0-89f4-4adf-988b-57e730da208e","500":"900070f1-524c-4563-8484-bbebdefd8c78"},"method":"get","type":"path","servers":["f440d231-e623-4563-8ff3-a41b6569a8c2","9e35f479-c3b2-4a87-8a2a-335ecab35020"],"path":"/api/v2/projects/{projectId}/chats/{chatId}/messages","baseUrlOptions":["https://davinci-app.com","https://davinci-app.com/data"],"title":"Read a chat's conversation","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 transcript = await client.chats.messages(projectId, chatId, { limit: 50 });\nfor (const entry of transcript.messages) {\n console.log(entry.role, entry.kind, entry.text);\n}\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 transcript = client.chats.messages(project_id, chat_id, limit=50)\n for entry in transcript.messages:\n print(entry.role, entry.kind, entry.text)\n"}],"requestExampleLanguages":["bash","python","typescript","javascript"],"requiredOnlyExamples":true,"requestExampleType":"codeSamples","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[],"urlDisplay":"full"},"dependencies":{"parameters":{"ef8ec1be-61da-49a5-8e15-35ee9e45f8e3":{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":100,"isRequired":false,"description":"Most recent entries to return.","uniqueKey":"","typeLabel":"integer"},"description":"Most recent entries to return."},"093b5eaa-50bd-40b0-979c-733005b596cd":{"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}`."},"83bbebe2-7554-4b14-9c82-9ba85d5d1aac":{"name":"chatId","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"description":"Chat id from `listChats` or a session's `chatId`.","uniqueKey":"","typeLabel":"string\u003cuuid>"},"description":"Chat id from `listChats` or a session's `chatId`."}},"responses":{"63f9f81e-78f3-43b1-a631-6b429aac8f71":{"description":"The conversation.","content":{"application/json":{"schema":{"type":"object","required":["sessionId","chatId","taskId","source","status","entryCount","messages"],"properties":{"sessionId":{"oneOf":[{"type":"string","format":"uuid","description":"The session in this chat, when one is; null otherwise.","isRequired":true,"uniqueKey":"sessionId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"The session in this chat, when one is; null otherwise.","isRequired":true,"uniqueKey":"sessionId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sessionId","typeLabel":"string\u003cuuid> | null"},"chatId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"chatId","typeLabel":"string\u003cuuid>"},"taskId":{"type":"string","isRequired":true,"uniqueKey":"taskId","typeLabel":"string"},"source":{"type":"string","enum":["live","persisted","none"],"description":"Where the answer came from. `live` is the running agent's copy; `persisted`\nis the saved copy; `none` means nothing has been said yet.\n","isRequired":true,"uniqueKey":"source","typeLabel":"enum\u003cstring>"},"status":{"type":"string","description":"- `no_session` — the machine has no record of this session; it lapsed or the\n project restarted. Create a new one.\n- `project_not_running` — the session is known but its project has unloaded.\n- `idle` — the session is live and no run has been started.\n- `starting` — a run is being set up.\n- `running` — a run is in progress.\n- `paused` — a run was stopped and can be continued with a new prompt.\n- `completed` — the run finished.\n- `failed` — the run ended in an error. `agent.error` says why, as does the\n transcript.\n- `unknown` — the machine could not be reached for this field. Retry; anything\n else in the same response is still valid.\n\n`paused`, `completed`, and `failed` are terminal for a run.\n","enum":["no_session","project_not_running","idle","starting","running","paused","completed","failed","unknown"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"entryCount":{"type":"integer","minimum":0,"description":"Entries in the whole conversation, not just the returned window.","isRequired":true,"uniqueKey":"entryCount","typeLabel":"integer"},"messages":{"type":"array","items":{"type":"object","required":["index","role","kind"],"properties":{"index":{"type":"integer","minimum":0,"description":"Position in the whole conversation, so a window can be placed.","isRequired":true,"uniqueKey":"messages.items.[INDEX].index","typeLabel":"integer"},"role":{"type":"string","enum":["user","agent"],"isRequired":true,"uniqueKey":"messages.items.[INDEX].role","typeLabel":"enum\u003cstring>"},"kind":{"type":"string","description":"`text` for what was said, `thought` for the agent's reasoning, `tool` for a\ntool it used, `error` for a failure it hit. Treat an unrecognized value as\ninformational rather than as a problem — new kinds can appear.\n","isRequired":true,"uniqueKey":"messages.items.[INDEX].kind","typeLabel":"string"},"text":{"type":"string","description":"The content. For a `tool` entry, the tool's name.","uniqueKey":"messages.items.[INDEX].text","typeLabel":"string"},"timestamp":{"oneOf":[{"type":"integer","description":"Milliseconds since the epoch.","uniqueKey":"messages.items.[INDEX].timestamp.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Milliseconds since the epoch.","uniqueKey":"messages.items.[INDEX].timestamp.oneOf.1","typeLabel":"null"}],"uniqueKey":"messages.items.[INDEX].timestamp","typeLabel":"integer | null"},"messageId":{"type":"string","description":"Present on your own prompts, matching what you sent.","uniqueKey":"messages.items.[INDEX].messageId","typeLabel":"string"},"images":{"type":"array","description":"The images sent with one of your prompts, described rather than\nincluded. Absent when the prompt had none.\n","items":{"type":"object","required":["index","mimeType","byteSize"],"description":"An image sent with a prompt. Fetch its bytes from `getChatMessageImage`\nwith the transcript's `chatId`, the entry's `messageId`, and this `index`.\n","properties":{"index":{"type":"integer","minimum":0,"description":"Position among the prompt's images.","isRequired":true,"uniqueKey":"messages.items.[INDEX].images.items.[INDEX].index","typeLabel":"integer"},"mimeType":{"type":"string","description":"The format the model was given, after any downscaling.","isRequired":true,"uniqueKey":"messages.items.[INDEX].images.items.[INDEX].mimeType","typeLabel":"string"},"byteSize":{"type":"integer","minimum":0,"description":"Size of the stored image in bytes.","isRequired":true,"uniqueKey":"messages.items.[INDEX].images.items.[INDEX].byteSize","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"messages.items.[INDEX].images.items.[INDEX]","typeLabel":"object"},"uniqueKey":"messages.items.[INDEX].images","typeLabel":"object[]"},"tool":{"type":"object","description":"Present only on entries whose `kind` is `tool`.","properties":{"name":{"oneOf":[{"type":"string","uniqueKey":"messages.items.[INDEX].tool.name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"messages.items.[INDEX].tool.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"messages.items.[INDEX].tool.name","typeLabel":"string | null"},"category":{"oneOf":[{"type":"string","description":"What kind of work the tool does, such as `thinking` for the agent's\nreasoning, `asking` for a question to you, or `editing`. Treat an\nunrecognized value as a general tool — new categories can appear.\n","uniqueKey":"messages.items.[INDEX].tool.category.oneOf.0","typeLabel":"string"},{"type":"null","description":"What kind of work the tool does, such as `thinking` for the agent's\nreasoning, `asking` for a question to you, or `editing`. Treat an\nunrecognized value as a general tool — new categories can appear.\n","uniqueKey":"messages.items.[INDEX].tool.category.oneOf.1","typeLabel":"null"}],"uniqueKey":"messages.items.[INDEX].tool.category","typeLabel":"string | null"},"status":{"oneOf":[{"type":"string","description":"`working` while it runs, `complete` when it succeeded, otherwise the severity\nof what went wrong. A tool its run ended without finishing reads `error`.\n","uniqueKey":"messages.items.[INDEX].tool.status.oneOf.0","typeLabel":"string"},{"type":"null","description":"`working` while it runs, `complete` when it succeeded, otherwise the severity\nof what went wrong. A tool its run ended without finishing reads `error`.\n","uniqueKey":"messages.items.[INDEX].tool.status.oneOf.1","typeLabel":"null"}],"uniqueKey":"messages.items.[INDEX].tool.status","typeLabel":"string | null"},"params":{"description":"The arguments the agent chose. Null when the tool takes none.","uniqueKey":"messages.items.[INDEX].tool.params","typeLabel":"any"},"result":{"description":"What the tool returned. Shape is the tool's own.","uniqueKey":"messages.items.[INDEX].tool.result","typeLabel":"any"},"error":{"type":"string","description":"Present when the tool failed.","uniqueKey":"messages.items.[INDEX].tool.error","typeLabel":"string"}},"additionalProperties":true,"uniqueKey":"messages.items.[INDEX].tool","typeLabel":"object"}},"additionalProperties":true,"uniqueKey":"messages.items.[INDEX]","typeLabel":"object"},"description":"Oldest first. Bounded by `limit`, taken from the end.","isRequired":true,"uniqueKey":"messages","typeLabel":"object[]"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"sessionId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","chatId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","taskId":"\u003cstring>","source":"live","status":"no_session","entryCount":1,"messages":[{"index":1,"role":"user","kind":"\u003cstring>","text":"\u003cstring>","timestamp":123,"messageId":"\u003cstring>","images":[{"index":1,"mimeType":"\u003cstring>","byteSize":1}],"tool":{"name":"\u003cstring>","category":"\u003cstring>","status":"\u003cstring>","params":"\u003cunknown>","result":"\u003cunknown>","error":"\u003cstring>"}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"d044f00d-bfc6-4e95-8e44-c5f565ff130f":{"description":"`limit` is out of range. Error code is `INVALID_LIMIT`.","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"},"0a4c763b-0523-4c5e-87d3-263f260e18b9":{"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"},"4540ef1f-cfac-4de1-8ac2-e284e13b7833":{"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"},"ffe54f08-618c-40d2-a91e-d22716a9cfdf":{"description":"No such chat among yours in this project. Error code is `CHAT_NOT_FOUND`.","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"},"8b464bf0-89f4-4adf-988b-57e730da208e":{"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"},"900070f1-524c-4563-8484-bbebdefd8c78":{"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":{"8428d7bb-503c-4d7c-97ac-a4c68fd25770":{"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":"Read a chat's conversation - Davinci","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T18:41:42.328Z","originalFileLocation":"api-reference/chats/read-a-chats-conversation.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"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=\"The transcript of any of your chats, whether or not a session is in it. The shape matches listAgentMessages. A chat one of your sessions is in is read from the running agent, so it is current (source: live) and sessionId names that session. Any other chat is read from its saved copy (source: persisted), which is complete because nothing is running in it.\">\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=\"Read a chat\u0026#x27;s conversation - Davinci\">\u003cmeta data-mint-head property=\"og:description\" content=\"The transcript of any of your chats, whether or not a session is in it. The shape matches listAgentMessages. A chat one of your sessions is in is read from the running agent, so it is current (source: live) and sessionId names that session. Any other chat is read from its saved copy (source: persisted), which is complete because nothing is running in it.\">\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/read-a-chats-conversation\">\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=Read+a+chat%27s+conversation\u0026amp;description=The+transcript+of+any+of+your+chats%2C+whether+or+not+a+session+is+in+it.+The%0Ashape+matches+%60listAgentMessages%60.%0A%0AA+chat+one+of+your+sessions+is+in+is+read+from+t\u0026amp;theme=78d8ed9f672a237868c29fac\u0026amp;signature=c59aa2e83356a1d702f6148128764c636fde29bb62a61acb67ab917cae88f949\">\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=\"Read a chat\u0026#x27;s conversation - Davinci\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The transcript of any of your chats, whether or not a session is in it. The shape matches listAgentMessages. A chat one of your sessions is in is read from the running agent, so it is current (source: live) and sessionId names that session. Any other chat is read from its saved copy (source: persisted), which is complete because nothing is running in it.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://celedonsolutions.mintlify.site/_mintlify/api/og/v2?division=Chats\u0026amp;title=Read+a+chat%27s+conversation\u0026amp;description=The+transcript+of+any+of+your+chats%2C+whether+or+not+a+session+is+in+it.+The%0Ashape+matches+%60listAgentMessages%60.%0A%0AA+chat+one+of+your+sessions+is+in+is+read+from+t\u0026amp;theme=78d8ed9f672a237868c29fac\u0026amp;signature=c59aa2e83356a1d702f6148128764c636fde29bb62a61acb67ab917cae88f949\">\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/read-a-chats-conversation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/chats/read-a-chats-conversation.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/read-a-chats-conversation#webpage\",\"url\":\"https://docs.davinci-app.com/api-reference/chats/read-a-chats-conversation\",\"name\":\"Read a chat's conversation\",\"description\":\"The transcript of any of your chats, whether or not a session is in it. The shape matches listAgentMessages. A chat one of your sessions is in is read from the running agent, so it is current (source: live) and sessionId names that session. Any other chat is read from its saved copy (source: persisted), which is complete because nothing is running in it.\",\"dateModified\":\"2026-11-18T18:41:42.328Z\",\"isPartOf\":{\"@id\":\"https://docs.davinci-app.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.davinci-app.com/api-reference/chats/read-a-chats-conversation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.davinci-app.com/api-reference/chats/read-a-chats-conversation#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\":\"Chats\",\"item\":\"https://docs.davinci-app.com/api-reference/chats/move-a-session-into-another-chat-or-start-a-fresh-one\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Read a chat's conversation\",\"item\":\"https://docs.davinci-app.com/api-reference/chats/read-a-chats-conversation\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.davinci-app.com/api-reference/chats/read-a-chats-conversation#apireference\",\"headline\":\"Read a chat's conversation\",\"name\":\"Read a chat's conversation\",\"description\":\"The transcript of any of your chats, whether or not a session is in it. The shape matches listAgentMessages. A chat one of your sessions is in is read from the running agent, so it is current (source: live) and sessionId names that session. Any other chat is read from its saved copy (source: persisted), which is complete because nothing is running in it.\",\"url\":\"https://docs.davinci-app.com/api-reference/chats/read-a-chats-conversation\",\"mainEntityOfPage\":{\"@id\":\"https://docs.davinci-app.com/api-reference/chats/read-a-chats-conversation#webpage\"},\"dateModified\":\"2026-11-18T18:41:42.328Z\",\"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/read-a-chats-conversation.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","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","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","description":"Sets the chat's title, or clears it with `null`. The title is trimmed and may\nbe up to 200 characters.\n\nA chat is named from its opening message only when it has no title, so a\ntitle set here is kept as the conversation goes on. Clearing it leaves the\nchat untitled; it is not named again.\n\nA chat can be renamed once something has been sent in it. A session's fresh\nchat is not stored until then, so renaming it answers `CHAT_EMPTY`.\n","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","description":"The bytes of one image a prompt carried, as the model was given it — so\npossibly downscaled from what was sent. A transcript lists each prompt's\nimages by `index`, `mimeType` and `byteSize`; this returns one of them.\n\nA prompt's images never change, so the response can be cached for good.\nUse the transcript's `chatId`, including for transcripts read through\n`listAgentMessages`.\n","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":"Read a chat's conversation - 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"]}