import Cerca from '@cerca-dev/sdk';const client = new Cerca({ apiKey: process.env['CERCA_API_KEY'], // This is the default and can be omitted});const subscriptionEvent = await client.events.streamForThreadEvents( 'agent_abc123', 'thread_abc123',);console.log(subscriptionEvent.event);
import os
from cerca import Cerca
client = Cerca(
api_key=os.environ.get("CERCA_API_KEY"), # This is the default and can be omitted
)
for event in client.events.stream_for_thread_events(
agent_id="agent_abc123",
thread_id="thread_abc123",
):
print(event)
require "cerca"
cerca = Cerca::Client.new(api_key: "My API Key")
subscription_event = cerca.events.stream_for_thread_events("agent_abc123", "thread_abc123")
puts(subscription_event)
cerca events stream-for-thread-events \
--api-key 'My API Key' \
--agent-id agent_abc123 \
--thread-id thread_abc123
Server-Sent Events stream. Each SSE data frame is JSON matching this response schema.
GET
/
agents
/
{agentId}
/
threads
/
{threadId}
/
events
/
stream
JavaScript
import Cerca from '@cerca-dev/sdk';const client = new Cerca({ apiKey: process.env['CERCA_API_KEY'], // This is the default and can be omitted});const subscriptionEvent = await client.events.streamForThreadEvents( 'agent_abc123', 'thread_abc123',);console.log(subscriptionEvent.event);
import os
from cerca import Cerca
client = Cerca(
api_key=os.environ.get("CERCA_API_KEY"), # This is the default and can be omitted
)
for event in client.events.stream_for_thread_events(
agent_id="agent_abc123",
thread_id="thread_abc123",
):
print(event)
require "cerca"
cerca = Cerca::Client.new(api_key: "My API Key")
subscription_event = cerca.events.stream_for_thread_events("agent_abc123", "thread_abc123")
puts(subscription_event)
cerca events stream-for-thread-events \
--api-key 'My API Key' \
--agent-id agent_abc123 \
--thread-id thread_abc123
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cerca","description":"Build long-running agents on Cloudflare Workers with durable execution, custom tools, approvals, memory, and a cloud sandbox.","colors":{"primary":"#7C6340","light":"#E8E0D2","dark":"#7C6340"},"logo":{"light":"https://mintcdn.com/cerca/avU2YjV-ayl9ITnW/logo/light.svg?fit=max\u0026auto=format\u0026n=avU2YjV-ayl9ITnW\u0026q=85\u0026s=3a952f50a305b017db4af3b52443e78d","dark":"https://mintcdn.com/cerca/avU2YjV-ayl9ITnW/logo/dark.svg?fit=max\u0026auto=format\u0026n=avU2YjV-ayl9ITnW\u0026q=85\u0026s=f30eef939f273f15687674dc8671f91a","href":"https://docs.cerca.dev"},"favicon":"https://mintcdn.com/cerca/avU2YjV-ayl9ITnW/favicon.svg?fit=max\u0026auto=format\u0026n=avU2YjV-ayl9ITnW\u0026q=85\u0026s=5c0a8c9a4b99f21be8bf0fa07e2d420e","background":{"color":{"light":"#FFFDF8","dark":"#141008"}},"navbar":{"links":[{"href":"https://app.cerca.dev/sign-in","label":"Sign in"}],"primary":{"type":"button","label":"Get an API key","href":"https://app.cerca.dev/settings"}},"footer":{"socials":{"github":"https://github.com/matrices"}},"seo":{"indexing":"navigable"},"icons":{"library":"lucide"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Changelog","icon":"list","href":"/changelog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cerca","hasAudioNarration":false,"actualSubdomain":"cerca","customDomains":["docs.cerca.dev"],"gitSource":{"type":"github","owner":"matrices","repo":"cell","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21ddd929c7042dd5f5fa13","collectionId":"ba226a70-e5d2-440b-8ce9-16ef02e5ae18","schemaVersion":"v2"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a303907bbaa514ac1c6776e:failure","clientVersion":"0.0.3964","searchFilterCounts":[{"language":"default","tag":"API Reference","count":66},{"language":"default","tag":"Guides","count":17},{"language":"default","tag":"Threads","count":10},{"language":"default","tag":"Concepts","count":9},{"language":"default","tag":"Core concepts","count":9},{"language":"default","tag":"Agents","count":7},{"language":"default","tag":"Events","count":7},{"language":"default","tag":"Webhooks","count":7},{"language":"default","tag":"Approvals","count":6},{"language":"default","tag":"Connections","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","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":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/events/thread-event-stream","slug":"/api-reference/events/thread-event-stream","pageMetadata":{"title":"Thread event stream","description":"Server-Sent Events stream. Each SSE data frame is JSON matching this response schema.","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /agents/{agentId}/threads/{threadId}/events/stream","href":"/api-reference/events/thread-event-stream","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Server-Sent Events stream. Each SSE data frame is JSON matching this response schema.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Thread event stream","description":"Server-Sent Events stream. Each SSE data frame is JSON matching this response schema.","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /agents/{agentId}/threads/{threadId}/events/stream","href":"/api-reference/events/thread-event-stream","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Server-Sent Events stream. Each SSE data frame is JSON matching this response schema.","security":["61e5bb0b-3bca-4a8f-be42-578fb7637855"],"summary":"Thread event stream","tags":["Events"],"x-stainless-event-stream":true,"parameters":["82b17347-c912-4ceb-acec-4fe2b8c61bc5","baa2f346-7f09-43cc-9347-3e9b7d6d6d4b","0e91f0d8-bbe7-46e2-acf0-19fb668217f4","39928f8b-e218-4162-b245-cc4253da902f","629d6935-62d3-4bdd-9400-b35c4f12740e","309f7928-15c5-401b-af96-763e65e4a867"],"responses":{"200":"117b1b45-bc35-419e-85a4-a42b453f37d9","400":"9b10ded3-d361-428d-840e-a448997ba7de","401":"d964690e-7b77-4e88-b818-3754177d65bb","403":"599e5f07-2667-425f-962b-022e84276d1c","404":"41fc0bbf-0859-4b08-9959-24d18d399cf6","429":"4fb2667a-ff8b-4acd-b65c-9c95df343617","503":"abb2315f-9ea6-4efc-9f28-caea5ffebb45","default":"9f5a527a-efc3-4560-94c8-c413c99d7661"},"x-codeSamples":[{"lang":"JavaScript","source":"import Cerca from '@cerca-dev/sdk';\n\nconst client = new Cerca({\n apiKey: process.env['CERCA_API_KEY'], // This is the default and can be omitted\n});\n\nconst subscriptionEvent = await client.events.streamForThreadEvents(\n 'agent_abc123',\n 'thread_abc123',\n);\n\nconsole.log(subscriptionEvent.event);"},{"lang":"Python","source":"import os\nfrom cerca import Cerca\n\nclient = Cerca(\n api_key=os.environ.get(\"CERCA_API_KEY\"), # This is the default and can be omitted\n)\nfor event in client.events.stream_for_thread_events(\n agent_id=\"agent_abc123\",\n thread_id=\"thread_abc123\",\n):\n print(event)"},{"lang":"Go","source":"package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/matrices/cerca-go\"\n\t\"github.com/matrices/cerca-go/option\"\n)\n\nfunc main() {\n\tclient := cercago.NewClient(\n\t\toption.WithAPIKey(\"My API Key\"),\n\t)\n\tstream := client.Events.StreamForThreadEventsStreaming(\n\t\tcontext.TODO(),\n\t\t\"agent_abc123\",\n\t\t\"thread_abc123\",\n\t\tcercago.EventStreamForThreadEventsParams{},\n\t)\n\tfor stream.Next() {\n\t\tfmt.Printf(\"%+v\\n\", stream.Current())\n\t}\n\terr := stream.Err()\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n}\n"},{"lang":"Ruby","source":"require \"cerca\"\n\ncerca = Cerca::Client.new(api_key: \"My API Key\")\n\nsubscription_event = cerca.events.stream_for_thread_events(\"agent_abc123\", \"thread_abc123\")\n\nputs(subscription_event)"},{"lang":"CLI","source":"cerca events stream-for-thread-events \\\n --api-key 'My API Key' \\\n --agent-id agent_abc123 \\\n --thread-id thread_abc123"}],"method":"get","type":"path","servers":["d2b2aefa-8204-4fa4-b0ac-351a68bfe8fe"],"path":"/agents/{agentId}/threads/{threadId}/events/stream","baseUrlOptions":["https://api.cerca.dev"],"title":"Thread event stream","codeSamples":[{"lang":"JavaScript","source":"import Cerca from '@cerca-dev/sdk';\n\nconst client = new Cerca({\n apiKey: process.env['CERCA_API_KEY'], // This is the default and can be omitted\n});\n\nconst subscriptionEvent = await client.events.streamForThreadEvents(\n 'agent_abc123',\n 'thread_abc123',\n);\n\nconsole.log(subscriptionEvent.event);"},{"lang":"Python","source":"import os\nfrom cerca import Cerca\n\nclient = Cerca(\n api_key=os.environ.get(\"CERCA_API_KEY\"), # This is the default and can be omitted\n)\nfor event in client.events.stream_for_thread_events(\n agent_id=\"agent_abc123\",\n thread_id=\"thread_abc123\",\n):\n print(event)"},{"lang":"Go","source":"package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/matrices/cerca-go\"\n\t\"github.com/matrices/cerca-go/option\"\n)\n\nfunc main() {\n\tclient := cercago.NewClient(\n\t\toption.WithAPIKey(\"My API Key\"),\n\t)\n\tstream := client.Events.StreamForThreadEventsStreaming(\n\t\tcontext.TODO(),\n\t\t\"agent_abc123\",\n\t\t\"thread_abc123\",\n\t\tcercago.EventStreamForThreadEventsParams{},\n\t)\n\tfor stream.Next() {\n\t\tfmt.Printf(\"%+v\\n\", stream.Current())\n\t}\n\terr := stream.Err()\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n}\n"},{"lang":"Ruby","source":"require \"cerca\"\n\ncerca = Cerca::Client.new(api_key: \"My API Key\")\n\nsubscription_event = cerca.events.stream_for_thread_events(\"agent_abc123\", \"thread_abc123\")\n\nputs(subscription_event)"},{"lang":"CLI","source":"cerca events stream-for-thread-events \\\n --api-key 'My API Key' \\\n --agent-id agent_abc123 \\\n --thread-id thread_abc123"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"82b17347-c912-4ceb-acec-4fe2b8c61bc5":{"schema":{"type":"string","minLength":1,"example":"agent_abc123","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"in":"path","name":"agentId"},"baa2f346-7f09-43cc-9347-3e9b7d6d6d4b":{"schema":{"type":"string","minLength":1,"example":"thread_abc123","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"in":"path","name":"threadId"},"0e91f0d8-bbe7-46e2-acf0-19fb668217f4":{"schema":{"type":"string","description":"Opaque pagination cursor returned by a previous request.","example":"cursor_abc123","isRequired":false,"uniqueKey":"","typeLabel":"string"},"required":false,"description":"Opaque pagination cursor returned by a previous request.","name":"cursor","in":"query"},"39928f8b-e218-4162-b245-cc4253da902f":{"schema":{"type":"string","description":"Comma-separated event type filter.","example":"thread.created,thread.completed","isRequired":false,"uniqueKey":"","typeLabel":"string"},"required":false,"description":"Comma-separated event type filter.","name":"events","in":"query"},"629d6935-62d3-4bdd-9400-b35c4f12740e":{"schema":{"type":"string","enum":["true","false"],"description":"When true, starts from the beginning of the retained buffer.","example":"true","isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"},"required":false,"description":"When true, starts from the beginning of the retained buffer.","name":"history","in":"query"},"309f7928-15c5-401b-af96-763e65e4a867":{"schema":{"type":"string","description":"Resume an event-log stream after the last received SSE event id.","example":"4711","isRequired":false,"uniqueKey":"","typeLabel":"string"},"required":false,"description":"Resume an event-log stream after the last received SSE event id.","in":"header","name":"Last-Event-ID"}},"responses":{"117b1b45-bc35-419e-85a4-a42b453f37d9":{"description":"Thread event stream","content":{"text/event-stream":{"schema":{"type":"object","properties":{"event":{"oneOf":[{"type":"object","title":"AgentCreatedWebhookEvent","required":["agentId","fleetId","id","orgId","threadId","timestamp","data","event"],"x-stainless-variantName":"AgentCreatedWebhookEvent","properties":{"agentId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.0.agentId","typeLabel":"string"},"fleetId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.0.fleetId","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.0.id","typeLabel":"string"},"orgId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.0.orgId","typeLabel":"string"},"threadId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.0.threadId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.0.threadId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.0.threadId","typeLabel":"string | null"},"timestamp":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.0.timestamp","typeLabel":"string"},"data":{"type":"object","properties":{"agent":{"type":"object","properties":{"configuration":{"type":"object","properties":{"approvals":{"type":"object","properties":{"tools":{"type":"object","additionalProperties":{"type":"string","enum":["always","never"],"uniqueKey":"event.oneOf.0.data.agent.configuration.approvals.tools.additionalProperties","typeLabel":"enum\u003cstring>"},"uniqueKey":"event.oneOf.0.data.agent.configuration.approvals.tools","typeLabel":"object"},"timeoutMs":{"type":"number","uniqueKey":"event.oneOf.0.data.agent.configuration.approvals.timeoutMs","typeLabel":"number"}},"uniqueKey":"event.oneOf.0.data.agent.configuration.approvals","typeLabel":"object"},"defaultModel":{"type":"string","uniqueKey":"event.oneOf.0.data.agent.configuration.defaultModel","typeLabel":"string"},"instructions":{"type":"string","uniqueKey":"event.oneOf.0.data.agent.configuration.instructions","typeLabel":"string"},"tools":{"type":"array","items":{"type":"string","minLength":1,"description":"Configurable runtime tool name, configurable namespace wildcard such as sandbox.*, or external namespace wildcard such as google.*. At thread and turn scope, entries can only narrow the agent's effective tools.","examples":["sandbox.*","memory.read","google.*"],"uniqueKey":"event.oneOf.0.data.agent.configuration.tools.items.[INDEX]","typeLabel":"string"},"description":"Agent tool allowlist. These tools are subject to fleet defaults and locks, and thread or turn requests may only narrow the resulting effective tools.","uniqueKey":"event.oneOf.0.data.agent.configuration.tools","typeLabel":"string[]"}},"isRequired":true,"uniqueKey":"event.oneOf.0.data.agent.configuration","typeLabel":"object"},"createdAt":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.0.data.agent.createdAt","typeLabel":"string"},"fleetId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.0.data.agent.fleetId","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.0.data.agent.id","typeLabel":"string"},"metadata":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"event.oneOf.0.data.agent.metadata.additionalProperties","typeLabel":"string"},"description":"Arbitrary string metadata stored on an agent. Runtime enforces maximum key and value sizes.","example":{"project":"alpha"},"isRequired":true,"uniqueKey":"event.oneOf.0.data.agent.metadata","typeLabel":"object"},"orgId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.0.data.agent.orgId","typeLabel":"string"},"updatedAt":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.0.data.agent.updatedAt","typeLabel":"string"},"userId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.0.data.agent.userId","typeLabel":"string"},"effective":{"type":"object","properties":{"approvals":{"type":"object","properties":{"tools":{"type":"object","additionalProperties":{"type":"string","enum":["always","never"],"uniqueKey":"event.oneOf.0.data.agent.effective.approvals.tools.additionalProperties","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"event.oneOf.0.data.agent.effective.approvals.tools","typeLabel":"object"},"timeoutMs":{"type":"number","isRequired":true,"uniqueKey":"event.oneOf.0.data.agent.effective.approvals.timeoutMs","typeLabel":"number"}},"required":["tools","timeoutMs"],"isRequired":true,"uniqueKey":"event.oneOf.0.data.agent.effective.approvals","typeLabel":"object"},"approvalsWritableByAgent":{"type":"boolean","isRequired":true,"uniqueKey":"event.oneOf.0.data.agent.effective.approvalsWritableByAgent","typeLabel":"boolean"},"defaultModel":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.0.data.agent.effective.defaultModel","typeLabel":"string"},"lockedByFleet":{"type":"array","items":{"type":"string","enum":["defaultModel","instructions","tools","approvals"],"uniqueKey":"event.oneOf.0.data.agent.effective.lockedByFleet.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"event.oneOf.0.data.agent.effective.lockedByFleet","typeLabel":"enum\u003cstring>[]"},"resolvedFromFleet":{"type":"array","items":{"type":"string","enum":["defaultModel","instructions","tools","approvals"],"uniqueKey":"event.oneOf.0.data.agent.effective.resolvedFromFleet.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"event.oneOf.0.data.agent.effective.resolvedFromFleet","typeLabel":"enum\u003cstring>[]"},"tools":{"type":"array","items":{"type":"string","enum":["get_time","sub_thread","wait","tool.call","tool.discover","artifact.read","agent.threads.list","agent.threads.get","agent.approvals.cancel","agent.approvals.grant_thread","agent.approvals.grant_agent","agent.create","agent.approvals.update","tool.connect","sandbox.exec","sandbox.read","sandbox.write_file","sandbox.read_file","sandbox.spawn","sandbox.stdin","sandbox.session_read","sandbox.kill","sandbox.list_sessions","sandbox.sync_artifact","memory.read","memory.list","memory.search","memory.write","memory.delete","db.query","web.search","web.fetch","agent.schedule.list","agent.schedule.create","agent.schedule.update","agent.schedule.delete","agent.schedule.trigger"],"uniqueKey":"event.oneOf.0.data.agent.effective.tools.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Effective internal runtime tools after applying fleet defaults, fleet locks, and the agent allowlist.","isRequired":true,"uniqueKey":"event.oneOf.0.data.agent.effective.tools","typeLabel":"enum\u003cstring>[]"},"instructions":{"type":"string","uniqueKey":"event.oneOf.0.data.agent.effective.instructions","typeLabel":"string"}},"required":["approvals","approvalsWritableByAgent","defaultModel","lockedByFleet","resolvedFromFleet","tools"],"uniqueKey":"event.oneOf.0.data.agent.effective","typeLabel":"object"}},"required":["configuration","createdAt","fleetId","id","metadata","orgId","updatedAt","userId"],"isRequired":true,"uniqueKey":"event.oneOf.0.data.agent","typeLabel":"object"}},"required":["agent"],"isRequired":true,"uniqueKey":"event.oneOf.0.data","typeLabel":"object"},"event":{"type":"string","enum":["agent.created"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"event.oneOf.0.event","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"event.oneOf.0","typeLabel":"AgentCreatedWebhookEvent · object"},{"type":"object","title":"AgentUpdatedWebhookEvent","required":["agentId","fleetId","id","orgId","threadId","timestamp","data","event"],"x-stainless-variantName":"AgentUpdatedWebhookEvent","properties":{"agentId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.1.agentId","typeLabel":"string"},"fleetId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.1.fleetId","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.1.id","typeLabel":"string"},"orgId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.1.orgId","typeLabel":"string"},"threadId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.1.threadId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.1.threadId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.1.threadId","typeLabel":"string | null"},"timestamp":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.1.timestamp","typeLabel":"string"},"data":{"type":"object","properties":{"agent":{"type":"object","properties":{"configuration":{"type":"object","properties":{"approvals":{"type":"object","properties":{"tools":{"type":"object","additionalProperties":{"type":"string","enum":["always","never"],"uniqueKey":"event.oneOf.1.data.agent.configuration.approvals.tools.additionalProperties","typeLabel":"enum\u003cstring>"},"uniqueKey":"event.oneOf.1.data.agent.configuration.approvals.tools","typeLabel":"object"},"timeoutMs":{"type":"number","uniqueKey":"event.oneOf.1.data.agent.configuration.approvals.timeoutMs","typeLabel":"number"}},"uniqueKey":"event.oneOf.1.data.agent.configuration.approvals","typeLabel":"object"},"defaultModel":{"type":"string","uniqueKey":"event.oneOf.1.data.agent.configuration.defaultModel","typeLabel":"string"},"instructions":{"type":"string","uniqueKey":"event.oneOf.1.data.agent.configuration.instructions","typeLabel":"string"},"tools":{"type":"array","items":{"type":"string","minLength":1,"description":"Configurable runtime tool name, configurable namespace wildcard such as sandbox.*, or external namespace wildcard such as google.*. At thread and turn scope, entries can only narrow the agent's effective tools.","examples":["sandbox.*","memory.read","google.*"],"uniqueKey":"event.oneOf.1.data.agent.configuration.tools.items.[INDEX]","typeLabel":"string"},"description":"Agent tool allowlist. These tools are subject to fleet defaults and locks, and thread or turn requests may only narrow the resulting effective tools.","uniqueKey":"event.oneOf.1.data.agent.configuration.tools","typeLabel":"string[]"}},"isRequired":true,"uniqueKey":"event.oneOf.1.data.agent.configuration","typeLabel":"object"},"createdAt":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.1.data.agent.createdAt","typeLabel":"string"},"fleetId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.1.data.agent.fleetId","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.1.data.agent.id","typeLabel":"string"},"metadata":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"event.oneOf.1.data.agent.metadata.additionalProperties","typeLabel":"string"},"description":"Arbitrary string metadata stored on an agent. Runtime enforces maximum key and value sizes.","example":{"project":"alpha"},"isRequired":true,"uniqueKey":"event.oneOf.1.data.agent.metadata","typeLabel":"object"},"orgId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.1.data.agent.orgId","typeLabel":"string"},"updatedAt":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.1.data.agent.updatedAt","typeLabel":"string"},"userId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.1.data.agent.userId","typeLabel":"string"},"effective":{"type":"object","properties":{"approvals":{"type":"object","properties":{"tools":{"type":"object","additionalProperties":{"type":"string","enum":["always","never"],"uniqueKey":"event.oneOf.1.data.agent.effective.approvals.tools.additionalProperties","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"event.oneOf.1.data.agent.effective.approvals.tools","typeLabel":"object"},"timeoutMs":{"type":"number","isRequired":true,"uniqueKey":"event.oneOf.1.data.agent.effective.approvals.timeoutMs","typeLabel":"number"}},"required":["tools","timeoutMs"],"isRequired":true,"uniqueKey":"event.oneOf.1.data.agent.effective.approvals","typeLabel":"object"},"approvalsWritableByAgent":{"type":"boolean","isRequired":true,"uniqueKey":"event.oneOf.1.data.agent.effective.approvalsWritableByAgent","typeLabel":"boolean"},"defaultModel":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.1.data.agent.effective.defaultModel","typeLabel":"string"},"lockedByFleet":{"type":"array","items":{"type":"string","enum":["defaultModel","instructions","tools","approvals"],"uniqueKey":"event.oneOf.1.data.agent.effective.lockedByFleet.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"event.oneOf.1.data.agent.effective.lockedByFleet","typeLabel":"enum\u003cstring>[]"},"resolvedFromFleet":{"type":"array","items":{"type":"string","enum":["defaultModel","instructions","tools","approvals"],"uniqueKey":"event.oneOf.1.data.agent.effective.resolvedFromFleet.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"event.oneOf.1.data.agent.effective.resolvedFromFleet","typeLabel":"enum\u003cstring>[]"},"tools":{"type":"array","items":{"type":"string","enum":["get_time","sub_thread","wait","tool.call","tool.discover","artifact.read","agent.threads.list","agent.threads.get","agent.approvals.cancel","agent.approvals.grant_thread","agent.approvals.grant_agent","agent.create","agent.approvals.update","tool.connect","sandbox.exec","sandbox.read","sandbox.write_file","sandbox.read_file","sandbox.spawn","sandbox.stdin","sandbox.session_read","sandbox.kill","sandbox.list_sessions","sandbox.sync_artifact","memory.read","memory.list","memory.search","memory.write","memory.delete","db.query","web.search","web.fetch","agent.schedule.list","agent.schedule.create","agent.schedule.update","agent.schedule.delete","agent.schedule.trigger"],"uniqueKey":"event.oneOf.1.data.agent.effective.tools.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Effective internal runtime tools after applying fleet defaults, fleet locks, and the agent allowlist.","isRequired":true,"uniqueKey":"event.oneOf.1.data.agent.effective.tools","typeLabel":"enum\u003cstring>[]"},"instructions":{"type":"string","uniqueKey":"event.oneOf.1.data.agent.effective.instructions","typeLabel":"string"}},"required":["approvals","approvalsWritableByAgent","defaultModel","lockedByFleet","resolvedFromFleet","tools"],"uniqueKey":"event.oneOf.1.data.agent.effective","typeLabel":"object"}},"required":["configuration","createdAt","fleetId","id","metadata","orgId","updatedAt","userId"],"isRequired":true,"uniqueKey":"event.oneOf.1.data.agent","typeLabel":"object"},"trigger":{"type":"string","enum":["configuration","metadata"],"isRequired":true,"uniqueKey":"event.oneOf.1.data.trigger","typeLabel":"enum\u003cstring>"}},"required":["agent","trigger"],"isRequired":true,"uniqueKey":"event.oneOf.1.data","typeLabel":"object"},"event":{"type":"string","enum":["agent.updated"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"event.oneOf.1.event","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"event.oneOf.1","typeLabel":"AgentUpdatedWebhookEvent · object"},{"type":"object","title":"AgentDeletedWebhookEvent","required":["agentId","fleetId","id","orgId","threadId","timestamp","data","event"],"x-stainless-variantName":"AgentDeletedWebhookEvent","properties":{"agentId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.2.agentId","typeLabel":"string"},"fleetId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.2.fleetId","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.2.id","typeLabel":"string"},"orgId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.2.orgId","typeLabel":"string"},"threadId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.2.threadId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.2.threadId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.2.threadId","typeLabel":"string | null"},"timestamp":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.2.timestamp","typeLabel":"string"},"data":{"type":"object","properties":{"agentId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.2.data.agentId","typeLabel":"string"}},"required":["agentId"],"isRequired":true,"uniqueKey":"event.oneOf.2.data","typeLabel":"object"},"event":{"type":"string","enum":["agent.deleted"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"event.oneOf.2.event","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"event.oneOf.2","typeLabel":"AgentDeletedWebhookEvent · object"},{"type":"object","title":"ThreadCreatedWebhookEvent","required":["agentId","fleetId","id","orgId","threadId","timestamp","data","event"],"x-stainless-variantName":"ThreadCreatedWebhookEvent","properties":{"agentId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.3.agentId","typeLabel":"string"},"fleetId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.3.fleetId","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.3.id","typeLabel":"string"},"orgId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.3.orgId","typeLabel":"string"},"threadId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.3.threadId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.3.threadId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.3.threadId","typeLabel":"string | null"},"timestamp":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.3.timestamp","typeLabel":"string"},"data":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.3.data.message","typeLabel":"string"},"model":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.3.data.model","typeLabel":"string"}},"required":["message","model"],"isRequired":true,"uniqueKey":"event.oneOf.3.data","typeLabel":"object"},"event":{"type":"string","enum":["thread.created"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"event.oneOf.3.event","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"event.oneOf.3","typeLabel":"ThreadCreatedWebhookEvent · object"},{"type":"object","title":"ThreadStatusChangedWebhookEvent","required":["agentId","fleetId","id","orgId","threadId","timestamp","data","event"],"x-stainless-variantName":"ThreadStatusChangedWebhookEvent","properties":{"agentId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.4.agentId","typeLabel":"string"},"fleetId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.4.fleetId","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.4.id","typeLabel":"string"},"orgId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.4.orgId","typeLabel":"string"},"threadId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.4.threadId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.4.threadId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.4.threadId","typeLabel":"string | null"},"timestamp":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.4.timestamp","typeLabel":"string"},"data":{"type":"object","properties":{"error":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.4.data.error.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.4.data.error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.4.data.error","typeLabel":"string | null"},"previousStatus":{"type":"string","enum":["idle","running","awaiting","closed"],"description":"`idle` threads can accept a new turn or be closed. `running` threads have an active turn. `awaiting` threads are paused on external input such as approvals. `closed` threads are terminal.","isRequired":true,"uniqueKey":"event.oneOf.4.data.previousStatus","typeLabel":"enum\u003cstring>"},"result":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.4.data.result.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.4.data.result.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.4.data.result","typeLabel":"string | null"},"status":{"type":"string","enum":["idle","running","awaiting","closed"],"description":"`idle` threads can accept a new turn or be closed. `running` threads have an active turn. `awaiting` threads are paused on external input such as approvals. `closed` threads are terminal.","isRequired":true,"uniqueKey":"event.oneOf.4.data.status","typeLabel":"enum\u003cstring>"}},"required":["error","previousStatus","result","status"],"isRequired":true,"uniqueKey":"event.oneOf.4.data","typeLabel":"object"},"event":{"type":"string","enum":["thread.status.changed"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"event.oneOf.4.event","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"event.oneOf.4","typeLabel":"ThreadStatusChangedWebhookEvent · object"},{"type":"object","title":"ThreadCompletedWebhookEvent","required":["agentId","fleetId","id","orgId","threadId","timestamp","data","event"],"x-stainless-variantName":"ThreadCompletedWebhookEvent","properties":{"agentId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.5.agentId","typeLabel":"string"},"fleetId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.5.fleetId","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.5.id","typeLabel":"string"},"orgId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.5.orgId","typeLabel":"string"},"threadId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.5.threadId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.5.threadId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.5.threadId","typeLabel":"string | null"},"timestamp":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.5.timestamp","typeLabel":"string"},"data":{"type":"object","properties":{"previousStatus":{"type":"string","enum":["idle","running","awaiting","closed"],"description":"`idle` threads can accept a new turn or be closed. `running` threads have an active turn. `awaiting` threads are paused on external input such as approvals. `closed` threads are terminal.","isRequired":true,"uniqueKey":"event.oneOf.5.data.previousStatus","typeLabel":"enum\u003cstring>"},"result":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.5.data.result","typeLabel":"string"},"status":{"type":"string","enum":["idle","running","awaiting","closed"],"description":"`idle` threads can accept a new turn or be closed. `running` threads have an active turn. `awaiting` threads are paused on external input such as approvals. `closed` threads are terminal.","isRequired":true,"uniqueKey":"event.oneOf.5.data.status","typeLabel":"enum\u003cstring>"}},"required":["previousStatus","result","status"],"isRequired":true,"uniqueKey":"event.oneOf.5.data","typeLabel":"object"},"event":{"type":"string","enum":["thread.completed"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"event.oneOf.5.event","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"event.oneOf.5","typeLabel":"ThreadCompletedWebhookEvent · object"},{"type":"object","title":"ThreadFailedWebhookEvent","required":["agentId","fleetId","id","orgId","threadId","timestamp","data","event"],"x-stainless-variantName":"ThreadFailedWebhookEvent","properties":{"agentId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.6.agentId","typeLabel":"string"},"fleetId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.6.fleetId","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.6.id","typeLabel":"string"},"orgId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.6.orgId","typeLabel":"string"},"threadId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.6.threadId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.6.threadId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.6.threadId","typeLabel":"string | null"},"timestamp":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.6.timestamp","typeLabel":"string"},"data":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.6.data.error","typeLabel":"string"},"previousStatus":{"type":"string","enum":["idle","running","awaiting","closed"],"description":"`idle` threads can accept a new turn or be closed. `running` threads have an active turn. `awaiting` threads are paused on external input such as approvals. `closed` threads are terminal.","isRequired":true,"uniqueKey":"event.oneOf.6.data.previousStatus","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["idle","running","awaiting","closed"],"description":"`idle` threads can accept a new turn or be closed. `running` threads have an active turn. `awaiting` threads are paused on external input such as approvals. `closed` threads are terminal.","isRequired":true,"uniqueKey":"event.oneOf.6.data.status","typeLabel":"enum\u003cstring>"}},"required":["error","previousStatus","status"],"isRequired":true,"uniqueKey":"event.oneOf.6.data","typeLabel":"object"},"event":{"type":"string","enum":["thread.failed"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"event.oneOf.6.event","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"event.oneOf.6","typeLabel":"ThreadFailedWebhookEvent · object"},{"type":"object","title":"TurnCreatedWebhookEvent","required":["agentId","fleetId","id","orgId","threadId","timestamp","data","event"],"x-stainless-variantName":"TurnCreatedWebhookEvent","properties":{"agentId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.7.agentId","typeLabel":"string"},"fleetId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.7.fleetId","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.7.id","typeLabel":"string"},"orgId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.7.orgId","typeLabel":"string"},"threadId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.7.threadId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.7.threadId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.7.threadId","typeLabel":"string | null"},"timestamp":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.7.timestamp","typeLabel":"string"},"data":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.7.data.message","typeLabel":"string"},"seq":{"type":"number","isRequired":true,"uniqueKey":"event.oneOf.7.data.seq","typeLabel":"number"},"startedAt":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.7.data.startedAt","typeLabel":"string"},"turnId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.7.data.turnId","typeLabel":"string"}},"required":["message","seq","startedAt","turnId"],"isRequired":true,"uniqueKey":"event.oneOf.7.data","typeLabel":"object"},"event":{"type":"string","enum":["turn.created"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"event.oneOf.7.event","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"event.oneOf.7","typeLabel":"TurnCreatedWebhookEvent · object"},{"type":"object","title":"TurnCompletedWebhookEvent","required":["agentId","fleetId","id","orgId","threadId","timestamp","data","event"],"x-stainless-variantName":"TurnCompletedWebhookEvent","properties":{"agentId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.8.agentId","typeLabel":"string"},"fleetId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.8.fleetId","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.8.id","typeLabel":"string"},"orgId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.8.orgId","typeLabel":"string"},"threadId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.8.threadId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.8.threadId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.8.threadId","typeLabel":"string | null"},"timestamp":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.8.timestamp","typeLabel":"string"},"data":{"type":"object","properties":{"completedAt":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.8.data.completedAt","typeLabel":"string"},"error":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.8.data.error.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.8.data.error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.8.data.error","typeLabel":"string | null"},"result":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.8.data.result.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.8.data.result.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.8.data.result","typeLabel":"string | null"},"seq":{"type":"number","isRequired":true,"uniqueKey":"event.oneOf.8.data.seq","typeLabel":"number"},"status":{"type":"string","enum":["completed"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"event.oneOf.8.data.status","typeLabel":"enum\u003cstring>"},"tokenUsage":{"oneOf":[{"type":"object","properties":{"inputTokens":{"type":"number","isRequired":true,"uniqueKey":"event.oneOf.8.data.tokenUsage.oneOf.0.inputTokens","typeLabel":"number"},"outputTokens":{"type":"number","isRequired":true,"uniqueKey":"event.oneOf.8.data.tokenUsage.oneOf.0.outputTokens","typeLabel":"number"}},"required":["inputTokens","outputTokens"],"isRequired":true,"uniqueKey":"event.oneOf.8.data.tokenUsage.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"inputTokens":{"type":"number"},"outputTokens":{"type":"number"}},"required":["inputTokens","outputTokens"],"isRequired":true,"uniqueKey":"event.oneOf.8.data.tokenUsage.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.8.data.tokenUsage","typeLabel":"object | null"},"turnId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.8.data.turnId","typeLabel":"string"}},"required":["completedAt","error","result","seq","status","tokenUsage","turnId"],"isRequired":true,"uniqueKey":"event.oneOf.8.data","typeLabel":"object"},"event":{"type":"string","enum":["turn.completed"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"event.oneOf.8.event","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"event.oneOf.8","typeLabel":"TurnCompletedWebhookEvent · object"},{"type":"object","title":"TurnFailedWebhookEvent","required":["agentId","fleetId","id","orgId","threadId","timestamp","data","event"],"x-stainless-variantName":"TurnFailedWebhookEvent","properties":{"agentId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.9.agentId","typeLabel":"string"},"fleetId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.9.fleetId","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.9.id","typeLabel":"string"},"orgId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.9.orgId","typeLabel":"string"},"threadId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.9.threadId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.9.threadId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.9.threadId","typeLabel":"string | null"},"timestamp":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.9.timestamp","typeLabel":"string"},"data":{"type":"object","properties":{"completedAt":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.9.data.completedAt","typeLabel":"string"},"error":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.9.data.error.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.9.data.error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.9.data.error","typeLabel":"string | null"},"result":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.9.data.result.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.9.data.result.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.9.data.result","typeLabel":"string | null"},"seq":{"type":"number","isRequired":true,"uniqueKey":"event.oneOf.9.data.seq","typeLabel":"number"},"status":{"type":"string","enum":["failed"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"event.oneOf.9.data.status","typeLabel":"enum\u003cstring>"},"tokenUsage":{"oneOf":[{"type":"object","properties":{"inputTokens":{"type":"number","isRequired":true,"uniqueKey":"event.oneOf.9.data.tokenUsage.oneOf.0.inputTokens","typeLabel":"number"},"outputTokens":{"type":"number","isRequired":true,"uniqueKey":"event.oneOf.9.data.tokenUsage.oneOf.0.outputTokens","typeLabel":"number"}},"required":["inputTokens","outputTokens"],"isRequired":true,"uniqueKey":"event.oneOf.9.data.tokenUsage.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"inputTokens":{"type":"number"},"outputTokens":{"type":"number"}},"required":["inputTokens","outputTokens"],"isRequired":true,"uniqueKey":"event.oneOf.9.data.tokenUsage.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.9.data.tokenUsage","typeLabel":"object | null"},"turnId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.9.data.turnId","typeLabel":"string"}},"required":["completedAt","error","result","seq","status","tokenUsage","turnId"],"isRequired":true,"uniqueKey":"event.oneOf.9.data","typeLabel":"object"},"event":{"type":"string","enum":["turn.failed"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"event.oneOf.9.event","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"event.oneOf.9","typeLabel":"TurnFailedWebhookEvent · object"},{"type":"object","title":"MessageCreatedWebhookEvent","required":["agentId","fleetId","id","orgId","threadId","timestamp","data","event"],"x-stainless-variantName":"MessageCreatedWebhookEvent","properties":{"agentId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.10.agentId","typeLabel":"string"},"fleetId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.10.fleetId","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.10.id","typeLabel":"string"},"orgId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.10.orgId","typeLabel":"string"},"threadId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.10.threadId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.10.threadId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.10.threadId","typeLabel":"string | null"},"timestamp":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.10.timestamp","typeLabel":"string"},"data":{"type":"object","properties":{"createdAt":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.10.data.createdAt","typeLabel":"string"},"role":{"type":"string","enum":["user","assistant"],"isRequired":true,"uniqueKey":"event.oneOf.10.data.role","typeLabel":"enum\u003cstring>"},"seq":{"type":"number","isRequired":true,"uniqueKey":"event.oneOf.10.data.seq","typeLabel":"number"},"turnId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.10.data.turnId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.10.data.turnId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.10.data.turnId","typeLabel":"string | null"}},"required":["createdAt","role","seq","turnId"],"isRequired":true,"uniqueKey":"event.oneOf.10.data","typeLabel":"object"},"event":{"type":"string","enum":["message.created"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"event.oneOf.10.event","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"event.oneOf.10","typeLabel":"MessageCreatedWebhookEvent · object"},{"type":"object","title":"ApprovalRequestedWebhookEvent","required":["agentId","fleetId","id","orgId","threadId","timestamp","data","event"],"x-stainless-variantName":"ApprovalRequestedWebhookEvent","properties":{"agentId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.11.agentId","typeLabel":"string"},"fleetId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.11.fleetId","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.11.id","typeLabel":"string"},"orgId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.11.orgId","typeLabel":"string"},"threadId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.11.threadId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.11.threadId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.11.threadId","typeLabel":"string | null"},"timestamp":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.11.timestamp","typeLabel":"string"},"data":{"type":"object","properties":{"approval":{"type":"object","properties":{"createdAt":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.11.data.approval.createdAt","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.11.data.approval.id","typeLabel":"string"},"input":{"description":"JSON value payload. Generated SDKs may expose this as unknown or Any.","x-stainless-any":true,"isRequired":true,"uniqueKey":"event.oneOf.11.data.approval.input","typeLabel":"any"},"resolvedAt":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.11.data.approval.resolvedAt.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.11.data.approval.resolvedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.11.data.approval.resolvedAt","typeLabel":"string | null"},"runtimeToolName":{"type":"string","enum":["get_time","sub_thread","wait","tool.call","tool.discover","artifact.read","agent.threads.list","agent.threads.get","agent.approvals.cancel","agent.approvals.grant_thread","agent.approvals.grant_agent","agent.create","agent.approvals.update","tool.connect","sandbox.exec","sandbox.read","sandbox.write_file","sandbox.read_file","sandbox.spawn","sandbox.stdin","sandbox.session_read","sandbox.kill","sandbox.list_sessions","sandbox.sync_artifact","memory.read","memory.list","memory.search","memory.write","memory.delete","db.query","web.search","web.fetch","agent.schedule.list","agent.schedule.create","agent.schedule.update","agent.schedule.delete","agent.schedule.trigger"],"isRequired":true,"uniqueKey":"event.oneOf.11.data.approval.runtimeToolName","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["pending","approved","denied","cancelled","timed_out"],"isRequired":true,"uniqueKey":"event.oneOf.11.data.approval.status","typeLabel":"enum\u003cstring>"},"threadId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.11.data.approval.threadId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.11.data.approval.threadId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.11.data.approval.threadId","typeLabel":"string | null"},"timeoutAt":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.11.data.approval.timeoutAt.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.11.data.approval.timeoutAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.11.data.approval.timeoutAt","typeLabel":"string | null"},"timeoutMs":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"event.oneOf.11.data.approval.timeoutMs.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.11.data.approval.timeoutMs.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.11.data.approval.timeoutMs","typeLabel":"number | null"},"toolIndex":{"type":"number","isRequired":true,"uniqueKey":"event.oneOf.11.data.approval.toolIndex","typeLabel":"number"},"toolName":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.11.data.approval.toolName","typeLabel":"string"},"toolUseId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.11.data.approval.toolUseId","typeLabel":"string"},"turnId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.11.data.approval.turnId","typeLabel":"string"},"toolSourceId":{"type":"string","uniqueKey":"event.oneOf.11.data.approval.toolSourceId","typeLabel":"string"},"toolSourceVersion":{"type":"number","uniqueKey":"event.oneOf.11.data.approval.toolSourceVersion","typeLabel":"number"}},"required":["createdAt","id","input","resolvedAt","runtimeToolName","status","threadId","timeoutAt","timeoutMs","toolIndex","toolName","toolUseId","turnId"],"isRequired":true,"uniqueKey":"event.oneOf.11.data.approval","typeLabel":"object"}},"required":["approval"],"isRequired":true,"uniqueKey":"event.oneOf.11.data","typeLabel":"object"},"event":{"type":"string","enum":["approval.requested"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"event.oneOf.11.event","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"event.oneOf.11","typeLabel":"ApprovalRequestedWebhookEvent · object"},{"type":"object","title":"ApprovalResolvedWebhookEvent","required":["agentId","fleetId","id","orgId","threadId","timestamp","data","event"],"x-stainless-variantName":"ApprovalResolvedWebhookEvent","properties":{"agentId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.12.agentId","typeLabel":"string"},"fleetId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.12.fleetId","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.12.id","typeLabel":"string"},"orgId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.12.orgId","typeLabel":"string"},"threadId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.12.threadId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.12.threadId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.12.threadId","typeLabel":"string | null"},"timestamp":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.12.timestamp","typeLabel":"string"},"data":{"type":"object","properties":{"approvalId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.12.data.approvalId","typeLabel":"string"},"decision":{"type":"string","enum":["approved","denied","timed_out","cancelled"],"isRequired":true,"uniqueKey":"event.oneOf.12.data.decision","typeLabel":"enum\u003cstring>"}},"required":["approvalId","decision"],"isRequired":true,"uniqueKey":"event.oneOf.12.data","typeLabel":"object"},"event":{"type":"string","enum":["approval.resolved"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"event.oneOf.12.event","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"event.oneOf.12","typeLabel":"ApprovalResolvedWebhookEvent · object"},{"type":"object","title":"ApprovalGrantedWebhookEvent","required":["agentId","fleetId","id","orgId","threadId","timestamp","data","event"],"x-stainless-variantName":"ApprovalGrantedWebhookEvent","properties":{"agentId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.13.agentId","typeLabel":"string"},"fleetId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.13.fleetId","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.13.id","typeLabel":"string"},"orgId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.13.orgId","typeLabel":"string"},"threadId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.13.threadId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.13.threadId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.13.threadId","typeLabel":"string | null"},"timestamp":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.13.timestamp","typeLabel":"string"},"data":{"type":"object","properties":{"grantId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.13.data.grantId","typeLabel":"string"},"scope":{"type":"string","enum":["thread","agent"],"isRequired":true,"uniqueKey":"event.oneOf.13.data.scope","typeLabel":"enum\u003cstring>"},"toolName":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.13.data.toolName","typeLabel":"string"},"threadId":{"type":"string","uniqueKey":"event.oneOf.13.data.threadId","typeLabel":"string"}},"required":["grantId","scope","toolName"],"isRequired":true,"uniqueKey":"event.oneOf.13.data","typeLabel":"object"},"event":{"type":"string","enum":["approval.granted"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"event.oneOf.13.event","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"event.oneOf.13","typeLabel":"ApprovalGrantedWebhookEvent · object"},{"type":"object","title":"ScheduleCreatedWebhookEvent","required":["agentId","fleetId","id","orgId","threadId","timestamp","data","event"],"x-stainless-variantName":"ScheduleCreatedWebhookEvent","properties":{"agentId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.14.agentId","typeLabel":"string"},"fleetId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.14.fleetId","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.14.id","typeLabel":"string"},"orgId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.14.orgId","typeLabel":"string"},"threadId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.14.threadId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.14.threadId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.14.threadId","typeLabel":"string | null"},"timestamp":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.14.timestamp","typeLabel":"string"},"data":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.14.data.name","typeLabel":"string"},"scheduleId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.14.data.scheduleId","typeLabel":"string"},"cron":{"type":"string","uniqueKey":"event.oneOf.14.data.cron","typeLabel":"string"},"runAt":{"type":"string","uniqueKey":"event.oneOf.14.data.runAt","typeLabel":"string"}},"required":["name","scheduleId"],"isRequired":true,"uniqueKey":"event.oneOf.14.data","typeLabel":"object"},"event":{"type":"string","enum":["schedule.created"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"event.oneOf.14.event","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"event.oneOf.14","typeLabel":"ScheduleCreatedWebhookEvent · object"},{"type":"object","title":"ScheduleDeletedWebhookEvent","required":["agentId","fleetId","id","orgId","threadId","timestamp","data","event"],"x-stainless-variantName":"ScheduleDeletedWebhookEvent","properties":{"agentId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.15.agentId","typeLabel":"string"},"fleetId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.15.fleetId","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.15.id","typeLabel":"string"},"orgId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.15.orgId","typeLabel":"string"},"threadId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.15.threadId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.15.threadId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.15.threadId","typeLabel":"string | null"},"timestamp":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.15.timestamp","typeLabel":"string"},"data":{"type":"object","properties":{"scheduleId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.15.data.scheduleId","typeLabel":"string"}},"required":["scheduleId"],"isRequired":true,"uniqueKey":"event.oneOf.15.data","typeLabel":"object"},"event":{"type":"string","enum":["schedule.deleted"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"event.oneOf.15.event","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"event.oneOf.15","typeLabel":"ScheduleDeletedWebhookEvent · object"},{"type":"object","title":"ScheduleTriggeredWebhookEvent","required":["agentId","fleetId","id","orgId","threadId","timestamp","data","event"],"x-stainless-variantName":"ScheduleTriggeredWebhookEvent","properties":{"agentId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.16.agentId","typeLabel":"string"},"fleetId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.16.fleetId","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.16.id","typeLabel":"string"},"orgId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.16.orgId","typeLabel":"string"},"threadId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.16.threadId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.16.threadId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.16.threadId","typeLabel":"string | null"},"timestamp":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.16.timestamp","typeLabel":"string"},"data":{"type":"object","properties":{"scheduleId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.16.data.scheduleId","typeLabel":"string"},"threadId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.16.data.threadId","typeLabel":"string"}},"required":["scheduleId","threadId"],"isRequired":true,"uniqueKey":"event.oneOf.16.data","typeLabel":"object"},"event":{"type":"string","enum":["schedule.triggered"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"event.oneOf.16.event","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"event.oneOf.16","typeLabel":"ScheduleTriggeredWebhookEvent · object"},{"type":"object","title":"ConnectionAttachedWebhookEvent","required":["agentId","fleetId","id","orgId","threadId","timestamp","data","event"],"x-stainless-variantName":"ConnectionAttachedWebhookEvent","properties":{"agentId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.17.agentId","typeLabel":"string"},"fleetId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.17.fleetId","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.17.id","typeLabel":"string"},"orgId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.17.orgId","typeLabel":"string"},"threadId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.17.threadId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.17.threadId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.17.threadId","typeLabel":"string | null"},"timestamp":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.17.timestamp","typeLabel":"string"},"data":{"type":"object","properties":{"connectionId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.17.data.connectionId","typeLabel":"string"},"provider":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.17.data.provider","typeLabel":"string"}},"required":["connectionId","provider"],"isRequired":true,"uniqueKey":"event.oneOf.17.data","typeLabel":"object"},"event":{"type":"string","enum":["connection.attached"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"event.oneOf.17.event","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"event.oneOf.17","typeLabel":"ConnectionAttachedWebhookEvent · object"},{"type":"object","title":"ConnectionDetachedWebhookEvent","required":["agentId","fleetId","id","orgId","threadId","timestamp","data","event"],"x-stainless-variantName":"ConnectionDetachedWebhookEvent","properties":{"agentId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.18.agentId","typeLabel":"string"},"fleetId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.18.fleetId","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.18.id","typeLabel":"string"},"orgId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.18.orgId","typeLabel":"string"},"threadId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.18.threadId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.18.threadId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.18.threadId","typeLabel":"string | null"},"timestamp":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.18.timestamp","typeLabel":"string"},"data":{"type":"object","properties":{"connectionId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.18.data.connectionId","typeLabel":"string"},"provider":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.18.data.provider","typeLabel":"string"}},"required":["connectionId","provider"],"isRequired":true,"uniqueKey":"event.oneOf.18.data","typeLabel":"object"},"event":{"type":"string","enum":["connection.detached"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"event.oneOf.18.event","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"event.oneOf.18","typeLabel":"ConnectionDetachedWebhookEvent · object"},{"type":"object","title":"WebhookTestWebhookEvent","required":["agentId","fleetId","id","orgId","threadId","timestamp","data","event"],"x-stainless-variantName":"WebhookTestWebhookEvent","properties":{"agentId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.19.agentId","typeLabel":"string"},"fleetId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.19.fleetId","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.19.id","typeLabel":"string"},"orgId":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.19.orgId","typeLabel":"string"},"threadId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.19.threadId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"event.oneOf.19.threadId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.oneOf.19.threadId","typeLabel":"string | null"},"timestamp":{"type":"string","isRequired":true,"uniqueKey":"event.oneOf.19.timestamp","typeLabel":"string"},"data":{"type":"object","properties":{},"additionalProperties":false,"x-stainless-empty-object":true,"isRequired":true,"uniqueKey":"event.oneOf.19.data","typeLabel":"object"},"event":{"type":"string","enum":["webhook.test"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"event.oneOf.19.event","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"event.oneOf.19","typeLabel":"WebhookTestWebhookEvent · object"}],"isRequired":true,"uniqueKey":"event","typeLabel":"AgentCreatedWebhookEvent · object | AgentUpdatedWebhookEvent · object | AgentDeletedWebhookEvent · object | ThreadCreatedWebhookEvent · object | ThreadStatusChangedWebhookEvent · object | ThreadCompletedWebhookEvent · object | ThreadFailedWebhookEvent · object | TurnCreatedWebhookEvent · object | TurnCompletedWebhookEvent · object | TurnFailedWebhookEvent · object | MessageCreatedWebhookEvent · object | ApprovalRequestedWebhookEvent · object | ApprovalResolvedWebhookEvent · object | ApprovalGrantedWebhookEvent · object | ScheduleCreatedWebhookEvent · object | ScheduleDeletedWebhookEvent · object | ScheduleTriggeredWebhookEvent · object | ConnectionAttachedWebhookEvent · object | ConnectionDetachedWebhookEvent · object | WebhookTestWebhookEvent · object"},"seq":{"type":"number","isRequired":true,"uniqueKey":"seq","typeLabel":"number"}},"required":["event","seq"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"event":{"agentId":"\u003cstring>","fleetId":"\u003cstring>","id":"\u003cstring>","orgId":"\u003cstring>","threadId":"\u003cstring>","timestamp":"\u003cstring>","data":{"agent":{"configuration":{"approvals":{"tools":{},"timeoutMs":123},"defaultModel":"\u003cstring>","instructions":"\u003cstring>","tools":["sandbox.*"]},"createdAt":"\u003cstring>","fleetId":"\u003cstring>","id":"\u003cstring>","metadata":{"project":"alpha"},"orgId":"\u003cstring>","updatedAt":"\u003cstring>","userId":"\u003cstring>","effective":{"approvals":{"tools":{},"timeoutMs":123},"approvalsWritableByAgent":true,"defaultModel":"\u003cstring>","lockedByFleet":["defaultModel"],"resolvedFromFleet":["defaultModel"],"tools":["get_time"],"instructions":"\u003cstring>"}}},"event":"agent.created"},"seq":123}}},"exampleType":"generated"}},"exampleType":"generated"},"9b10ded3-d361-428d-840e-a448997ba7de":{"description":"Invalid runtime request.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code when the API can provide one.","example":"MONTHLY_TOKEN_BUDGET_EXCEEDED","uniqueKey":"code","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"MONTHLY_TOKEN_BUDGET_EXCEEDED"}}},"exampleType":"generated"}},"exampleType":"generated"},"d964690e-7b77-4e88-b818-3754177d65bb":{"description":"Authentication required.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code when the API can provide one.","example":"MONTHLY_TOKEN_BUDGET_EXCEEDED","uniqueKey":"code","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"MONTHLY_TOKEN_BUDGET_EXCEEDED"}}},"exampleType":"generated"}},"exampleType":"generated"},"599e5f07-2667-425f-962b-022e84276d1c":{"description":"Access denied or non-transient quota exceeded. Limit errors include a stable code field.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code when the API can provide one.","example":"MONTHLY_TOKEN_BUDGET_EXCEEDED","uniqueKey":"code","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"MONTHLY_TOKEN_BUDGET_EXCEEDED"}}},"exampleType":"generated"}},"exampleType":"generated"},"41fc0bbf-0859-4b08-9959-24d18d399cf6":{"description":"Runtime resource not found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code when the API can provide one.","example":"MONTHLY_TOKEN_BUDGET_EXCEEDED","uniqueKey":"code","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"MONTHLY_TOKEN_BUDGET_EXCEEDED"}}},"exampleType":"generated"}},"exampleType":"generated"},"4fb2667a-ff8b-4acd-b65c-9c95df343617":{"description":"Transient capacity limit exceeded. Limit errors include a stable code field.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code when the API can provide one.","example":"MONTHLY_TOKEN_BUDGET_EXCEEDED","uniqueKey":"code","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"MONTHLY_TOKEN_BUDGET_EXCEEDED"}}},"exampleType":"generated"}},"exampleType":"generated"},"abb2315f-9ea6-4efc-9f28-caea5ffebb45":{"description":"Required runtime dependency unavailable.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code when the API can provide one.","example":"MONTHLY_TOKEN_BUDGET_EXCEEDED","uniqueKey":"code","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"MONTHLY_TOKEN_BUDGET_EXCEEDED"}}},"exampleType":"generated"}},"exampleType":"generated"},"9f5a527a-efc3-4560-94c8-c413c99d7661":{"description":"Runtime error response.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code when the API can provide one.","example":"MONTHLY_TOKEN_BUDGET_EXCEEDED","uniqueKey":"code","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"MONTHLY_TOKEN_BUDGET_EXCEEDED"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"61e5bb0b-3bca-4a8f-be42-578fb7637855":{"bearerAuth":{"bearerFormat":"Cerca API key","scheme":"bearer","type":"http","scopes":[]}}},"servers":{"d2b2aefa-8204-4fa4-b0ac-351a68bfe8fe":{"url":"https://api.cerca.dev"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"bearerFormat":"Cerca API key","scheme":"bearer","type":"http","scopes":[]},"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","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml"},"subdomain":"cerca","siteName":"Cerca","title":"Thread event stream - Cerca","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-06T20:30:15.327Z","originalFileLocation":"api-reference/events/thread-event-stream.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=\"Server-Sent Events stream. Each SSE data frame is JSON matching this response schema.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cerca\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cerca/U1XT9hQUrE53iVjp/_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/cerca/U1XT9hQUrE53iVjp/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cerca/U1XT9hQUrE53iVjp/_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/cerca/U1XT9hQUrE53iVjp/_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/cerca/U1XT9hQUrE53iVjp/_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/cerca/U1XT9hQUrE53iVjp/_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/cerca/U1XT9hQUrE53iVjp/_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/cerca/U1XT9hQUrE53iVjp/_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/cerca/U1XT9hQUrE53iVjp/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Thread event stream - Cerca\">\u003cmeta data-mint-head property=\"og:description\" content=\"Server-Sent Events stream. Each SSE data frame is JSON matching this response schema.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cerca\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cerca.dev/api-reference/events/thread-event-stream\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cerca.mintlify.app/_mintlify/api/og/v2?division=Events\u0026amp;title=Thread+event+stream\u0026amp;description=Server-Sent+Events+stream.+Each+SSE+data+frame+is+JSON+matching+this+response+schema.\u0026amp;theme=fc49af25e83b722074099bcb\u0026amp;signature=21d0e1792150d10deaaa687b5e2224ccd693d44fce61aca9402b91907219c5a8\">\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=\"Thread event stream - Cerca\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Server-Sent Events stream. Each SSE data frame is JSON matching this response schema.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cerca.mintlify.app/_mintlify/api/og/v2?division=Events\u0026amp;title=Thread+event+stream\u0026amp;description=Server-Sent+Events+stream.+Each+SSE+data+frame+is+JSON+matching+this+response+schema.\u0026amp;theme=fc49af25e83b722074099bcb\u0026amp;signature=21d0e1792150d10deaaa687b5e2224ccd693d44fce61aca9402b91907219c5a8\">\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/cerca/U1XT9hQUrE53iVjp/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cerca\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7C6340\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cerca.dev/api-reference/events/thread-event-stream\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/events/thread-event-stream.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cerca.dev/#organization\",\"name\":\"Cerca\",\"url\":\"https://docs.cerca.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cerca/avU2YjV-ayl9ITnW/logo/light.svg?fit=max\u0026auto=format\u0026n=avU2YjV-ayl9ITnW\u0026q=85\u0026s=3a952f50a305b017db4af3b52443e78d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cerca.dev#website\",\"name\":\"Cerca\",\"url\":\"https://docs.cerca.dev\",\"publisher\":{\"@id\":\"https://docs.cerca.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cerca.dev/api-reference/events/thread-event-stream#webpage\",\"url\":\"https://docs.cerca.dev/api-reference/events/thread-event-stream\",\"name\":\"Thread event stream\",\"description\":\"Server-Sent Events stream. Each SSE data frame is JSON matching this response schema.\",\"dateModified\":\"2026-05-06T20:30:15.327Z\",\"isPartOf\":{\"@id\":\"https://docs.cerca.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cerca.dev/api-reference/events/thread-event-stream#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cerca.dev/api-reference/events/thread-event-stream#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Events\",\"item\":\"https://docs.cerca.dev/api-reference/events/list-events\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Thread event stream\",\"item\":\"https://docs.cerca.dev/api-reference/events/thread-event-stream\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.cerca.dev/api-reference/events/thread-event-stream#apireference\",\"headline\":\"Thread event stream\",\"name\":\"Thread event stream\",\"description\":\"Server-Sent Events stream. Each SSE data frame is JSON matching this response schema.\",\"url\":\"https://docs.cerca.dev/api-reference/events/thread-event-stream\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cerca.dev/api-reference/events/thread-event-stream#webpage\"},\"dateModified\":\"2026-05-06T20:30:15.327Z\",\"publisher\":{\"@id\":\"https://docs.cerca.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cerca.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cerca\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Cerca","nav":{"global":{"anchors":[{"anchor":"Changelog","icon":"list","href":"/changelog"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"API Reference","icon":"square-terminal","groups":[{"group":"Auth","pages":[{"title":"Retrieve context","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /auth/context","href":"/api-reference/auth/retrieve-context"},{"title":"List fleets","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /auth/fleets","href":"/api-reference/auth/list-fleets"}]},{"group":"OAuth","pages":[{"title":"Start OAuth authorization","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml post /oauth/connect/{provider}","href":"/api-reference/oauth/start-oauth-authorization"}]},{"group":"Connections","pages":[{"title":"Create API key","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml post /connections/api-keys","href":"/api-reference/connections/create-api-key"},{"title":"List connections","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /connections","href":"/api-reference/connections/list-connections"},{"title":"Delete connection","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml delete /connections/{connectionId}","href":"/api-reference/connections/delete-connection"},{"title":"List connections","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /agents/{agentId}/connections","href":"/api-reference/connections/list-connections-1"},{"title":"Attach connection","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml post /agents/{agentId}/connections","href":"/api-reference/connections/attach-connection"},{"title":"Detach connection","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml delete /agents/{agentId}/connections/{connectionId}","href":"/api-reference/connections/detach-connection"}]},{"group":"Tools","pages":[{"title":"List tools","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /fleets/{fleetId}/tools","href":"/api-reference/tools/list-tools"},{"title":"Create tool","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml post /fleets/{fleetId}/tools","href":"/api-reference/tools/create-tool"},{"title":"Retrieve tool source","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /fleets/{fleetId}/tools/{sourceId}","href":"/api-reference/tools/retrieve-tool-source"},{"title":"Update tool source","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml put /fleets/{fleetId}/tools/{sourceId}","href":"/api-reference/tools/update-tool-source"},{"title":"Delete tool source","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml delete /fleets/{fleetId}/tools/{sourceId}","href":"/api-reference/tools/delete-tool-source"},{"title":"List tools","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /agents/{agentId}/tools","href":"/api-reference/tools/list-tools-1"}]},{"group":"Webhooks","pages":[{"title":"List webhooks","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /fleets/{fleetId}/webhooks","href":"/api-reference/webhooks/list-webhooks"},{"title":"Create webhook","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml post /fleets/{fleetId}/webhooks","href":"/api-reference/webhooks/create-webhook"},{"title":"Retrieve webhook","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /fleets/{fleetId}/webhooks/{webhookId}","href":"/api-reference/webhooks/retrieve-webhook"},{"title":"Update webhook","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml put /fleets/{fleetId}/webhooks/{webhookId}","href":"/api-reference/webhooks/update-webhook"},{"title":"Delete webhook","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml delete /fleets/{fleetId}/webhooks/{webhookId}","href":"/api-reference/webhooks/delete-webhook"},{"title":"Rotate webhook secret","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml post /fleets/{fleetId}/webhooks/{webhookId}/rotate","href":"/api-reference/webhooks/rotate-webhook-secret"},{"title":"Send test webhook","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml post /fleets/{fleetId}/webhooks/{webhookId}/test","href":"/api-reference/webhooks/send-test-webhook"}]},{"group":"Agents","pages":[{"title":"List agents","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /agents","href":"/api-reference/agents/list-agents"},{"title":"Create agent","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml post /agents","href":"/api-reference/agents/create-agent"},{"title":"Retrieve agent","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /agents/{agentId}","href":"/api-reference/agents/retrieve-agent"},{"title":"Update agent","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml put /agents/{agentId}","href":"/api-reference/agents/update-agent"},{"title":"Delete agent","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml delete /agents/{agentId}","href":"/api-reference/agents/delete-agent"},{"title":"Retrieve config","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /agents/{agentId}/config","href":"/api-reference/agents/retrieve-config"},{"title":"Update metadata","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml patch /agents/{agentId}/metadata","href":"/api-reference/agents/update-metadata"}]},{"group":"Context","pages":[{"title":"List context entries","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /agents/{agentId}/context","href":"/api-reference/context/list-context-entries"},{"title":"Retrieve context entry","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /agents/{agentId}/context/entry","href":"/api-reference/context/retrieve-context-entry"},{"title":"Update context entry","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml put /agents/{agentId}/context/entry","href":"/api-reference/context/update-context-entry"},{"title":"Delete context entry","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml delete /agents/{agentId}/context/entry","href":"/api-reference/context/delete-context-entry"},{"title":"Search context","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /agents/{agentId}/context/search","href":"/api-reference/context/search-context"}]},{"group":"Schedules","pages":[{"title":"List schedules","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /agents/{agentId}/schedules","href":"/api-reference/schedules/list-schedules"},{"title":"Create schedule","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml post /agents/{agentId}/schedules","href":"/api-reference/schedules/create-schedule"},{"title":"Update schedule","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml put /agents/{agentId}/schedules/{scheduleId}","href":"/api-reference/schedules/update-schedule"},{"title":"Delete schedule","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml delete /agents/{agentId}/schedules/{scheduleId}","href":"/api-reference/schedules/delete-schedule"},{"title":"Trigger schedule","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml post /agents/{agentId}/schedules/{scheduleId}/trigger","href":"/api-reference/schedules/trigger-schedule"}]},{"group":"Threads","pages":[{"title":"List threads","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /agents/{agentId}/threads","href":"/api-reference/threads/list-threads"},{"title":"Create thread","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml post /agents/{agentId}/threads","href":"/api-reference/threads/create-thread"},{"title":"Retrieve thread","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /agents/{agentId}/threads/{threadId}","href":"/api-reference/threads/retrieve-thread"},{"title":"List thread messages","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /agents/{agentId}/threads/{threadId}/messages","href":"/api-reference/threads/list-thread-messages"},{"title":"Get thread activity","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /agents/{agentId}/threads/{threadId}/activity","href":"/api-reference/threads/get-thread-activity"},{"title":"Create turn","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml post /agents/{agentId}/threads/{threadId}/turns","href":"/api-reference/threads/create-turn"},{"title":"Steer thread","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml post /agents/{agentId}/threads/{threadId}/steer","href":"/api-reference/threads/steer-thread"},{"title":"Cancel thread","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml post /agents/{agentId}/threads/{threadId}/cancel","href":"/api-reference/threads/cancel-thread"},{"title":"Close thread","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml post /agents/{agentId}/threads/{threadId}/close","href":"/api-reference/threads/close-thread"},{"title":"Compact thread","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml post /agents/{agentId}/threads/{threadId}/compact","href":"/api-reference/threads/compact-thread"}]},{"group":"Approvals","pages":[{"title":"List approvals","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /agents/{agentId}/approvals","href":"/api-reference/approvals/list-approvals"},{"title":"List approval grants","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /agents/{agentId}/approval-grants","href":"/api-reference/approvals/list-approval-grants"},{"title":"Delete approval grant","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml delete /agents/{agentId}/approval-grants/{grantId}","href":"/api-reference/approvals/delete-approval-grant"},{"title":"List approval grants","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /agents/{agentId}/threads/{threadId}/approval-grants","href":"/api-reference/approvals/list-approval-grants-1"},{"title":"Delete approval grant","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml delete /agents/{agentId}/threads/{threadId}/approval-grants/{grantId}","href":"/api-reference/approvals/delete-approval-grant-1"},{"title":"Create approval","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml post /agents/{agentId}/threads/{threadId}/approvals/{approvalId}","href":"/api-reference/approvals/create-approval"}]},{"group":"Sandbox","pages":[{"title":"Execute sandbox command","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml post /agents/{agentId}/sandbox/exec","href":"/api-reference/sandbox/execute-sandbox-command"},{"title":"Write sandbox file","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml post /agents/{agentId}/sandbox/write","href":"/api-reference/sandbox/write-sandbox-file"},{"title":"Read sandbox file","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml post /agents/{agentId}/sandbox/read","href":"/api-reference/sandbox/read-sandbox-file"}]},{"group":"Events","pages":[{"title":"List events","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /fleets/{fleetId}/events","href":"/api-reference/events/list-events"},{"title":"List events","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /agents/{agentId}/events","href":"/api-reference/events/list-events-1"},{"title":"List events","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /agents/{agentId}/threads/{threadId}/events","href":"/api-reference/events/list-events-2"},{"title":"Fleet event stream","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /fleets/{fleetId}/events/stream","href":"/api-reference/events/fleet-event-stream"},{"title":"Agent event stream","description":"Server-Sent Events stream. Each SSE data frame is JSON matching this response schema.","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /agents/{agentId}/events/stream","href":"/api-reference/events/agent-event-stream"},{"title":"Thread event stream","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /agents/{agentId}/threads/{threadId}/events/stream","href":"/api-reference/events/thread-event-stream"},{"title":"Thread message stream","description":"Server-Sent Events stream. Each SSE data frame is JSON matching this response schema.","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /agents/{agentId}/threads/{threadId}/stream","href":"/api-reference/events/thread-message-stream"}]},{"group":"Models","pages":[{"title":"List models","deprecated":null,"version":null,"openapi":"https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml get /models","href":"/api-reference/models/list-models"}]}]}]},"title":"Thread event stream - Cerca","buildId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","deploymentId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BRm_l__d.js","utils-f1l1Oc-G.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BlhqDhJO.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DHCB7rsC.js","snippetPresets-CYXLx6Hv.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-B78P2dEq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C4YLPVAh.js","shallow-vlLnTDkQ.js","getApiPlaygroundDisplay-D_98hhvf.js","CodeSnippet-DtnZHGqq.js","CodeSnippets-CLFb8KJt.js","Page-kQh739Uz.js","getPastedJson-Cq-zlbnU.js","icon-sN3t983t.js","MethodPill-P_YQ2s09.js","DuplicateIcon-BVzyNsGJ.js","createIcon-B3jqgqC6.js","DynamicMarkdown-Crwq6WG_.js","SectionHeading-C7pGS2Bb.js","axios-vUo_bRtp.js","Markdown-BuPH8yuW.js","clsx-CCOYKgaU.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BnkC_6oA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BM4S31-f.js"]}