Create or continue a chat with a streaming response
Create a chat with a specific agent, or continue an existing chat. Any document that you have access to that is in the agent’s knowledge base could be used to answer questions.
Rate Limits
600 requests per minute.
POST
/
chats-streaming
Create or continue a chat with a streaming response
If the agent reaches an ask-first action while streaming, the stream emits a tool_approval_request event and then ends normally. Resume the paused chat with POST /chats/{chat_id}/approvals.
Use tool_mode to set action behavior for one request. ask requires approval for every configured action, act allows configured actions to run without approval, and off disables all actions. Use tool_configs to override individual configured actions in ask or act mode. Use tool_connector_ids to select a subset of the agent’s configured external tools. These settings cannot add tools or change the agent’s saved configuration.Use document_refs to attach up to 20 exact documents by Realm API data source ID and source document ID. Realm checks that the API token’s user can access each document before starting the stream.
A chat answers one message at a time. If you send a request for a chat_id that is still generating an answer, Realm refuses the second turn rather than running both and losing one of the answers.The stream has already started by the time Realm knows about the conflict, so it arrives as a terminal generation_error event with an error of generation_in_flight and a retry_after_seconds field holding the number of seconds the in-flight answer may still run. The stream then ends. Wait that long and retry, or omit chat_id to start a separate chat. Requests for different chats never conflict with each other.
When enabled for non-streaming responses, return only the final answer text, excluding intermediate reasoning, thinking steps, and agent narration. Has no effect on streaming responses.
Force the primary agent and answer model for a controlled evaluation. Shared classifier and search helper models remain unchanged. Requires include_turn_trace.
Force a provider-neutral reasoning effort for primary model calls in a controlled evaluation. Max resolves to the strongest setting supported by each concrete model and provider. Requires include_turn_trace.
Set action behavior for this request. Ask requires approval for every available action, act skips approval for available actions, and off disables all actions.
Override ask, enabled, or disabled status for individual available actions. Overrides take precedence over ask or act mode; off always disables actions.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Realm Docs","colors":{"primary":"#248573","light":"#248573","dark":"#248573"},"logo":{"light":"https://mintcdn.com/realm/Gmuvv21dZKngXNE6/logo/realm-logo-black.png?fit=max\u0026auto=format\u0026n=Gmuvv21dZKngXNE6\u0026q=85\u0026s=054d513f37788181ce2c55d4757fd72e","dark":"https://mintcdn.com/realm/Gmuvv21dZKngXNE6/logo/realm-logo-white.png?fit=max\u0026auto=format\u0026n=Gmuvv21dZKngXNE6\u0026q=85\u0026s=ba6d5d92f3941cd15b037f313d70d71c"},"favicon":"https://mintcdn.com/realm/s807TVS5W6UrVCCb/favicon.svg?fit=max\u0026auto=format\u0026n=s807TVS5W6UrVCCb\u0026q=85\u0026s=7e7e345794f2034275f8165fcf4e2845","api":{"openapi":"api-reference/openapi.json","params":{"expanded":"all"},"playground":{"display":"interactive"},"examples":{"defaults":"all","languages":["curl","python","javascript","go","ruby","php"],"prefill":true,"autogenerate":true},"url":"full"},"navbar":{"links":[{"href":"mailto:support@withrealm.com","label":"Support"}],"primary":{"type":"button","label":"Open Realm","href":"https://app.withrealm.com"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/withrealm"}},"contextual":{"options":["copy","view","download-spec","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Product updates","icon":"sparkles","href":"/product-updates"},{"anchor":"Changelog","icon":"newspaper","href":"/changelog"},{"anchor":"Status","icon":"signal-bars","href":"https://status.withrealm.com/"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"realm","hasAudioNarration":false,"actualSubdomain":"realm","customDomains":["docs.withrealm.com"],"gitSource":{"type":"github","owner":"realmtechnologies","repo":"realm","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae5b8f8659f6d05f237ce3d","collectionId":"7cf334c3-ab14-4272-a837-e5e834657bfe","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae5b8f8659f6d05f237ce3d"},"entitlements":{},"buildId":"6ae5b8f8659f6d05f237ce3d","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Admin guide","count":41},{"language":"default","tag":"User guide","count":40},{"language":"default","tag":"List of data sources","count":25},{"language":"default","tag":"API docs","count":15},{"language":"default","tag":"API reference","count":14},{"language":"default","tag":"RFP automation","count":11},{"language":"default","tag":"Agents","count":9},{"language":"default","tag":"Organization settings","count":6},{"language":"default","tag":"Use Realm everywhere","count":6},{"language":"default","tag":"Chats","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/chats/create-or-continue-a-chat-with-a-streaming-response","slug":"/api-reference/chats/create-or-continue-a-chat-with-a-streaming-response","pageMetadata":{"title":"Create or continue a chat with a streaming response","description":"Create a chat with a specific agent, or continue an existing chat. Any document that you have access to that is in the agent's knowledge base could be used to answer questions.\n\n### Rate Limits\n\n600 requests per minute.","deprecated":null,"version":null,"sidebarTitle":"Create chat (streaming)","openapi":"/api-reference/openapi.json post /chats-streaming","href":"/api-reference/chats/create-or-continue-a-chat-with-a-streaming-response","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 h3: \"h3\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Create a chat with a specific agent, or continue an existing chat. Any document that you have access to that is in the agent’s knowledge base could be used to answer questions.\"\n }), \"\\n\", _jsx(_components.h3, {\n children: \"Rate Limits\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"600 requests per minute.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`3`,id:`approval-required-events`,children:`Approval-required events`}),`\n`,_jsxs(_components.p,{children:[`If the agent reaches an ask-first action while streaming, the stream emits a `,_jsx(_components.code,{children:`tool_approval_request`}),` event and then ends normally. Resume the paused chat with `,_jsx(_components.code,{children:`POST /chats/{chat_id}/approvals`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`tools-and-documents`,children:`Tools and documents`}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`tool_mode`}),` to set action behavior for one request. `,_jsx(_components.code,{children:`ask`}),` requires approval for every configured action, `,_jsx(_components.code,{children:`act`}),` allows configured actions to run without approval, and `,_jsx(_components.code,{children:`off`}),` disables all actions. Use `,_jsx(_components.code,{children:`tool_configs`}),` to override individual configured actions in `,_jsx(_components.code,{children:`ask`}),` or `,_jsx(_components.code,{children:`act`}),` mode. Use `,_jsx(_components.code,{children:`tool_connector_ids`}),` to select a subset of the agent’s configured external tools. These settings cannot add tools or change the agent’s saved configuration.`]}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`document_refs`}),` to attach up to 20 exact documents by Realm API data source ID and source document ID. Realm checks that the API token’s user can access each document before starting the stream.`]}),`\n`,_jsx(Heading,{level:`3`,id:`one-answer-at-a-time-per-chat`,children:`One answer at a time per chat`}),`\n`,_jsxs(_components.p,{children:[`A chat answers one message at a time. If you send a request for a `,_jsx(_components.code,{children:`chat_id`}),` that is still generating an answer, Realm refuses the second turn rather than running both and losing one of the answers.`]}),`\n`,_jsxs(_components.p,{children:[`The stream has already started by the time Realm knows about the conflict, so it arrives as a terminal `,_jsx(_components.code,{children:`generation_error`}),` event with an `,_jsx(_components.code,{children:`error`}),` of `,_jsx(_components.code,{children:`generation_in_flight`}),` and a `,_jsx(_components.code,{children:`retry_after_seconds`}),` field holding the number of seconds the in-flight answer may still run. The stream then ends. Wait that long and retry, or omit `,_jsx(_components.code,{children:`chat_id`}),` to start a separate chat. Requests for different chats never conflict with each other.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create or continue a chat with a streaming response","description":"Create a chat with a specific agent, or continue an existing chat. Any document that you have access to that is in the agent's knowledge base could be used to answer questions.\n\n### Rate Limits\n\n600 requests per minute.","deprecated":null,"version":null,"sidebarTitle":"Create chat (streaming)","openapi":"/api-reference/openapi.json post /chats-streaming","href":"/api-reference/chats/create-or-continue-a-chat-with-a-streaming-response","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Approval-required events","slug":"approval-required-events","depth":3,"children":[]},{"title":"Tools and documents","slug":"tools-and-documents","depth":3,"children":[]},{"title":"One answer at a time per chat","slug":"one-answer-at-a-time-per-chat","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"createChatStreaming","description":"Create a chat with a specific agent, or continue an existing chat. Any document that you have access to that is in the agent's knowledge base could be used to answer questions.\n\n### Rate Limits\n\n600 requests per minute.","summary":"Create or continue a chat with a streaming response","tags":["Chats"],"x-mint":{"content":"### Approval-required events\n\nIf the agent reaches an ask-first action while streaming, the stream emits a `tool_approval_request` event and then ends normally. Resume the paused chat with `POST /chats/{chat_id}/approvals`.\n\n### Tools and documents\n\nUse `tool_mode` to set action behavior for one request. `ask` requires approval for every configured action, `act` allows configured actions to run without approval, and `off` disables all actions. Use `tool_configs` to override individual configured actions in `ask` or `act` mode. Use `tool_connector_ids` to select a subset of the agent's configured external tools. These settings cannot add tools or change the agent's saved configuration.\n\nUse `document_refs` to attach up to 20 exact documents by Realm API data source ID and source document ID. Realm checks that the API token's user can access each document before starting the stream.\n\n### One answer at a time per chat\n\nA chat answers one message at a time. If you send a request for a `chat_id` that is still generating an answer, Realm refuses the second turn rather than running both and losing one of the answers.\n\nThe stream has already started by the time Realm knows about the conflict, so it arrives as a terminal `generation_error` event with an `error` of `generation_in_flight` and a `retry_after_seconds` field holding the number of seconds the in-flight answer may still run. The stream then ends. Wait that long and retry, or omit `chat_id` to start a separate chat. Requests for different chats never conflict with each other.","metadata":{"sidebarTitle":"Create chat (streaming)"}},"security":["a9726d59-af1b-4abb-ace4-454a818fae3b"],"requestBody":"f3969771-a667-4fba-b585-552f390dff2e","responses":{"200":"33161410-1814-4bdb-a3cf-dbad13acd144","400":"9f337854-8129-40f1-a105-6bb4d2f6b219","401":"08360815-c053-41be-b6d1-4e804cff6ce3","403":"4ae529de-72d3-49f2-9bd8-befff69934f0","429":"23fbd2b7-dbe1-47b6-9dd2-01997719cccd","500":"c871fb25-6faa-4e42-8680-c70108bf2794"},"method":"post","type":"path","servers":["431afb04-1374-49ce-bbad-67a46887ccd4","b02b8b10-d94b-41f3-a656-a53db0a82ee7"],"path":"/chats-streaming","baseUrlOptions":["https://app.withrealm.com/api/external/alpha","https://{tenant}.withrealm.com/api/external/alpha"],"title":"Create or continue a chat with a streaming response","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","go","ruby","php"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.content":"Summarize our Q3 sales performance.","body.agent_id.oneOf.0":"agt_1a2b3c","body.chat_id":"cht_9x8y7z","body.document_refs.items.0.data_source_id":"ds_kb_main","body.document_refs.items.0.source_id":"doc_42","body.citation_style":"link","body.output_format":"markdown","body.tool_mode":"ask"}],"urlDisplay":"full"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","description":"The content of the user message.","isRequired":true,"uniqueKey":"content","typeLabel":"string"},"assistant_id":{"oneOf":[{"type":"string","description":"Deprecated. Use agent_id instead.","uniqueKey":"assistant_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Deprecated. Use agent_id instead.","uniqueKey":"assistant_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"assistant_id","typeLabel":"string | null"},"agent_id":{"oneOf":[{"type":"string","description":"The ID of the agent to use for the chat. You can find the ID by clicking on the agent in the [Agents](/agents) page.","uniqueKey":"agent_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The ID of the agent to use for the chat. You can find the ID by clicking on the agent in the [Agents](/agents) page.","uniqueKey":"agent_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"agent_id","typeLabel":"string | null"},"chat_id":{"type":"string","description":"The ID of the chat to continue. If not provided, a new chat will be created.","example":"123","uniqueKey":"chat_id","typeLabel":"string"},"research_mode":{"type":"boolean","description":"Enable research mode for this chat. Only works if the agent has research mode enabled ('optional' or 'always_on').","uniqueKey":"research_mode","typeLabel":"boolean"},"document_refs":{"type":"array","items":{"type":"object","properties":{"data_source_id":{"type":"string","minLength":1,"description":"The Realm API data source ID that owns the document.","isRequired":true,"uniqueKey":"document_refs.items.[INDEX].data_source_id","typeLabel":"string"},"source_id":{"type":"string","minLength":1,"description":"The source document ID supplied when the document was added.","isRequired":true,"uniqueKey":"document_refs.items.[INDEX].source_id","typeLabel":"string"}},"required":["data_source_id","source_id"],"uniqueKey":"document_refs.items.[INDEX]","typeLabel":"object"},"maxItems":20,"description":"Attach exact documents by Realm API data source ID and source document ID.","uniqueKey":"document_refs","typeLabel":"object[]"},"citation_style":{"type":"string","enum":["link","remove"],"default":"remove","description":"The style of citations to use. 'remove' will not show any citations, 'link' will format them as URLs.","uniqueKey":"citation_style","typeLabel":"enum\u003cstring>"},"output_format":{"type":"string","enum":["markdown","text"],"default":"markdown","description":"The format of the content returned. 'markdown' includes formatting, 'text' returns plain text.","uniqueKey":"output_format","typeLabel":"enum\u003cstring>"},"prompt_variables":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"prompt_variables.additionalProperties","typeLabel":"string"},"description":"Prompt variables as input to the agent.","uniqueKey":"prompt_variables","typeLabel":"object"},"answer_only":{"type":"boolean","default":false,"description":"When enabled for non-streaming responses, return only the final answer text, excluding intermediate reasoning, thinking steps, and agent narration. Has no effect on streaming responses.","uniqueKey":"answer_only","typeLabel":"boolean"},"eval_options":{"type":"object","properties":{"include_turn_trace":{"type":"boolean","description":"Return a normalized persisted trace for the current turn, including approval pauses. Requires internal evaluation access.","isRequired":true,"uniqueKey":"eval_options.include_turn_trace","typeLabel":"boolean"},"model_override":{"type":"string","enum":["test","o1","o3","o1-mini","o3-mini","o4-mini","gpt-image-2","gpt-5.6-sol","gpt-5.6-sol-eu","gpt-5.6-terra","gpt-5.6-terra-eu","gpt-5.6-luna","gpt-5.6-luna-eu","gpt-6-sol","gpt-6-sol-eu","gpt-6-luna","gpt-6-luna-eu","gpt-6.1-sol","gpt-6.1-sol-eu","gpt-6.1-terra","gpt-6.1-terra-eu","gpt-5.5","gpt-5.5-eu","vertex-finetuned-1","vertex-finetuned-2","vertex-claude-3-7-sonnet@20250219","vertex-claude-3-5-sonnet@20240620","vertex-claude-3-5-sonnet-v2@20241022","vertex-claude-3-haiku@20240307","vertex-claude-3-opus@20240229","vertex-claude-opus-4@20250514","vertex-claude-sonnet-4@20250514","vertex-claude-sonnet-4-5@20250929","vertex-claude-opus-4-5@20251101","vertex-claude-opus-4-6@default","vertex-claude-opus-4-7@global","vertex-claude-opus-4-7@eu","vertex-claude-sonnet-5@eu","vertex-claude-sonnet-5-5@global","vertex-claude-sonnet-5-5@eu","vertex-claude-haiku-5-5@global","vertex-claude-haiku-5-5@eu","vertex-claude-opus-4-8@global","vertex-claude-opus-4-8@eu","vertex-claude-opus-5@global","vertex-claude-opus-5@eu","vertex-claude-opus-5-5@global","vertex-claude-opus-5-5@eu","vertex-claude-sonnet-4-6","vertex-claude-haiku-4-5@20251001","bedrock-anthropic.claude-opus-4-5-20251101-v1:0","bedrock-anthropic.claude-opus-4-6-v1","bedrock-anthropic.claude-opus-4-7","bedrock-anthropic.claude-opus-4-8","bedrock-anthropic.claude-opus-5","bedrock-anthropic.claude-sonnet-4-6","bedrock-anthropic.claude-sonnet-4-5-20250929-v1:0","bedrock-us-anthropic.claude-sonnet-4-20250514-v1:0","bedrock-eu-anthropic.claude-sonnet-4-20250514-v1:0","bedrock-eu-anthropic.claude-3-7-sonnet-20250219-v1:0","bedrock-eu-anthropic.claude-3-5-sonnet-20240620-v1:0","bedrock-eu-anthropic.claude-3-5-haiku-20241022-v1:0","bedrock-anthropic.claude-haiku-4-5-20251001-v1:0","claude-sonnet-4-20250514","claude-sonnet-4-6","claude-sonnet-5","claude-sonnet-5-5","claude-haiku-5-5","claude-opus-4-6","claude-opus-4-7","claude-opus-4-8","claude-opus-5","claude-opus-5-5","claude-haiku-4-5-20251001","claude-sonnet-4-5-20250929","claude-3-7-sonnet-latest","claude-3-7-sonnet-20250219","claude-3-5-sonnet-20241022","groq-mixtral","google-gemini-1.5-pro-001","google-gemini-1.5-flash-001","google-gemini-2.0-flash-001","google-gemini-2.5-pro","google-gemini-2.5-flash","google-gemini-2.5-flash-lite","google-gemini-2.5-flash-image","google-gemini-3.1-flash-lite","google-gemini-3.1-flash-lite-eu","google-gemini-3.1-flash-image","google-gemini-3.5-flash-lite","google-gemini-3.5-flash-lite-eu","google-gemini-3.5-flash","google-gemini-3.5-flash-eu","google-gemini-3.6-flash","google-gemini-3.7-flash","google-gemini-3.7-flash-eu","google-gemini-3.8-flash","google-gemini-3.8-flash-eu","gemini-2.0-flash-001","gemini-2.5-pro","gemini-2.5-flash","gemini-2.5-flash-lite","gemini-2.5-flash-image","gemini-3.1-flash-lite","gemini-3.1-flash-image","gemini-3.5-flash-lite","gemini-3.5-flash","gemini-3.6-flash","gemini-3.7-flash","gemini-3.8-flash","gemini-3-pro","gemini-3-flash","google-gemini-3-flash","google-gemini-3-pro","finetuned-mini","finetuned-mini-2","finetuned-mini-3","finetuned-filtersearch-1","finetuned-gpt41mini-1","finetuned-4o","qwen-7b","flow-judge","llama-3.2-3b","cerebras-llama-3.3-70b","tensorx-deepseek-v4-flash","tensorx-deepseek-v4-flash-0731","tensorx-qwen3.8-flash-next","scaleway-deepseek-v4-flash-0731","lyceum-deepseek-v4-flash-0731","lyceum-qwen3.8-flash-next","fireworks-deepseek-v4-flash-0731","baseten-deepseek-v4-flash-0731","gmicloud-deepseek-v4-flash","gmicloud-qwen3.8-flash","digitalocean-deepseek-v4-flash-0731","deepseek-v4-1-flash","novita-deepseek-v4-1-flash","fireworks-deepseek-v4-1-flash","gmicloud-deepseek-v4-1-flash","baseten-deepseek-v4-1-flash","digitalocean-deepseek-v4-1-flash","tensorx-deepseek-v4-1-flash","scaleway-deepseek-v4-1-flash","mistral-large-4","digitalocean-mimo-v2.5","fireworks-glm-5.3-flash"],"description":"Force the primary agent and answer model for a controlled evaluation. Shared classifier and search helper models remain unchanged. Requires include_turn_trace.","uniqueKey":"eval_options.model_override","typeLabel":"enum\u003cstring>"},"reasoning_effort":{"type":"string","enum":["low","medium","high","max"],"description":"Force a provider-neutral reasoning effort for primary model calls in a controlled evaluation. Max resolves to the strongest setting supported by each concrete model and provider. Requires include_turn_trace.","uniqueKey":"eval_options.reasoning_effort","typeLabel":"enum\u003cstring>"}},"required":["include_turn_trace"],"uniqueKey":"eval_options","typeLabel":"object"},"tool_mode":{"type":"string","enum":["ask","act","off"],"description":"Set action behavior for this request. Ask requires approval for every available action, act skips approval for available actions, and off disables all actions.","uniqueKey":"tool_mode","typeLabel":"enum\u003cstring>"},"tool_connector_ids":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"tool_connector_ids.items.[INDEX]","typeLabel":"string"},"maxItems":100,"description":"Replace the agent's configured external tools with these connector or action identifiers for this request.","uniqueKey":"tool_connector_ids","typeLabel":"string[]"},"tool_configs":{"type":"object","additionalProperties":{"type":"object","properties":{"status":{"type":"string","enum":["ask","enabled","disabled"],"isRequired":true,"uniqueKey":"tool_configs.additionalProperties.status","typeLabel":"enum\u003cstring>"}},"required":["status"],"uniqueKey":"tool_configs.additionalProperties","typeLabel":"object"},"description":"Override ask, enabled, or disabled status for individual available actions. Overrides take precedence over ask or act mode; off always disables actions.","uniqueKey":"tool_configs","typeLabel":"object"}},"required":["content"],"example":{"agent_id":"agt_1a2b3c","content":"Summarize our Q3 sales performance.","chat_id":"cht_9x8y7z","tool_mode":"ask","document_refs":[{"data_source_id":"ds_kb_main","source_id":"doc_42"}],"citation_style":"link","output_format":"markdown"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"agent_id":"agt_1a2b3c","content":"Summarize our Q3 sales performance.","chat_id":"cht_9x8y7z","tool_mode":"ask","document_refs":[{"data_source_id":"ds_kb_main","source_id":"doc_42"}],"citation_style":"link","output_format":"markdown"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"33161410-1814-4bdb-a3cf-dbad13acd144":{"description":"Success","content":{"text/event-stream":{"schema":{"oneOf":[{"type":"object","required":["type","text"],"example":{"type":"generation_tokens","text":"Your Q3 revenue grew ","id":"cht_9x8y7z","full":false},"properties":{"type":{"type":"string","enum":["generation_tokens"],"description":"Partial chat","isRequired":true,"uniqueKey":"oneOf.0.type","typeLabel":"enum\u003cstring>"},"text":{"type":"string","description":"The content of the partial chat","isRequired":true,"uniqueKey":"oneOf.0.text","typeLabel":"string"},"id":{"type":"string","description":"The ID of the chat","uniqueKey":"oneOf.0.id","typeLabel":"string"},"full":{"type":"boolean","description":"Whether the chat is complete","uniqueKey":"oneOf.0.full","typeLabel":"boolean"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["type"],"example":{"type":"generation_retry"},"properties":{"type":{"type":"string","enum":["generation_retry"],"description":"The answer is being regenerated; discard every partial chat received so far for this response","isRequired":true,"uniqueKey":"oneOf.1.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"oneOf.1","typeLabel":"object"},{"type":"object","required":["type","text"],"example":{"type":"generation_error","text":"Another answer is already being generated in this chat.","error":"generation_in_flight","retry_after_seconds":8},"properties":{"type":{"type":"string","enum":["generation_error"],"description":"Error response","isRequired":true,"uniqueKey":"oneOf.2.type","typeLabel":"enum\u003cstring>"},"text":{"type":"string","description":"The error message","isRequired":true,"uniqueKey":"oneOf.2.text","typeLabel":"string"},"error":{"type":"string","description":"Machine-readable error code, present for errors that have one, for example `generation_in_flight`.","uniqueKey":"oneOf.2.error","typeLabel":"string"},"retry_after_seconds":{"type":"number","description":"How long to wait before retrying, present when the error is retryable.","uniqueKey":"oneOf.2.retry_after_seconds","typeLabel":"number"}},"uniqueKey":"oneOf.2","typeLabel":"object"},{"type":"object","required":["type","chat"],"example":{"type":"generation_success","chat":{"id":"cht_9x8y7z","assistant_id":"agt_1a2b3c","agent_id":"agt_1a2b3c","created":1730212800000,"created_date":"2024-10-29T14:00:00.000Z","content":"Your Q3 revenue grew 12% quarter over quarter.","research_mode":false,"output_format":"markdown","status":"completed"}},"properties":{"type":{"type":"string","enum":["generation_success"],"description":"Chat completed successfully","isRequired":true,"uniqueKey":"oneOf.3.type","typeLabel":"enum\u003cstring>"},"chat":{"type":"object","description":"The completed chat","required":["id","assistant_id","agent_id","created","created_date","content","research_mode","output_format","status"],"example":{"id":"cht_9x8y7z","assistant_id":"agt_1a2b3c","agent_id":"agt_1a2b3c","created":1730210400000,"created_date":"2024-10-29T14:00:00.000Z","content":"Your Q3 revenue grew 12% quarter over quarter.","research_mode":false,"output_format":"markdown","status":"completed"},"properties":{"id":{"type":"string","description":"Unique identifier for the chat","isRequired":true,"uniqueKey":"oneOf.3.chat.id","typeLabel":"string"},"assistant_id":{"type":"string","description":"Deprecated. Use agent_id instead.","isRequired":true,"uniqueKey":"oneOf.3.chat.assistant_id","typeLabel":"string"},"agent_id":{"type":"string","description":"The ID of the agent that processed the request","isRequired":true,"uniqueKey":"oneOf.3.chat.agent_id","typeLabel":"string"},"created":{"type":"number","description":"Unix timestamp in milliseconds of when the completion was created","isRequired":true,"uniqueKey":"oneOf.3.chat.created","typeLabel":"number"},"created_date":{"type":"string","description":"ISO 8601 formatted timestamp of when the completion was created","isRequired":true,"uniqueKey":"oneOf.3.chat.created_date","typeLabel":"string"},"content":{"type":"string","description":"The content of the chat","isRequired":true,"uniqueKey":"oneOf.3.chat.content","typeLabel":"string"},"research_mode":{"type":"boolean","description":"If research mode was used for this chat. The agent configuration can override the user requested value.","isRequired":true,"uniqueKey":"oneOf.3.chat.research_mode","typeLabel":"boolean"},"output_format":{"type":"string","enum":["markdown","text"],"description":"The format of the content returned","isRequired":true,"uniqueKey":"oneOf.3.chat.output_format","typeLabel":"enum\u003cstring>"},"status":{"type":"string","description":"Whether the chat completed immediately or was queued","enum":["completed"],"isRequired":true,"uniqueKey":"oneOf.3.chat.status","typeLabel":"enum\u003cstring>"},"eval_trace":{"type":"object","description":"Normalized persisted turn trace returned only for authorized eval requests","required":["version","status","chat_id","user_message_id","assistant_message_id","langfuse_trace_id","model_override","reasoning_effort","served_models","started_at","completed_at","final_response","tool_calls","output_files","output_file_references","usage","context"],"properties":{"version":{"type":"number","enum":[1],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.version","typeLabel":"enum\u003cnumber>"},"status":{"type":"string","enum":["completed","approval_required","failed","aborted"],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.status","typeLabel":"enum\u003cstring>"},"chat_id":{"type":"string","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.chat_id","typeLabel":"string"},"user_message_id":{"type":"string","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.user_message_id","typeLabel":"string"},"assistant_message_id":{"type":"string","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.assistant_message_id","typeLabel":"string"},"langfuse_trace_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.langfuse_trace_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.langfuse_trace_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.langfuse_trace_id","typeLabel":"string | null"},"model_override":{"oneOf":[{"type":"string","enum":["test","o1","o3","o1-mini","o3-mini","o4-mini","gpt-image-2","gpt-5.6-sol","gpt-5.6-sol-eu","gpt-5.6-terra","gpt-5.6-terra-eu","gpt-5.6-luna","gpt-5.6-luna-eu","gpt-6-sol","gpt-6-sol-eu","gpt-6-luna","gpt-6-luna-eu","gpt-6.1-sol","gpt-6.1-sol-eu","gpt-6.1-terra","gpt-6.1-terra-eu","gpt-5.5","gpt-5.5-eu","vertex-finetuned-1","vertex-finetuned-2","vertex-claude-3-7-sonnet@20250219","vertex-claude-3-5-sonnet@20240620","vertex-claude-3-5-sonnet-v2@20241022","vertex-claude-3-haiku@20240307","vertex-claude-3-opus@20240229","vertex-claude-opus-4@20250514","vertex-claude-sonnet-4@20250514","vertex-claude-sonnet-4-5@20250929","vertex-claude-opus-4-5@20251101","vertex-claude-opus-4-6@default","vertex-claude-opus-4-7@global","vertex-claude-opus-4-7@eu","vertex-claude-sonnet-5@eu","vertex-claude-sonnet-5-5@global","vertex-claude-sonnet-5-5@eu","vertex-claude-haiku-5-5@global","vertex-claude-haiku-5-5@eu","vertex-claude-opus-4-8@global","vertex-claude-opus-4-8@eu","vertex-claude-opus-5@global","vertex-claude-opus-5@eu","vertex-claude-opus-5-5@global","vertex-claude-opus-5-5@eu","vertex-claude-sonnet-4-6","vertex-claude-haiku-4-5@20251001","bedrock-anthropic.claude-opus-4-5-20251101-v1:0","bedrock-anthropic.claude-opus-4-6-v1","bedrock-anthropic.claude-opus-4-7","bedrock-anthropic.claude-opus-4-8","bedrock-anthropic.claude-opus-5","bedrock-anthropic.claude-sonnet-4-6","bedrock-anthropic.claude-sonnet-4-5-20250929-v1:0","bedrock-us-anthropic.claude-sonnet-4-20250514-v1:0","bedrock-eu-anthropic.claude-sonnet-4-20250514-v1:0","bedrock-eu-anthropic.claude-3-7-sonnet-20250219-v1:0","bedrock-eu-anthropic.claude-3-5-sonnet-20240620-v1:0","bedrock-eu-anthropic.claude-3-5-haiku-20241022-v1:0","bedrock-anthropic.claude-haiku-4-5-20251001-v1:0","claude-sonnet-4-20250514","claude-sonnet-4-6","claude-sonnet-5","claude-sonnet-5-5","claude-haiku-5-5","claude-opus-4-6","claude-opus-4-7","claude-opus-4-8","claude-opus-5","claude-opus-5-5","claude-haiku-4-5-20251001","claude-sonnet-4-5-20250929","claude-3-7-sonnet-latest","claude-3-7-sonnet-20250219","claude-3-5-sonnet-20241022","groq-mixtral","google-gemini-1.5-pro-001","google-gemini-1.5-flash-001","google-gemini-2.0-flash-001","google-gemini-2.5-pro","google-gemini-2.5-flash","google-gemini-2.5-flash-lite","google-gemini-2.5-flash-image","google-gemini-3.1-flash-lite","google-gemini-3.1-flash-lite-eu","google-gemini-3.1-flash-image","google-gemini-3.5-flash-lite","google-gemini-3.5-flash-lite-eu","google-gemini-3.5-flash","google-gemini-3.5-flash-eu","google-gemini-3.6-flash","google-gemini-3.7-flash","google-gemini-3.7-flash-eu","google-gemini-3.8-flash","google-gemini-3.8-flash-eu","gemini-2.0-flash-001","gemini-2.5-pro","gemini-2.5-flash","gemini-2.5-flash-lite","gemini-2.5-flash-image","gemini-3.1-flash-lite","gemini-3.1-flash-image","gemini-3.5-flash-lite","gemini-3.5-flash","gemini-3.6-flash","gemini-3.7-flash","gemini-3.8-flash","gemini-3-pro","gemini-3-flash","google-gemini-3-flash","google-gemini-3-pro","finetuned-mini","finetuned-mini-2","finetuned-mini-3","finetuned-filtersearch-1","finetuned-gpt41mini-1","finetuned-4o","qwen-7b","flow-judge","llama-3.2-3b","cerebras-llama-3.3-70b","tensorx-deepseek-v4-flash","tensorx-deepseek-v4-flash-0731","tensorx-qwen3.8-flash-next","scaleway-deepseek-v4-flash-0731","lyceum-deepseek-v4-flash-0731","lyceum-qwen3.8-flash-next","fireworks-deepseek-v4-flash-0731","baseten-deepseek-v4-flash-0731","gmicloud-deepseek-v4-flash","gmicloud-qwen3.8-flash","digitalocean-deepseek-v4-flash-0731","deepseek-v4-1-flash","novita-deepseek-v4-1-flash","fireworks-deepseek-v4-1-flash","gmicloud-deepseek-v4-1-flash","baseten-deepseek-v4-1-flash","digitalocean-deepseek-v4-1-flash","tensorx-deepseek-v4-1-flash","scaleway-deepseek-v4-1-flash","mistral-large-4","digitalocean-mimo-v2.5","fireworks-glm-5.3-flash"],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.model_override.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["test","o1","o3","o1-mini","o3-mini","o4-mini","gpt-image-2","gpt-5.6-sol","gpt-5.6-sol-eu","gpt-5.6-terra","gpt-5.6-terra-eu","gpt-5.6-luna","gpt-5.6-luna-eu","gpt-6-sol","gpt-6-sol-eu","gpt-6-luna","gpt-6-luna-eu","gpt-6.1-sol","gpt-6.1-sol-eu","gpt-6.1-terra","gpt-6.1-terra-eu","gpt-5.5","gpt-5.5-eu","vertex-finetuned-1","vertex-finetuned-2","vertex-claude-3-7-sonnet@20250219","vertex-claude-3-5-sonnet@20240620","vertex-claude-3-5-sonnet-v2@20241022","vertex-claude-3-haiku@20240307","vertex-claude-3-opus@20240229","vertex-claude-opus-4@20250514","vertex-claude-sonnet-4@20250514","vertex-claude-sonnet-4-5@20250929","vertex-claude-opus-4-5@20251101","vertex-claude-opus-4-6@default","vertex-claude-opus-4-7@global","vertex-claude-opus-4-7@eu","vertex-claude-sonnet-5@eu","vertex-claude-sonnet-5-5@global","vertex-claude-sonnet-5-5@eu","vertex-claude-haiku-5-5@global","vertex-claude-haiku-5-5@eu","vertex-claude-opus-4-8@global","vertex-claude-opus-4-8@eu","vertex-claude-opus-5@global","vertex-claude-opus-5@eu","vertex-claude-opus-5-5@global","vertex-claude-opus-5-5@eu","vertex-claude-sonnet-4-6","vertex-claude-haiku-4-5@20251001","bedrock-anthropic.claude-opus-4-5-20251101-v1:0","bedrock-anthropic.claude-opus-4-6-v1","bedrock-anthropic.claude-opus-4-7","bedrock-anthropic.claude-opus-4-8","bedrock-anthropic.claude-opus-5","bedrock-anthropic.claude-sonnet-4-6","bedrock-anthropic.claude-sonnet-4-5-20250929-v1:0","bedrock-us-anthropic.claude-sonnet-4-20250514-v1:0","bedrock-eu-anthropic.claude-sonnet-4-20250514-v1:0","bedrock-eu-anthropic.claude-3-7-sonnet-20250219-v1:0","bedrock-eu-anthropic.claude-3-5-sonnet-20240620-v1:0","bedrock-eu-anthropic.claude-3-5-haiku-20241022-v1:0","bedrock-anthropic.claude-haiku-4-5-20251001-v1:0","claude-sonnet-4-20250514","claude-sonnet-4-6","claude-sonnet-5","claude-sonnet-5-5","claude-haiku-5-5","claude-opus-4-6","claude-opus-4-7","claude-opus-4-8","claude-opus-5","claude-opus-5-5","claude-haiku-4-5-20251001","claude-sonnet-4-5-20250929","claude-3-7-sonnet-latest","claude-3-7-sonnet-20250219","claude-3-5-sonnet-20241022","groq-mixtral","google-gemini-1.5-pro-001","google-gemini-1.5-flash-001","google-gemini-2.0-flash-001","google-gemini-2.5-pro","google-gemini-2.5-flash","google-gemini-2.5-flash-lite","google-gemini-2.5-flash-image","google-gemini-3.1-flash-lite","google-gemini-3.1-flash-lite-eu","google-gemini-3.1-flash-image","google-gemini-3.5-flash-lite","google-gemini-3.5-flash-lite-eu","google-gemini-3.5-flash","google-gemini-3.5-flash-eu","google-gemini-3.6-flash","google-gemini-3.7-flash","google-gemini-3.7-flash-eu","google-gemini-3.8-flash","google-gemini-3.8-flash-eu","gemini-2.0-flash-001","gemini-2.5-pro","gemini-2.5-flash","gemini-2.5-flash-lite","gemini-2.5-flash-image","gemini-3.1-flash-lite","gemini-3.1-flash-image","gemini-3.5-flash-lite","gemini-3.5-flash","gemini-3.6-flash","gemini-3.7-flash","gemini-3.8-flash","gemini-3-pro","gemini-3-flash","google-gemini-3-flash","google-gemini-3-pro","finetuned-mini","finetuned-mini-2","finetuned-mini-3","finetuned-filtersearch-1","finetuned-gpt41mini-1","finetuned-4o","qwen-7b","flow-judge","llama-3.2-3b","cerebras-llama-3.3-70b","tensorx-deepseek-v4-flash","tensorx-deepseek-v4-flash-0731","tensorx-qwen3.8-flash-next","scaleway-deepseek-v4-flash-0731","lyceum-deepseek-v4-flash-0731","lyceum-qwen3.8-flash-next","fireworks-deepseek-v4-flash-0731","baseten-deepseek-v4-flash-0731","gmicloud-deepseek-v4-flash","gmicloud-qwen3.8-flash","digitalocean-deepseek-v4-flash-0731","deepseek-v4-1-flash","novita-deepseek-v4-1-flash","fireworks-deepseek-v4-1-flash","gmicloud-deepseek-v4-1-flash","baseten-deepseek-v4-1-flash","digitalocean-deepseek-v4-1-flash","tensorx-deepseek-v4-1-flash","scaleway-deepseek-v4-1-flash","mistral-large-4","digitalocean-mimo-v2.5","fireworks-glm-5.3-flash"],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.model_override.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.model_override","typeLabel":"enum\u003cstring> | null"},"reasoning_effort":{"oneOf":[{"type":"string","enum":["low","medium","high","max"],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.reasoning_effort.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["low","medium","high","max"],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.reasoning_effort.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.reasoning_effort","typeLabel":"enum\u003cstring> | null"},"served_models":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"oneOf.3.chat.eval_trace.served_models.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Models that completed calls during the turn, in call order. Null means model telemetry was unavailable.","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.served_models.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"Models that completed calls during the turn, in call order. Null means model telemetry was unavailable.","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.served_models.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.served_models","typeLabel":"string[] | null"},"started_at":{"type":"string","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.started_at","typeLabel":"string"},"completed_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.completed_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.completed_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.completed_at","typeLabel":"string | null"},"final_response":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.final_response.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.final_response.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.final_response","typeLabel":"string | null"},"tool_calls":{"type":"array","items":{"type":"object","properties":{"sequence":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].sequence","typeLabel":"integer"},"tool_call_id":{"type":"string","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].tool_call_id","typeLabel":"string"},"parent_tool_call_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].parent_tool_call_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].parent_tool_call_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].parent_tool_call_id","typeLabel":"string | null"},"source":{"type":"string","enum":["realm","provider"],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].source","typeLabel":"enum\u003cstring>"},"raw_tool_name":{"type":"string","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].raw_tool_name","typeLabel":"string"},"connector":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].connector.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].connector.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].connector","typeLabel":"string | null"},"action":{"type":"string","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].action","typeLabel":"string"},"requested_input":{"oneOf":[{"isRequired":true}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].requested_input","typeLabel":"any"},"requested_input_truncated":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].requested_input_truncated","typeLabel":"boolean"},"status":{"type":"string","enum":["proposed","approval_required","denied","succeeded","failed"],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"approval":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","enum":["requested","approved","denied"],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].approval.oneOf.0.status","typeLabel":"enum\u003cstring>"},"reason":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].approval.oneOf.0.reason.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].approval.oneOf.0.reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].approval.oneOf.0.reason","typeLabel":"string | null"}},"required":["status","reason"],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].approval.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"status":{"type":"string","enum":["requested","approved","denied"]},"reason":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["status","reason"],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].approval.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].approval","typeLabel":"object | null"},"output":{"oneOf":[{"isRequired":true}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].output","typeLabel":"any"},"output_truncated":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].output_truncated","typeLabel":"boolean"},"error":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].error.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX].error","typeLabel":"string | null"}},"required":["sequence","tool_call_id","parent_tool_call_id","source","raw_tool_name","connector","action","requested_input","requested_input_truncated","status","approval","output","output_truncated","error"],"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.tool_calls","typeLabel":"object[]"},"output_files":{"type":"array","items":{"type":"object","properties":{"file_path":{"type":"string","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.output_files.items.[INDEX].file_path","typeLabel":"string"},"file_name":{"type":"string","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.output_files.items.[INDEX].file_name","typeLabel":"string"},"mime_type":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.output_files.items.[INDEX].mime_type.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.output_files.items.[INDEX].mime_type.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.output_files.items.[INDEX].mime_type","typeLabel":"string | null"},"download_url":{"type":"string","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.output_files.items.[INDEX].download_url","typeLabel":"string"}},"required":["file_path","file_name","mime_type","download_url"],"uniqueKey":"oneOf.3.chat.eval_trace.output_files.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.output_files","typeLabel":"object[]"},"output_file_references":{"type":"array","items":{"type":"object","properties":{"reference":{"type":"string","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.output_file_references.items.[INDEX].reference","typeLabel":"string"},"file_path":{"type":"string","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.output_file_references.items.[INDEX].file_path","typeLabel":"string"},"file_name":{"type":"string","isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.output_file_references.items.[INDEX].file_name","typeLabel":"string"}},"required":["reference","file_path","file_name"],"uniqueKey":"oneOf.3.chat.eval_trace.output_file_references.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.output_file_references","typeLabel":"object[]"},"usage":{"type":"object","properties":{"model_calls":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.model_calls.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.model_calls.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.model_calls","typeLabel":"integer | null"},"agent_steps":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.agent_steps.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.agent_steps.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.agent_steps","typeLabel":"integer | null"},"input_tokens":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.input_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.input_tokens.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.input_tokens","typeLabel":"integer | null"},"output_tokens":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.output_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.output_tokens.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.output_tokens","typeLabel":"integer | null"},"total_tokens":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.total_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.total_tokens.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.total_tokens","typeLabel":"integer | null"},"cache_read_input_tokens":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.cache_read_input_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.cache_read_input_tokens.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.cache_read_input_tokens","typeLabel":"integer | null"},"cache_write_input_tokens":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.cache_write_input_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.cache_write_input_tokens.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.cache_write_input_tokens","typeLabel":"integer | null"},"provider_cost_usd":{"oneOf":[{"type":"number","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.provider_cost_usd.oneOf.0","typeLabel":"number"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.provider_cost_usd.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage.provider_cost_usd","typeLabel":"number | null"}},"required":["model_calls","agent_steps","input_tokens","output_tokens","total_tokens","cache_read_input_tokens","cache_write_input_tokens","provider_cost_usd"],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.usage","typeLabel":"object"},"context":{"type":"object","properties":{"initial_context_tokens":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.context.initial_context_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.context.initial_context_tokens.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.context.initial_context_tokens","typeLabel":"integer | null"},"maximum_context_tokens":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.context.maximum_context_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.context.maximum_context_tokens.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.context.maximum_context_tokens","typeLabel":"integer | null"},"final_context_tokens":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.context.final_context_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.context.final_context_tokens.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.context.final_context_tokens","typeLabel":"integer | null"},"recap_count":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.context.recap_count.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.context.recap_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.context.recap_count","typeLabel":"integer | null"},"truncation_count":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.context.truncation_count.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.context.truncation_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.context.truncation_count","typeLabel":"integer | null"}},"required":["initial_context_tokens","maximum_context_tokens","final_context_tokens","recap_count","truncation_count"],"isRequired":true,"uniqueKey":"oneOf.3.chat.eval_trace.context","typeLabel":"object"}},"uniqueKey":"oneOf.3.chat.eval_trace","typeLabel":"object"}},"isRequired":true,"uniqueKey":"oneOf.3.chat","typeLabel":"object"}},"uniqueKey":"oneOf.3","typeLabel":"object"},{"type":"object","required":["type","chat"],"example":{"type":"tool_approval_request","chat":{"id":"cht_9x8y7z","assistant_id":"agt_1a2b3c","agent_id":"agt_1a2b3c","created":1730212800000,"created_date":"2024-10-29T14:00:00.000Z","content":"","research_mode":false,"output_format":"markdown","status":"approval_required","assistant_message_id":"msg_5f6g","approvals":[],"resume_supported":true}},"properties":{"type":{"type":"string","enum":["tool_approval_request"],"description":"Chat paused waiting for ask-first approval","isRequired":true,"uniqueKey":"oneOf.4.type","typeLabel":"enum\u003cstring>"},"chat":{"type":"object","description":"The paused chat","required":["id","assistant_id","agent_id","created","created_date","content","research_mode","output_format","status","assistant_message_id","approvals","resume_supported"],"example":{"id":"cht_9x8y7z","assistant_id":"agt_1a2b3c","agent_id":"agt_1a2b3c","created":1730210400000,"created_date":"2024-10-29T14:00:00.000Z","content":"","research_mode":false,"output_format":"markdown","status":"approval_required","assistant_message_id":"msg_5f6g","approvals":[],"resume_supported":true},"properties":{"id":{"type":"string","description":"Unique identifier for the chat","isRequired":true,"uniqueKey":"oneOf.4.chat.id","typeLabel":"string"},"assistant_id":{"type":"string","description":"Deprecated. Use agent_id instead.","isRequired":true,"uniqueKey":"oneOf.4.chat.assistant_id","typeLabel":"string"},"agent_id":{"type":"string","description":"The ID of the agent that processed the request","isRequired":true,"uniqueKey":"oneOf.4.chat.agent_id","typeLabel":"string"},"created":{"type":"number","description":"Unix timestamp in milliseconds of when the completion was created","isRequired":true,"uniqueKey":"oneOf.4.chat.created","typeLabel":"number"},"created_date":{"type":"string","description":"ISO 8601 formatted timestamp of when the completion was created","isRequired":true,"uniqueKey":"oneOf.4.chat.created_date","typeLabel":"string"},"content":{"type":"string","description":"The content of the chat","isRequired":true,"uniqueKey":"oneOf.4.chat.content","typeLabel":"string"},"research_mode":{"type":"boolean","description":"If research mode was used for this chat. The agent configuration can override the user requested value.","isRequired":true,"uniqueKey":"oneOf.4.chat.research_mode","typeLabel":"boolean"},"output_format":{"type":"string","enum":["markdown","text"],"description":"The format of the content returned","isRequired":true,"uniqueKey":"oneOf.4.chat.output_format","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["approval_required"],"description":"The chat is paused waiting for ask-first tool approval","isRequired":true,"uniqueKey":"oneOf.4.chat.status","typeLabel":"enum\u003cstring>"},"assistant_message_id":{"type":"string","description":"The assistant message that contains the pending approvals","isRequired":true,"uniqueKey":"oneOf.4.chat.assistant_message_id","typeLabel":"string"},"approvals":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["dynamic-tool"],"isRequired":true,"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"toolName":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].toolName","typeLabel":"string"},"toolCallId":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].toolCallId","typeLabel":"string"},"state":{"type":"string","enum":["input-streaming","input-available","approval-requested","approval-responded","output-streaming","output-available","output-error","output-denied"],"isRequired":true,"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].state","typeLabel":"enum\u003cstring>"},"title":{"type":"string","uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].title","typeLabel":"string"},"providerExecuted":{"type":"boolean","uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].providerExecuted","typeLabel":"boolean"},"input":{"oneOf":[{}],"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].input","typeLabel":"any"},"output":{"oneOf":[{}],"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].output","typeLabel":"any"},"partialInput":{"type":"string","uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].partialInput","typeLabel":"string"},"partialOutput":{"type":"string","uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].partialOutput","typeLabel":"string"},"errorText":{"type":"string","uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].errorText","typeLabel":"string"},"changesData":{"type":"boolean","default":false,"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].changesData","typeLabel":"boolean"},"reconnect":{"type":"object","properties":{"reason":{"type":"string","enum":["auth","forbidden"],"isRequired":true,"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].reconnect.reason","typeLabel":"enum\u003cstring>"},"kind":{"type":"string","enum":["mcp","connector"],"isRequired":true,"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].reconnect.kind","typeLabel":"enum\u003cstring>"},"toolId":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].reconnect.toolId","typeLabel":"string"},"connectorName":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].reconnect.connectorName.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].reconnect.connectorName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].reconnect.connectorName","typeLabel":"string | null"},"ownerUserId":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].reconnect.ownerUserId","typeLabel":"string"}},"required":["reason","kind","toolId","connectorName","ownerUserId"],"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].reconnect","typeLabel":"object"},"readableReference":{"type":"object","properties":{"reference":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].readableReference.reference","typeLabel":"string"},"title":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].readableReference.title","typeLabel":"string"},"content":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].readableReference.content","typeLabel":"string"},"toolName":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].readableReference.toolName","typeLabel":"string"},"toolCallId":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].readableReference.toolCallId","typeLabel":"string"}},"required":["reference","title","content","toolName","toolCallId"],"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].readableReference","typeLabel":"object"},"caller":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].caller.oneOf.0.type","typeLabel":"string"},"toolId":{"type":"string","uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].caller.oneOf.0.toolId","typeLabel":"string"},"tool_id":{"type":"string","uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].caller.oneOf.0.tool_id","typeLabel":"string"}},"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].caller.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"type":{"type":"string"},"toolId":{"type":"string"},"tool_id":{"type":"string"}},"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].caller.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].caller","typeLabel":"object | null"},"providerOptions":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].providerOptions.additionalProperties.additionalProperties","typeLabel":"any"},"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].providerOptions.additionalProperties","typeLabel":"object"},"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].providerOptions","typeLabel":"object"},"providerMetadata":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].providerMetadata.additionalProperties.additionalProperties","typeLabel":"any"},"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].providerMetadata.additionalProperties","typeLabel":"object"},"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].providerMetadata","typeLabel":"object"},"approval":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].approval.id","typeLabel":"string"},"approved":{"type":"boolean","uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].approval.approved","typeLabel":"boolean"},"reason":{"type":"string","uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].approval.reason","typeLabel":"string"},"modifiedInput":{"oneOf":[{}],"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].approval.modifiedInput","typeLabel":"any"},"modifiedInputDigest":{"type":"string","pattern":"^[a-f0-9]{64}$","uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].approval.modifiedInputDigest","typeLabel":"string"}},"required":["id"],"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].approval","typeLabel":"object"},"toolMetadata":{"type":"object","properties":{"logo":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].toolMetadata.logo","typeLabel":"string"},"serverDisplayName":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].toolMetadata.serverDisplayName","typeLabel":"string"},"displayName":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].toolMetadata.displayName","typeLabel":"string"},"description":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].toolMetadata.description","typeLabel":"string"},"serverType":{"type":"string","enum":["internal","external"],"isRequired":true,"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].toolMetadata.serverType","typeLabel":"enum\u003cstring>"},"inputSchema":{"oneOf":[{}],"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].toolMetadata.inputSchema","typeLabel":"any"}},"required":["logo","serverDisplayName","displayName","description","serverType"],"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX].toolMetadata","typeLabel":"object"}},"required":["type","toolName","toolCallId","state"],"uniqueKey":"oneOf.4.chat.approvals.items.[INDEX]","typeLabel":"object"},"description":"The tool approval requests that must be approved or rejected","isRequired":true,"uniqueKey":"oneOf.4.chat.approvals","typeLabel":"object[]"},"resume_supported":{"type":"boolean","enum":[true],"description":"Whether this paused chat can be resumed via the API","isRequired":true,"uniqueKey":"oneOf.4.chat.resume_supported","typeLabel":"enum\u003cboolean>"},"eval_trace":{"type":"object","description":"Normalized persisted partial turn trace returned only for authorized eval requests","required":["version","status","chat_id","user_message_id","assistant_message_id","langfuse_trace_id","model_override","reasoning_effort","served_models","started_at","completed_at","final_response","tool_calls","output_files","output_file_references","usage","context"],"properties":{"version":{"type":"number","enum":[1],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.version","typeLabel":"enum\u003cnumber>"},"status":{"type":"string","enum":["completed","approval_required","failed","aborted"],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.status","typeLabel":"enum\u003cstring>"},"chat_id":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.chat_id","typeLabel":"string"},"user_message_id":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.user_message_id","typeLabel":"string"},"assistant_message_id":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.assistant_message_id","typeLabel":"string"},"langfuse_trace_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.langfuse_trace_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.langfuse_trace_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.langfuse_trace_id","typeLabel":"string | null"},"model_override":{"oneOf":[{"type":"string","enum":["test","o1","o3","o1-mini","o3-mini","o4-mini","gpt-image-2","gpt-5.6-sol","gpt-5.6-sol-eu","gpt-5.6-terra","gpt-5.6-terra-eu","gpt-5.6-luna","gpt-5.6-luna-eu","gpt-6-sol","gpt-6-sol-eu","gpt-6-luna","gpt-6-luna-eu","gpt-6.1-sol","gpt-6.1-sol-eu","gpt-6.1-terra","gpt-6.1-terra-eu","gpt-5.5","gpt-5.5-eu","vertex-finetuned-1","vertex-finetuned-2","vertex-claude-3-7-sonnet@20250219","vertex-claude-3-5-sonnet@20240620","vertex-claude-3-5-sonnet-v2@20241022","vertex-claude-3-haiku@20240307","vertex-claude-3-opus@20240229","vertex-claude-opus-4@20250514","vertex-claude-sonnet-4@20250514","vertex-claude-sonnet-4-5@20250929","vertex-claude-opus-4-5@20251101","vertex-claude-opus-4-6@default","vertex-claude-opus-4-7@global","vertex-claude-opus-4-7@eu","vertex-claude-sonnet-5@eu","vertex-claude-sonnet-5-5@global","vertex-claude-sonnet-5-5@eu","vertex-claude-haiku-5-5@global","vertex-claude-haiku-5-5@eu","vertex-claude-opus-4-8@global","vertex-claude-opus-4-8@eu","vertex-claude-opus-5@global","vertex-claude-opus-5@eu","vertex-claude-opus-5-5@global","vertex-claude-opus-5-5@eu","vertex-claude-sonnet-4-6","vertex-claude-haiku-4-5@20251001","bedrock-anthropic.claude-opus-4-5-20251101-v1:0","bedrock-anthropic.claude-opus-4-6-v1","bedrock-anthropic.claude-opus-4-7","bedrock-anthropic.claude-opus-4-8","bedrock-anthropic.claude-opus-5","bedrock-anthropic.claude-sonnet-4-6","bedrock-anthropic.claude-sonnet-4-5-20250929-v1:0","bedrock-us-anthropic.claude-sonnet-4-20250514-v1:0","bedrock-eu-anthropic.claude-sonnet-4-20250514-v1:0","bedrock-eu-anthropic.claude-3-7-sonnet-20250219-v1:0","bedrock-eu-anthropic.claude-3-5-sonnet-20240620-v1:0","bedrock-eu-anthropic.claude-3-5-haiku-20241022-v1:0","bedrock-anthropic.claude-haiku-4-5-20251001-v1:0","claude-sonnet-4-20250514","claude-sonnet-4-6","claude-sonnet-5","claude-sonnet-5-5","claude-haiku-5-5","claude-opus-4-6","claude-opus-4-7","claude-opus-4-8","claude-opus-5","claude-opus-5-5","claude-haiku-4-5-20251001","claude-sonnet-4-5-20250929","claude-3-7-sonnet-latest","claude-3-7-sonnet-20250219","claude-3-5-sonnet-20241022","groq-mixtral","google-gemini-1.5-pro-001","google-gemini-1.5-flash-001","google-gemini-2.0-flash-001","google-gemini-2.5-pro","google-gemini-2.5-flash","google-gemini-2.5-flash-lite","google-gemini-2.5-flash-image","google-gemini-3.1-flash-lite","google-gemini-3.1-flash-lite-eu","google-gemini-3.1-flash-image","google-gemini-3.5-flash-lite","google-gemini-3.5-flash-lite-eu","google-gemini-3.5-flash","google-gemini-3.5-flash-eu","google-gemini-3.6-flash","google-gemini-3.7-flash","google-gemini-3.7-flash-eu","google-gemini-3.8-flash","google-gemini-3.8-flash-eu","gemini-2.0-flash-001","gemini-2.5-pro","gemini-2.5-flash","gemini-2.5-flash-lite","gemini-2.5-flash-image","gemini-3.1-flash-lite","gemini-3.1-flash-image","gemini-3.5-flash-lite","gemini-3.5-flash","gemini-3.6-flash","gemini-3.7-flash","gemini-3.8-flash","gemini-3-pro","gemini-3-flash","google-gemini-3-flash","google-gemini-3-pro","finetuned-mini","finetuned-mini-2","finetuned-mini-3","finetuned-filtersearch-1","finetuned-gpt41mini-1","finetuned-4o","qwen-7b","flow-judge","llama-3.2-3b","cerebras-llama-3.3-70b","tensorx-deepseek-v4-flash","tensorx-deepseek-v4-flash-0731","tensorx-qwen3.8-flash-next","scaleway-deepseek-v4-flash-0731","lyceum-deepseek-v4-flash-0731","lyceum-qwen3.8-flash-next","fireworks-deepseek-v4-flash-0731","baseten-deepseek-v4-flash-0731","gmicloud-deepseek-v4-flash","gmicloud-qwen3.8-flash","digitalocean-deepseek-v4-flash-0731","deepseek-v4-1-flash","novita-deepseek-v4-1-flash","fireworks-deepseek-v4-1-flash","gmicloud-deepseek-v4-1-flash","baseten-deepseek-v4-1-flash","digitalocean-deepseek-v4-1-flash","tensorx-deepseek-v4-1-flash","scaleway-deepseek-v4-1-flash","mistral-large-4","digitalocean-mimo-v2.5","fireworks-glm-5.3-flash"],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.model_override.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["test","o1","o3","o1-mini","o3-mini","o4-mini","gpt-image-2","gpt-5.6-sol","gpt-5.6-sol-eu","gpt-5.6-terra","gpt-5.6-terra-eu","gpt-5.6-luna","gpt-5.6-luna-eu","gpt-6-sol","gpt-6-sol-eu","gpt-6-luna","gpt-6-luna-eu","gpt-6.1-sol","gpt-6.1-sol-eu","gpt-6.1-terra","gpt-6.1-terra-eu","gpt-5.5","gpt-5.5-eu","vertex-finetuned-1","vertex-finetuned-2","vertex-claude-3-7-sonnet@20250219","vertex-claude-3-5-sonnet@20240620","vertex-claude-3-5-sonnet-v2@20241022","vertex-claude-3-haiku@20240307","vertex-claude-3-opus@20240229","vertex-claude-opus-4@20250514","vertex-claude-sonnet-4@20250514","vertex-claude-sonnet-4-5@20250929","vertex-claude-opus-4-5@20251101","vertex-claude-opus-4-6@default","vertex-claude-opus-4-7@global","vertex-claude-opus-4-7@eu","vertex-claude-sonnet-5@eu","vertex-claude-sonnet-5-5@global","vertex-claude-sonnet-5-5@eu","vertex-claude-haiku-5-5@global","vertex-claude-haiku-5-5@eu","vertex-claude-opus-4-8@global","vertex-claude-opus-4-8@eu","vertex-claude-opus-5@global","vertex-claude-opus-5@eu","vertex-claude-opus-5-5@global","vertex-claude-opus-5-5@eu","vertex-claude-sonnet-4-6","vertex-claude-haiku-4-5@20251001","bedrock-anthropic.claude-opus-4-5-20251101-v1:0","bedrock-anthropic.claude-opus-4-6-v1","bedrock-anthropic.claude-opus-4-7","bedrock-anthropic.claude-opus-4-8","bedrock-anthropic.claude-opus-5","bedrock-anthropic.claude-sonnet-4-6","bedrock-anthropic.claude-sonnet-4-5-20250929-v1:0","bedrock-us-anthropic.claude-sonnet-4-20250514-v1:0","bedrock-eu-anthropic.claude-sonnet-4-20250514-v1:0","bedrock-eu-anthropic.claude-3-7-sonnet-20250219-v1:0","bedrock-eu-anthropic.claude-3-5-sonnet-20240620-v1:0","bedrock-eu-anthropic.claude-3-5-haiku-20241022-v1:0","bedrock-anthropic.claude-haiku-4-5-20251001-v1:0","claude-sonnet-4-20250514","claude-sonnet-4-6","claude-sonnet-5","claude-sonnet-5-5","claude-haiku-5-5","claude-opus-4-6","claude-opus-4-7","claude-opus-4-8","claude-opus-5","claude-opus-5-5","claude-haiku-4-5-20251001","claude-sonnet-4-5-20250929","claude-3-7-sonnet-latest","claude-3-7-sonnet-20250219","claude-3-5-sonnet-20241022","groq-mixtral","google-gemini-1.5-pro-001","google-gemini-1.5-flash-001","google-gemini-2.0-flash-001","google-gemini-2.5-pro","google-gemini-2.5-flash","google-gemini-2.5-flash-lite","google-gemini-2.5-flash-image","google-gemini-3.1-flash-lite","google-gemini-3.1-flash-lite-eu","google-gemini-3.1-flash-image","google-gemini-3.5-flash-lite","google-gemini-3.5-flash-lite-eu","google-gemini-3.5-flash","google-gemini-3.5-flash-eu","google-gemini-3.6-flash","google-gemini-3.7-flash","google-gemini-3.7-flash-eu","google-gemini-3.8-flash","google-gemini-3.8-flash-eu","gemini-2.0-flash-001","gemini-2.5-pro","gemini-2.5-flash","gemini-2.5-flash-lite","gemini-2.5-flash-image","gemini-3.1-flash-lite","gemini-3.1-flash-image","gemini-3.5-flash-lite","gemini-3.5-flash","gemini-3.6-flash","gemini-3.7-flash","gemini-3.8-flash","gemini-3-pro","gemini-3-flash","google-gemini-3-flash","google-gemini-3-pro","finetuned-mini","finetuned-mini-2","finetuned-mini-3","finetuned-filtersearch-1","finetuned-gpt41mini-1","finetuned-4o","qwen-7b","flow-judge","llama-3.2-3b","cerebras-llama-3.3-70b","tensorx-deepseek-v4-flash","tensorx-deepseek-v4-flash-0731","tensorx-qwen3.8-flash-next","scaleway-deepseek-v4-flash-0731","lyceum-deepseek-v4-flash-0731","lyceum-qwen3.8-flash-next","fireworks-deepseek-v4-flash-0731","baseten-deepseek-v4-flash-0731","gmicloud-deepseek-v4-flash","gmicloud-qwen3.8-flash","digitalocean-deepseek-v4-flash-0731","deepseek-v4-1-flash","novita-deepseek-v4-1-flash","fireworks-deepseek-v4-1-flash","gmicloud-deepseek-v4-1-flash","baseten-deepseek-v4-1-flash","digitalocean-deepseek-v4-1-flash","tensorx-deepseek-v4-1-flash","scaleway-deepseek-v4-1-flash","mistral-large-4","digitalocean-mimo-v2.5","fireworks-glm-5.3-flash"],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.model_override.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.model_override","typeLabel":"enum\u003cstring> | null"},"reasoning_effort":{"oneOf":[{"type":"string","enum":["low","medium","high","max"],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.reasoning_effort.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["low","medium","high","max"],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.reasoning_effort.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.reasoning_effort","typeLabel":"enum\u003cstring> | null"},"served_models":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"oneOf.4.chat.eval_trace.served_models.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Models that completed calls during the turn, in call order. Null means model telemetry was unavailable.","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.served_models.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"Models that completed calls during the turn, in call order. Null means model telemetry was unavailable.","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.served_models.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.served_models","typeLabel":"string[] | null"},"started_at":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.started_at","typeLabel":"string"},"completed_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.completed_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.completed_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.completed_at","typeLabel":"string | null"},"final_response":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.final_response.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.final_response.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.final_response","typeLabel":"string | null"},"tool_calls":{"type":"array","items":{"type":"object","properties":{"sequence":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].sequence","typeLabel":"integer"},"tool_call_id":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].tool_call_id","typeLabel":"string"},"parent_tool_call_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].parent_tool_call_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].parent_tool_call_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].parent_tool_call_id","typeLabel":"string | null"},"source":{"type":"string","enum":["realm","provider"],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].source","typeLabel":"enum\u003cstring>"},"raw_tool_name":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].raw_tool_name","typeLabel":"string"},"connector":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].connector.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].connector.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].connector","typeLabel":"string | null"},"action":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].action","typeLabel":"string"},"requested_input":{"oneOf":[{"isRequired":true}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].requested_input","typeLabel":"any"},"requested_input_truncated":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].requested_input_truncated","typeLabel":"boolean"},"status":{"type":"string","enum":["proposed","approval_required","denied","succeeded","failed"],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"approval":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","enum":["requested","approved","denied"],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].approval.oneOf.0.status","typeLabel":"enum\u003cstring>"},"reason":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].approval.oneOf.0.reason.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].approval.oneOf.0.reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].approval.oneOf.0.reason","typeLabel":"string | null"}},"required":["status","reason"],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].approval.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"status":{"type":"string","enum":["requested","approved","denied"]},"reason":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["status","reason"],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].approval.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].approval","typeLabel":"object | null"},"output":{"oneOf":[{"isRequired":true}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].output","typeLabel":"any"},"output_truncated":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].output_truncated","typeLabel":"boolean"},"error":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].error.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX].error","typeLabel":"string | null"}},"required":["sequence","tool_call_id","parent_tool_call_id","source","raw_tool_name","connector","action","requested_input","requested_input_truncated","status","approval","output","output_truncated","error"],"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.tool_calls","typeLabel":"object[]"},"output_files":{"type":"array","items":{"type":"object","properties":{"file_path":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.output_files.items.[INDEX].file_path","typeLabel":"string"},"file_name":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.output_files.items.[INDEX].file_name","typeLabel":"string"},"mime_type":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.output_files.items.[INDEX].mime_type.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.output_files.items.[INDEX].mime_type.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.output_files.items.[INDEX].mime_type","typeLabel":"string | null"},"download_url":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.output_files.items.[INDEX].download_url","typeLabel":"string"}},"required":["file_path","file_name","mime_type","download_url"],"uniqueKey":"oneOf.4.chat.eval_trace.output_files.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.output_files","typeLabel":"object[]"},"output_file_references":{"type":"array","items":{"type":"object","properties":{"reference":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.output_file_references.items.[INDEX].reference","typeLabel":"string"},"file_path":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.output_file_references.items.[INDEX].file_path","typeLabel":"string"},"file_name":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.output_file_references.items.[INDEX].file_name","typeLabel":"string"}},"required":["reference","file_path","file_name"],"uniqueKey":"oneOf.4.chat.eval_trace.output_file_references.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.output_file_references","typeLabel":"object[]"},"usage":{"type":"object","properties":{"model_calls":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.model_calls.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.model_calls.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.model_calls","typeLabel":"integer | null"},"agent_steps":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.agent_steps.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.agent_steps.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.agent_steps","typeLabel":"integer | null"},"input_tokens":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.input_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.input_tokens.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.input_tokens","typeLabel":"integer | null"},"output_tokens":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.output_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.output_tokens.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.output_tokens","typeLabel":"integer | null"},"total_tokens":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.total_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.total_tokens.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.total_tokens","typeLabel":"integer | null"},"cache_read_input_tokens":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.cache_read_input_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.cache_read_input_tokens.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.cache_read_input_tokens","typeLabel":"integer | null"},"cache_write_input_tokens":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.cache_write_input_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.cache_write_input_tokens.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.cache_write_input_tokens","typeLabel":"integer | null"},"provider_cost_usd":{"oneOf":[{"type":"number","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.provider_cost_usd.oneOf.0","typeLabel":"number"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.provider_cost_usd.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage.provider_cost_usd","typeLabel":"number | null"}},"required":["model_calls","agent_steps","input_tokens","output_tokens","total_tokens","cache_read_input_tokens","cache_write_input_tokens","provider_cost_usd"],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.usage","typeLabel":"object"},"context":{"type":"object","properties":{"initial_context_tokens":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.context.initial_context_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.context.initial_context_tokens.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.context.initial_context_tokens","typeLabel":"integer | null"},"maximum_context_tokens":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.context.maximum_context_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.context.maximum_context_tokens.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.context.maximum_context_tokens","typeLabel":"integer | null"},"final_context_tokens":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.context.final_context_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.context.final_context_tokens.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.context.final_context_tokens","typeLabel":"integer | null"},"recap_count":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.context.recap_count.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.context.recap_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.context.recap_count","typeLabel":"integer | null"},"truncation_count":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.context.truncation_count.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.context.truncation_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.context.truncation_count","typeLabel":"integer | null"}},"required":["initial_context_tokens","maximum_context_tokens","final_context_tokens","recap_count","truncation_count"],"isRequired":true,"uniqueKey":"oneOf.4.chat.eval_trace.context","typeLabel":"object"}},"uniqueKey":"oneOf.4.chat.eval_trace","typeLabel":"object"}},"isRequired":true,"uniqueKey":"oneOf.4.chat","typeLabel":"object"}},"uniqueKey":"oneOf.4","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"generation_tokens","text":"Your Q3 revenue grew ","id":"cht_9x8y7z","full":false}}},"exampleType":"generated"}},"exampleType":"generated"},"9f337854-8129-40f1-a105-6bb4d2f6b219":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"string","uniqueKey":"details","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","details":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"08360815-c053-41be-b6d1-4e804cff6ce3":{"description":"Unauthorized: missing or invalid API token","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"4ae529de-72d3-49f2-9bd8-befff69934f0":{"description":"Forbidden: the API token lacks the required scope, or external API access is not available on the organization's plan","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"23fbd2b7-dbe1-47b6-9dd2-01997719cccd":{"description":"Too many requests: rate limit exceeded. Retry after the number of seconds in the Retry-After response header.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"c871fb25-6faa-4e42-8680-c70108bf2794":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"a9726d59-af1b-4abb-ace4-454a818fae3b":{"bearerAuth":{"type":"http","scheme":"bearer","x-default":"YOUR_API_TOKEN","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"431afb04-1374-49ce-bbad-67a46887ccd4":{"url":"https://app.withrealm.com/api/external/alpha","description":"Default multi-tenant environment."},"b02b8b10-d94b-41f3-a656-a53db0a82ee7":{"url":"https://{tenant}.withrealm.com/api/external/alpha","description":"Single-tenant deployment.","variables":{"tenant":{"default":"your-tenant","description":"Your organization's tenant subdomain."}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","x-default":"YOUR_API_TOKEN","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","default":"YOUR_API_TOKEN","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"realm","siteName":"Realm Docs","title":"Create or continue a chat with a streaming response - Realm Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T10:13:53.501Z","originalFileLocation":"api-reference/chats/create-or-continue-a-chat-with-a-streaming-response.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create a chat with a specific agent, or continue an existing chat. Any document that you have access to that is in the agent\u0026#x27;s knowledge base could be used to answer questions. ### Rate Limits 600 requests per minute.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Realm Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/realm/dEivnKfuuuk4hLGf/_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/realm/dEivnKfuuuk4hLGf/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/realm/dEivnKfuuuk4hLGf/_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/realm/dEivnKfuuuk4hLGf/_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/realm/dEivnKfuuuk4hLGf/_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/realm/dEivnKfuuuk4hLGf/_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/realm/dEivnKfuuuk4hLGf/_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/realm/dEivnKfuuuk4hLGf/_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/realm/dEivnKfuuuk4hLGf/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create or continue a chat with a streaming response - Realm Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a chat with a specific agent, or continue an existing chat. Any document that you have access to that is in the agent\u0026#x27;s knowledge base could be used to answer questions. ### Rate Limits 600 requests per minute.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Realm Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.withrealm.com/api-reference/chats/create-or-continue-a-chat-with-a-streaming-response\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://realm.mintlify.app/_mintlify/api/og/v2?division=Chats\u0026amp;title=Create+or+continue+a+chat+with+a+streaming+response\u0026amp;description=Create+a+chat+with+a+specific+agent%2C+or+continue+an+existing+chat.+Any+document+that+you+have+access+to+that+is+in+the+agent%27s+knowledge+base+could+be+used+to+a\u0026amp;theme=3d9dc63a89e98274c40227ce\u0026amp;signature=e898baae5550a39835c873b662b7ff814f65db87f7bb280f02e25cfc9a046a1d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create or continue a chat with a streaming response - Realm Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a chat with a specific agent, or continue an existing chat. Any document that you have access to that is in the agent\u0026#x27;s knowledge base could be used to answer questions. ### Rate Limits 600 requests per minute.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://realm.mintlify.app/_mintlify/api/og/v2?division=Chats\u0026amp;title=Create+or+continue+a+chat+with+a+streaming+response\u0026amp;description=Create+a+chat+with+a+specific+agent%2C+or+continue+an+existing+chat.+Any+document+that+you+have+access+to+that+is+in+the+agent%27s+knowledge+base+could+be+used+to+a\u0026amp;theme=3d9dc63a89e98274c40227ce\u0026amp;signature=e898baae5550a39835c873b662b7ff814f65db87f7bb280f02e25cfc9a046a1d\">\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/realm/dEivnKfuuuk4hLGf/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Realm Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#248573\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.withrealm.com/api-reference/chats/create-or-continue-a-chat-with-a-streaming-response\">\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/create-or-continue-a-chat-with-a-streaming-response.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.withrealm.com/#organization\",\"name\":\"Realm Docs\",\"url\":\"https://docs.withrealm.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/realm/Gmuvv21dZKngXNE6/logo/realm-logo-black.png?fit=max\u0026auto=format\u0026n=Gmuvv21dZKngXNE6\u0026q=85\u0026s=054d513f37788181ce2c55d4757fd72e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.withrealm.com#website\",\"name\":\"Realm Docs\",\"url\":\"https://docs.withrealm.com\",\"publisher\":{\"@id\":\"https://docs.withrealm.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.withrealm.com/api-reference/chats/create-or-continue-a-chat-with-a-streaming-response#webpage\",\"url\":\"https://docs.withrealm.com/api-reference/chats/create-or-continue-a-chat-with-a-streaming-response\",\"name\":\"Create or continue a chat with a streaming response\",\"description\":\"Create a chat with a specific agent, or continue an existing chat. Any document that you have access to that is in the agent's knowledge base could be used to answer questions. ### Rate Limits 600 requests per minute.\",\"dateModified\":\"2026-10-30T10:13:53.501Z\",\"isPartOf\":{\"@id\":\"https://docs.withrealm.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.withrealm.com/api-reference/chats/create-or-continue-a-chat-with-a-streaming-response#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.withrealm.com/api-reference/chats/create-or-continue-a-chat-with-a-streaming-response#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API reference\",\"item\":\"https://docs.withrealm.com/api-reference/connectors/list-api-data-sources\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Chats\",\"item\":\"https://docs.withrealm.com/api-reference/chats/list-chats\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create or continue a chat with a streaming response\",\"item\":\"https://docs.withrealm.com/api-reference/chats/create-or-continue-a-chat-with-a-streaming-response\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.withrealm.com/api-reference/chats/create-or-continue-a-chat-with-a-streaming-response#apireference\",\"headline\":\"Create or continue a chat with a streaming response\",\"name\":\"Create or continue a chat with a streaming response\",\"description\":\"Create a chat with a specific agent, or continue an existing chat. Any document that you have access to that is in the agent's knowledge base could be used to answer questions. ### Rate Limits 600 requests per minute.\",\"url\":\"https://docs.withrealm.com/api-reference/chats/create-or-continue-a-chat-with-a-streaming-response\",\"mainEntityOfPage\":{\"@id\":\"https://docs.withrealm.com/api-reference/chats/create-or-continue-a-chat-with-a-streaming-response#webpage\"},\"dateModified\":\"2026-10-30T10:13:53.501Z\",\"publisher\":{\"@id\":\"https://docs.withrealm.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.withrealm.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Realm Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Realm Docs","nav":{"global":{"anchors":[{"anchor":"Product updates","icon":"sparkles","href":"/product-updates"},{"anchor":"Changelog","icon":"newspaper","href":"/changelog"},{"anchor":"Status","icon":"signal-bars","href":"https://status.withrealm.com/"}]},"tabs":[{"tab":"User guide","pages":[{"title":"User guide","href":"/introduction"}]},{"tab":"Admin guide","pages":[{"title":"Admin guide","href":"/admin/overview"}]},{"tab":"API docs","groups":[{"group":"API documentation","pages":[{"title":"API Introduction","href":"/api-reference/introduction"}]},{"group":"API reference","pages":[{"group":"Data sources","pages":[{"title":"List API data sources","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /connectors","href":"/api-reference/connectors/list-api-data-sources"}]},{"group":"Chats","pages":[{"title":"List chats","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /chats","href":"/api-reference/chats/list-chats"},{"title":"Create or continue a chat","description":"Create a chat with a specific agent, or continue an existing chat. Any document that you have access to that is in the agent's knowledge base could be used to answer questions.\n\n### Rate Limits\n\n600 requests per minute.","deprecated":null,"version":null,"sidebarTitle":"Create chat","openapi":"/api-reference/openapi.json post /chats","href":"/api-reference/chats/create-or-continue-a-chat"},{"title":"Create or continue a chat with a streaming response","deprecated":null,"version":null,"sidebarTitle":"Create chat (streaming)","openapi":"/api-reference/openapi.json post /chats-streaming","href":"/api-reference/chats/create-or-continue-a-chat-with-a-streaming-response"},{"title":"Get chat's messages","description":"Get a stored chat's messages.\n\n### Rate Limits\n\n600 requests per minute.","deprecated":null,"version":null,"sidebarTitle":"Get messages","openapi":"/api-reference/openapi.json get /chats/{chat_id}","href":"/api-reference/chats/get-chats-messages"},{"title":"Delete a chat","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /chats/{chat_id}","href":"/api-reference/chats/delete-a-chat"},{"title":"Resume a paused chat after tool approval","deprecated":null,"version":null,"sidebarTitle":"Resume approvals","openapi":"/api-reference/openapi.json post /chats/{chat_id}/approvals","href":"/api-reference/chats/resume-a-paused-chat-after-tool-approval"}]},{"group":"Documents","pages":[{"title":"Get a document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /documents/{data_source_id}/{document_id}","href":"/api-reference/documents/get-a-document"},{"title":"Delete a document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /documents/{data_source_id}/{document_id}","href":"/api-reference/documents/delete-a-document"},{"title":"List documents for a connector","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /documents/{data_source_id}","href":"/api-reference/documents/list-documents-for-a-connector"},{"title":"Upsert documents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /documents/{data_source_id}","href":"/api-reference/documents/upsert-documents"},{"title":"Delete documents older than a specified timestamp","deprecated":null,"version":null,"sidebarTitle":"Delete older documents","openapi":"/api-reference/openapi.json delete /documents/{data_source_id}","href":"/api-reference/documents/delete-documents-older-than-a-specified-timestamp"},{"title":"Upload a file","deprecated":null,"version":null,"sidebarTitle":"Upload file","openapi":"/api-reference/openapi.json post /documents/{data_source_id}/upload","href":"/api-reference/documents/upload-a-file"}]},{"group":"Agents","pages":[{"title":"List agents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents","href":"/api-reference/agents/list-agents"}]}]}]}]},"basePath":"","title":"Create or continue a chat with a streaming response - Realm Docs","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}