Account API key from Developer Console. Keys start with cr_sk_.
Path Parameters
run_id
string<uuid>
required
CREAO CLI run ID.
Query Parameters
raw_output
boolean
default:false
When true, replace result.text with the persisted chat_text
(the full assistant transcript). Historical runs without
chat_text keep the stored text. Accepts true or false.
Response
Run object.
run_id
string<uuid>
required
CREAO CLI run ID.
status
enum<string>
required
Available options:
pending,
running,
completed,
failed,
cancelled
agent_id
string<uuid> | null
required
Agent that ran. Creation runs return null until the agent is created, then the completed run includes the new agent ID.
conversation_id
string<uuid> | null
required
Conversation ID for follow-up runs.
model
string | null
required
Model id this run executed with. null only for runs created before model selection shipped.
workspace_id
string<uuid> | null
Personal workspace bound to this conversation, when set.
result
object
Final agent output. Completed runs commonly include text; agent-creation runs also include agent_id.
Show child attributes
usage
object
Settlement credits plus an optional per-model breakdown for the run.
Omitted when the run incurred no cost and collected no model usage.
models is present only for Super Agent–allowlisted accounts.
Token fields appear only for token-metered capabilities. Per-image
and per-second capabilities use generated_images or duration_seconds
instead. kind tells the client which fields apply.
Show child attributes
error
object
Show child attributes
created_at
string<date-time>
started_at
string<date-time> | null
completed_at
string<date-time> | null
webhook_delivered_at
string<date-time> | null
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"CREAO Documentation","colors":{"primary":"#000000","light":"#666666","dark":"#333333"},"logo":{"light":"https://mintcdn.com/creaoagent/qsO6D45JE0FrSrZO/logo/light.svg?fit=max\u0026auto=format\u0026n=qsO6D45JE0FrSrZO\u0026q=85\u0026s=c85112c81c4c08190781587305b2c952","dark":"https://mintcdn.com/creaoagent/qsO6D45JE0FrSrZO/logo/dark.svg?fit=max\u0026auto=format\u0026n=qsO6D45JE0FrSrZO\u0026q=85\u0026s=569d79e8794145f8bb87aa5a5dde7cc7"},"favicon":"https://mintcdn.com/creaoagent/qsO6D45JE0FrSrZO/favicon.svg?fit=max\u0026auto=format\u0026n=qsO6D45JE0FrSrZO\u0026q=85\u0026s=1a8f63e36d68f08b47fab42c4fe0e7e2","api":{"playground":{"display":"simple"},"examples":{"defaults":"required","languages":["bash","node","python"],"prefill":true}},"navbar":{"links":[],"primary":{"type":"button","label":"Try CREAO","href":"https://agent.creao.ai"}},"footer":{"socials":{"x":"https://x.com/CreaoAI","linkedin":"https://www.linkedin.com/company/creaoai","discord":"https://discord.gg/VPNExXcP9W"}},"contextual":{"options":["copy","view","download-spec","chatgpt","claude","cursor"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"CREAO","icon":"rocket","href":"https://agent.creao.ai"},{"anchor":"Community","icon":"discord","href":"https://discord.gg/VPNExXcP9W"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"creaoagent","hasAudioNarration":false,"actualSubdomain":"creaoagent","customDomains":["docs.creao.ai"],"gitSource":{"type":"github","owner":"creaoai","repo":"creao-monorepo","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b0202b64546409c89e3b568","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"CREAO CLI","count":67},{"language":"default","tag":"Using CREAO","count":26},{"language":"default","tag":"Concepts","count":14},{"language":"default","tag":"Features","count":11},{"language":"default","tag":"Get Started","count":7},{"language":"default","tag":"Agents","count":7},{"language":"default","tag":"Rooms","count":7},{"language":"default","tag":"Skills","count":6},{"language":"default","tag":"Agent Brain","count":5},{"language":"default","tag":"Workspaces","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"developer-api/runs/get-run-status","slug":"/developer-api/runs/get-run-status","pageMetadata":{"title":"Get run status","description":"Fetch status, result, usage, and error details for a run.","deprecated":null,"version":null,"sidebarTitle":"Get run status","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/runs/{run_id}","href":"/developer-api/runs/get-run-status","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: \"Fetch status, result, usage, and error details for a run.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get run status","description":"Fetch status, result, usage, and error details for a run.","deprecated":null,"version":null,"sidebarTitle":"Get run status","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/runs/{run_id}","href":"/developer-api/runs/get-run-status","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Agent Runs"],"summary":"Get run status","description":"Fetch status, result, usage, and error details for a run.","operationId":"getRun","x-mint":{"href":"/developer-api/runs/get-run-status","metadata":{"title":"Get run status","description":"Fetch status, result, usage, and error details for a run."}},"parameters":["27eb7839-ad20-4d94-850f-ef740b07bbf2","c11ef070-f5f4-46a3-9f1f-83e609dfc5db"],"responses":{"200":"93a3a7da-0b57-4788-b05c-c41616e04e16","400":"2b5f0287-414b-4bd9-a721-2201234510b0","401":"6ef1b6c2-fa7c-457b-a279-2db31c062442","404":"e57db28d-eaa8-4adb-987a-3cf613ce079f","429":"158f411d-b525-4d74-9795-df95e095f456"},"method":"get","type":"path","servers":["c3247528-b36a-406e-ab4b-afdddf1d8bed"],"security":["c9a67c4b-4032-4d7c-8eea-c21e3fff086d","294a0a7a-720d-42aa-8c89-7bc8384ae5d0"],"path":"/v1/runs/{run_id}","baseUrlOptions":["https://developer.creao.ai"],"title":"Get run status","codeSamples":[],"requestExampleLanguages":["bash","node","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[]},"dependencies":{"parameters":{"27eb7839-ad20-4d94-850f-ef740b07bbf2":{"name":"run_id","in":"path","required":true,"description":"CREAO CLI run ID.","schema":{"type":"string","format":"uuid","isRequired":true,"description":"CREAO CLI run ID.","uniqueKey":"","typeLabel":"string\u003cuuid>"}},"c11ef070-f5f4-46a3-9f1f-83e609dfc5db":{"name":"raw_output","in":"query","required":false,"description":"When `true`, replace `result.text` with the persisted `chat_text`\n(the full assistant transcript). Historical runs without\n`chat_text` keep the stored `text`. Accepts `true` or `false`.\n","schema":{"type":"boolean","default":false,"isRequired":false,"description":"When `true`, replace `result.text` with the persisted `chat_text`\n(the full assistant transcript). Historical runs without\n`chat_text` keep the stored `text`. Accepts `true` or `false`.\n","uniqueKey":"","typeLabel":"boolean"}}},"responses":{"93a3a7da-0b57-4788-b05c-c41616e04e16":{"description":"Run object.","content":{"application/json":{"schema":{"type":"object","required":["run_id","status","agent_id","conversation_id","model"],"properties":{"run_id":{"type":"string","format":"uuid","description":"CREAO CLI run ID.","isRequired":true,"uniqueKey":"run_id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["pending","running","completed","failed","cancelled"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"agent_id":{"oneOf":[{"type":"string","description":"Agent that ran. Creation runs return `null` until the agent is created, then the completed run includes the new agent ID.","format":"uuid","isRequired":true,"uniqueKey":"agent_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","description":"Agent that ran. Creation runs return `null` until the agent is created, then the completed run includes the new agent ID.","isRequired":true,"uniqueKey":"agent_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"agent_id","typeLabel":"string\u003cuuid> | null"},"conversation_id":{"oneOf":[{"type":"string","description":"Conversation ID for follow-up runs.","format":"uuid","isRequired":true,"uniqueKey":"conversation_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","description":"Conversation ID for follow-up runs.","isRequired":true,"uniqueKey":"conversation_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"conversation_id","typeLabel":"string\u003cuuid> | null"},"model":{"oneOf":[{"type":"string","description":"Model id this run executed with. `null` only for runs created before model selection shipped.","isRequired":true,"uniqueKey":"model.oneOf.0","typeLabel":"string"},{"type":"null","description":"Model id this run executed with. `null` only for runs created before model selection shipped.","isRequired":true,"uniqueKey":"model.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"model","typeLabel":"string | null"},"workspace_id":{"oneOf":[{"type":"string","description":"Personal workspace bound to this conversation, when set.","format":"uuid","uniqueKey":"workspace_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","description":"Personal workspace bound to this conversation, when set.","uniqueKey":"workspace_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"workspace_id","typeLabel":"string\u003cuuid> | null"},"result":{"type":"object","additionalProperties":true,"description":"Final agent output. Completed runs commonly include `text`; agent-creation runs also include `agent_id`.","properties":{"agent_id":{"type":"string","format":"uuid","description":"New agent ID when a `POST /v1/agents` creation run completes.","uniqueKey":"result.agent_id","typeLabel":"string\u003cuuid>"},"agent_name":{"type":"string","uniqueKey":"result.agent_name","typeLabel":"string"},"text":{"type":"string","description":"Terminal result text. When the agent recorded a session summary, this is that summary JSON. Otherwise it is the full assistant transcript. Use `raw_output=true` on GET to prefer `chat_text`.","uniqueKey":"result.text","typeLabel":"string"},"chat_text":{"type":"string","description":"Full assistant transcript when it differs from `text`. Present on newly completed runs that also stored a session summary. Historical runs may omit this field.","uniqueKey":"result.chat_text","typeLabel":"string"},"blocks":{"type":"array","description":"Compact public render snapshot for the same vocabulary as the realtime stream. Multiple thinking blocks follow stream order. GET may include thinking `content`; list and webhooks stay marker-only. Artifact `url` is added only on GET hydrate.","items":{"oneOf":[{"type":"object","required":["type","content"],"properties":{"type":{"type":"string","const":"text","isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.0.type","typeLabel":"string"},"content":{"type":"string","isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.0.content","typeLabel":"string"}},"uniqueKey":"result.blocks.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"thinking","isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.1.type","typeLabel":"string"},"content":{"type":"string","description":"Thinking text for this span. Present on a completed-run GET after hydrate. Omitted from the persisted snapshot, list, and webhooks.","uniqueKey":"result.blocks.items.[INDEX].oneOf.1.content","typeLabel":"string"}},"uniqueKey":"result.blocks.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","tool_call_id","tool","title","status"],"properties":{"type":{"type":"string","const":"tool","isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.2.type","typeLabel":"string"},"tool_call_id":{"type":"string","isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.2.tool_call_id","typeLabel":"string"},"tool":{"type":"string","isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.2.tool","typeLabel":"string"},"title":{"type":"string","isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.2.title","typeLabel":"string"},"status":{"type":"string","enum":["running","completed","failed"],"isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.2.status","typeLabel":"enum\u003cstring>"}},"uniqueKey":"result.blocks.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["type","search_id","kind","query","results"],"properties":{"type":{"type":"string","const":"search","isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.3.type","typeLabel":"string"},"search_id":{"type":"string","isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.3.search_id","typeLabel":"string"},"kind":{"type":"string","enum":["web","academic"],"isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.3.kind","typeLabel":"enum\u003cstring>"},"query":{"type":"string","isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.3.query","typeLabel":"string"},"results":{"type":"array","items":{"type":"object","required":["url","title","domain"],"properties":{"url":{"type":"string","isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.3.results.items.[INDEX].url","typeLabel":"string"},"title":{"type":"string","isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.3.results.items.[INDEX].title","typeLabel":"string"},"domain":{"type":"string","isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.3.results.items.[INDEX].domain","typeLabel":"string"},"authors":{"type":"array","items":{"type":"string","uniqueKey":"result.blocks.items.[INDEX].oneOf.3.results.items.[INDEX].authors.items.[INDEX]","typeLabel":"string"},"uniqueKey":"result.blocks.items.[INDEX].oneOf.3.results.items.[INDEX].authors","typeLabel":"string[]"},"venue":{"type":"string","uniqueKey":"result.blocks.items.[INDEX].oneOf.3.results.items.[INDEX].venue","typeLabel":"string"},"year":{"type":"integer","uniqueKey":"result.blocks.items.[INDEX].oneOf.3.results.items.[INDEX].year","typeLabel":"integer"},"cited_by_count":{"type":"integer","uniqueKey":"result.blocks.items.[INDEX].oneOf.3.results.items.[INDEX].cited_by_count","typeLabel":"integer"},"pdf_url":{"type":"string","uniqueKey":"result.blocks.items.[INDEX].oneOf.3.results.items.[INDEX].pdf_url","typeLabel":"string"}},"uniqueKey":"result.blocks.items.[INDEX].oneOf.3.results.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.3.results","typeLabel":"object[]"}},"uniqueKey":"result.blocks.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["type","items"],"properties":{"type":{"type":"string","const":"todo","isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.4.type","typeLabel":"string"},"items":{"type":"array","items":{"type":"object","required":["content","status"],"properties":{"content":{"type":"string","isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.4.\\items.items.[INDEX].content","typeLabel":"string"},"status":{"type":"string","enum":["pending","in_progress","completed","skipped","cancelled"],"isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.4.\\items.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"uniqueKey":"result.blocks.items.[INDEX].oneOf.4.\\items.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.4.\\items","typeLabel":"object[]"}},"uniqueKey":"result.blocks.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","required":["type","artifact_id","kind","title"],"properties":{"type":{"type":"string","const":"artifact","isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.5.type","typeLabel":"string"},"artifact_id":{"type":"string","isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.5.artifact_id","typeLabel":"string"},"kind":{"type":"string","enum":["file","image"],"isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.5.kind","typeLabel":"enum\u003cstring>"},"title":{"type":"string","isRequired":true,"uniqueKey":"result.blocks.items.[INDEX].oneOf.5.title","typeLabel":"string"},"mime_type":{"type":"string","uniqueKey":"result.blocks.items.[INDEX].oneOf.5.mime_type","typeLabel":"string"},"url":{"oneOf":[{"type":"string","format":"uri","uniqueKey":"result.blocks.items.[INDEX].oneOf.5.url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","uniqueKey":"result.blocks.items.[INDEX].oneOf.5.url.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.blocks.items.[INDEX].oneOf.5.url","typeLabel":"string\u003curi> | null"},"url_expires_at":{"type":"string","format":"date-time","uniqueKey":"result.blocks.items.[INDEX].oneOf.5.url_expires_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"result.blocks.items.[INDEX].oneOf.5","typeLabel":"object"}],"uniqueKey":"result.blocks.items.[INDEX]","typeLabel":"object"},"uniqueKey":"result.blocks","typeLabel":"object[]"},"artifacts":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string","uniqueKey":"result.artifacts.items.[INDEX].id","typeLabel":"string"},"title":{"type":"string","uniqueKey":"result.artifacts.items.[INDEX].title","typeLabel":"string"},"type":{"type":"string","uniqueKey":"result.artifacts.items.[INDEX].type","typeLabel":"string"},"url":{"oneOf":[{"type":"string","description":"Short-lived download URL issued when fetching a run. `null` when the artifact has no durable file or the key cannot be signed.","format":"uri","uniqueKey":"result.artifacts.items.[INDEX].url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","description":"Short-lived download URL issued when fetching a run. `null` when the artifact has no durable file or the key cannot be signed.","uniqueKey":"result.artifacts.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.artifacts.items.[INDEX].url","typeLabel":"string\u003curi> | null"},"url_expires_at":{"type":"string","format":"date-time","description":"Expiry of `url`. Omitted when `url` is null.","uniqueKey":"result.artifacts.items.[INDEX].url_expires_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"result.artifacts.items.[INDEX]","typeLabel":"object"},"uniqueKey":"result.artifacts","typeLabel":"object[]"}},"uniqueKey":"result","typeLabel":"object"},"usage":{"type":"object","description":"Settlement credits plus an optional per-model breakdown for the run.\nOmitted when the run incurred no cost and collected no model usage.\n`models` is present only for Super Agent–allowlisted accounts.\nToken fields appear only for token-metered capabilities. Per-image\nand per-second capabilities use `generated_images` or `duration_seconds`\ninstead. `kind` tells the client which fields apply.\n","properties":{"credits":{"type":"number","description":"Credits attributed to this CREAO CLI run. Settlement figure when cost is greater than zero.","uniqueKey":"usage.credits","typeLabel":"number"},"models":{"type":"array","description":"One row per `(model, kind)` aggregated for the run. Top-level `model`\nremains the requested chat model. Non-model bridge spend such as\nPDF parse is excluded.\n","items":{"type":"object","required":["model","kind"],"properties":{"model":{"type":"string","maxLength":100,"description":"Model id that produced this usage row.","isRequired":true,"uniqueKey":"usage.models.items.[INDEX].model","typeLabel":"string"},"kind":{"type":"string","enum":["chat","image_analysis","image_generation","video_generation","speech_to_text","text_to_speech","music_generation"],"isRequired":true,"uniqueKey":"usage.models.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"input_tokens":{"type":"integer","minimum":0,"uniqueKey":"usage.models.items.[INDEX].input_tokens","typeLabel":"integer"},"output_tokens":{"type":"integer","minimum":0,"uniqueKey":"usage.models.items.[INDEX].output_tokens","typeLabel":"integer"},"cache_read_tokens":{"type":"integer","minimum":0,"uniqueKey":"usage.models.items.[INDEX].cache_read_tokens","typeLabel":"integer"},"cache_write_tokens":{"type":"integer","minimum":0,"uniqueKey":"usage.models.items.[INDEX].cache_write_tokens","typeLabel":"integer"},"generated_images":{"type":"integer","minimum":0,"description":"Present for per-image billing (for example GPT Image or Seedream).","uniqueKey":"usage.models.items.[INDEX].generated_images","typeLabel":"integer"},"duration_seconds":{"type":"number","minimum":0,"description":"Present for per-second video billing (for example Veo).","uniqueKey":"usage.models.items.[INDEX].duration_seconds","typeLabel":"number"}},"uniqueKey":"usage.models.items.[INDEX]","typeLabel":"object"},"uniqueKey":"usage.models","typeLabel":"object[]"}},"uniqueKey":"usage","typeLabel":"object"},"error":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Stable machine-readable failure code.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"},"created_at":{"type":"string","format":"date-time","uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"started_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"started_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","uniqueKey":"started_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"started_at","typeLabel":"string\u003cdate-time> | null"},"completed_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"completed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","uniqueKey":"completed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"completed_at","typeLabel":"string\u003cdate-time> | null"},"webhook_delivered_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"webhook_delivered_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","uniqueKey":"webhook_delivered_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"webhook_delivered_at","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"completed":{"title":"completed","value":{"run_id":"11111111-1111-4111-8111-111111111111","status":"completed","agent_id":"00000000-0000-4000-8000-000000000000","conversation_id":"22222222-2222-4222-8222-222222222222","model":"anthropic/claude-sonnet-5-5","result":{"text":"Done."},"usage":{"credits":2.5,"models":[{"model":"anthropic/claude-sonnet-5-5","kind":"chat","input_tokens":8000,"output_tokens":400,"cache_read_tokens":6000,"cache_write_tokens":200}]},"created_at":"2026-07-03T10:00:00.000Z","started_at":"2026-07-03T10:00:02.000Z","completed_at":"2026-07-03T10:00:30.000Z","webhook_delivered_at":null}}},"exampleType":"examples"}},"exampleType":"examples"},"2b5f0287-414b-4bd9-a721-2201234510b0":{"description":"Invalid request shape, invalid UUID, unsupported model, or unsupported status filter.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Debug message. Do not rely on this field in production clients.","uniqueKey":"message","typeLabel":"string"},"available":{"type":"number","description":"Available credits, when returned for credit errors.","uniqueKey":"available","typeLabel":"number"},"required":{"type":"number","description":"Required credits, when returned for credit errors.","uniqueKey":"required","typeLabel":"number"},"retryAfterSeconds":{"type":"integer","description":"Retry delay, when returned for hourly cap errors.","uniqueKey":"retryAfterSeconds","typeLabel":"integer"},"reason":{"type":"string","description":"A readable explanation on `400` and `409` room and agent bundle errors. Do not branch on it.","uniqueKey":"reason","typeLabel":"string"},"latest_version":{"type":"string","description":"The agent's latest saved version, on `AGENT_VERSION_NOT_INCREASED`.","uniqueKey":"latest_version","typeLabel":"string"},"candidates":{"type":"array","description":"Members a `ROOM_MENTION_AMBIGUOUS` name matches. Resend with one of their ids in `mentions` to pick it.","items":{"type":"object","properties":{"member_id":{"type":"string","format":"uuid","uniqueKey":"candidates.items.[INDEX].member_id","typeLabel":"string\u003cuuid>"},"kind":{"type":"string","enum":["user","agent"],"uniqueKey":"candidates.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","uniqueKey":"candidates.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"candidates.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"candidates.items.[INDEX].name","typeLabel":"string | null"}},"uniqueKey":"candidates.items.[INDEX]","typeLabel":"object"},"uniqueKey":"candidates","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"invalidInput":{"title":"invalidInput","value":{"error":"INVALID_INPUT"}},"modelNotSupported":{"title":"modelNotSupported","value":{"error":"MODEL_NOT_SUPPORTED"}}},"exampleType":"examples"}},"exampleType":"examples"},"6ef1b6c2-fa7c-457b-a279-2db31c062442":{"description":"Missing, malformed, revoked, or unknown Account API key.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Debug message. Do not rely on this field in production clients.","uniqueKey":"message","typeLabel":"string"},"available":{"type":"number","description":"Available credits, when returned for credit errors.","uniqueKey":"available","typeLabel":"number"},"required":{"type":"number","description":"Required credits, when returned for credit errors.","uniqueKey":"required","typeLabel":"number"},"retryAfterSeconds":{"type":"integer","description":"Retry delay, when returned for hourly cap errors.","uniqueKey":"retryAfterSeconds","typeLabel":"integer"},"reason":{"type":"string","description":"A readable explanation on `400` and `409` room and agent bundle errors. Do not branch on it.","uniqueKey":"reason","typeLabel":"string"},"latest_version":{"type":"string","description":"The agent's latest saved version, on `AGENT_VERSION_NOT_INCREASED`.","uniqueKey":"latest_version","typeLabel":"string"},"candidates":{"type":"array","description":"Members a `ROOM_MENTION_AMBIGUOUS` name matches. Resend with one of their ids in `mentions` to pick it.","items":{"type":"object","properties":{"member_id":{"type":"string","format":"uuid","uniqueKey":"candidates.items.[INDEX].member_id","typeLabel":"string\u003cuuid>"},"kind":{"type":"string","enum":["user","agent"],"uniqueKey":"candidates.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","uniqueKey":"candidates.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"candidates.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"candidates.items.[INDEX].name","typeLabel":"string | null"}},"uniqueKey":"candidates.items.[INDEX]","typeLabel":"object"},"uniqueKey":"candidates","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"missingKey":{"title":"missingKey","value":{"error":"AUTHENTICATION_REQUIRED"}}},"exampleType":"examples"}},"exampleType":"examples"},"e57db28d-eaa8-4adb-987a-3cf613ce079f":{"description":"Run not found for this account.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Debug message. Do not rely on this field in production clients.","uniqueKey":"message","typeLabel":"string"},"available":{"type":"number","description":"Available credits, when returned for credit errors.","uniqueKey":"available","typeLabel":"number"},"required":{"type":"number","description":"Required credits, when returned for credit errors.","uniqueKey":"required","typeLabel":"number"},"retryAfterSeconds":{"type":"integer","description":"Retry delay, when returned for hourly cap errors.","uniqueKey":"retryAfterSeconds","typeLabel":"integer"},"reason":{"type":"string","description":"A readable explanation on `400` and `409` room and agent bundle errors. Do not branch on it.","uniqueKey":"reason","typeLabel":"string"},"latest_version":{"type":"string","description":"The agent's latest saved version, on `AGENT_VERSION_NOT_INCREASED`.","uniqueKey":"latest_version","typeLabel":"string"},"candidates":{"type":"array","description":"Members a `ROOM_MENTION_AMBIGUOUS` name matches. Resend with one of their ids in `mentions` to pick it.","items":{"type":"object","properties":{"member_id":{"type":"string","format":"uuid","uniqueKey":"candidates.items.[INDEX].member_id","typeLabel":"string\u003cuuid>"},"kind":{"type":"string","enum":["user","agent"],"uniqueKey":"candidates.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","uniqueKey":"candidates.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"candidates.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"candidates.items.[INDEX].name","typeLabel":"string | null"}},"uniqueKey":"candidates.items.[INDEX]","typeLabel":"object"},"uniqueKey":"candidates","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"runNotFound":{"title":"runNotFound","value":{"error":"RUN_NOT_FOUND"}}},"exampleType":"examples"}},"exampleType":"examples"},"158f411d-b525-4d74-9795-df95e095f456":{"description":"Account-level or IP-level rate limit exceeded.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Debug message. Do not rely on this field in production clients.","uniqueKey":"message","typeLabel":"string"},"available":{"type":"number","description":"Available credits, when returned for credit errors.","uniqueKey":"available","typeLabel":"number"},"required":{"type":"number","description":"Required credits, when returned for credit errors.","uniqueKey":"required","typeLabel":"number"},"retryAfterSeconds":{"type":"integer","description":"Retry delay, when returned for hourly cap errors.","uniqueKey":"retryAfterSeconds","typeLabel":"integer"},"reason":{"type":"string","description":"A readable explanation on `400` and `409` room and agent bundle errors. Do not branch on it.","uniqueKey":"reason","typeLabel":"string"},"latest_version":{"type":"string","description":"The agent's latest saved version, on `AGENT_VERSION_NOT_INCREASED`.","uniqueKey":"latest_version","typeLabel":"string"},"candidates":{"type":"array","description":"Members a `ROOM_MENTION_AMBIGUOUS` name matches. Resend with one of their ids in `mentions` to pick it.","items":{"type":"object","properties":{"member_id":{"type":"string","format":"uuid","uniqueKey":"candidates.items.[INDEX].member_id","typeLabel":"string\u003cuuid>"},"kind":{"type":"string","enum":["user","agent"],"uniqueKey":"candidates.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","uniqueKey":"candidates.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"candidates.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"candidates.items.[INDEX].name","typeLabel":"string | null"}},"uniqueKey":"candidates.items.[INDEX]","typeLabel":"object"},"uniqueKey":"candidates","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"rateLimited":{"title":"rateLimited","value":{"error":"RATE_LIMITED"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"c9a67c4b-4032-4d7c-8eea-c21e3fff086d":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"cr_sk","description":"Account API key from Developer Console. Keys start with `cr_sk_`.","x-default":"cr_sk_your_key_here","scopes":[],"schemeName":"bearerAuth"}},"294a0a7a-720d-42aa-8c89-7bc8384ae5d0":{"apiKeyQuery":{"type":"apiKey","in":"query","name":"creao-api-key","description":"Account API key passed as a query parameter, for platforms that cannot\nset a custom Authorization header. The bearerAuth header takes\nprecedence when both are present.\n","x-default":"cr_sk_your_key_here","scopes":[],"schemeName":"apiKeyQuery"}}},"servers":{"c3247528-b36a-406e-ab4b-afdddf1d8bed":{"url":"https://developer.creao.ai","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"cr_sk","description":"Account API key from Developer Console. Keys start with `cr_sk_`.","x-default":"cr_sk_your_key_here","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Account API key from Developer Console. Keys start with `cr_sk_`.","format":"bearer","default":"cr_sk_your_key_here","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"},{"schemes":[{"scheme":{"type":"apiKey","in":"query","name":"creao-api-key","description":"Account API key passed as a query parameter, for platforms that cannot\nset a custom Authorization header. The bearerAuth header takes\nprecedence when both are present.\n","x-default":"cr_sk_your_key_here","scopes":[],"schemeName":"apiKeyQuery"},"schema":{"title":"creao-api-key","type":"string","description":"Account API key passed as a query parameter, for platforms that cannot\nset a custom Authorization header. The bearerAuth header takes\nprecedence when both are present.\n","isRequired":true,"default":"cr_sk_your_key_here","typeLabel":"string","deprecated":false},"schemeName":"apiKeyQuery","name":"creao-api-key"}],"title":"apiKeyQuery"}]},"originalFileLocation":"developer-api/developer-v1.openapi.yaml"},"subdomain":"creaoagent","siteName":"CREAO Documentation","title":"Get run status - CREAO Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-14T02:48:58.541Z","originalFileLocation":"developer-api/runs/get-run-status.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=\"Fetch status, result, usage, and error details for a run.\">\u003cmeta data-mint-head name=\"application-name\" content=\"CREAO Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/creaoagent/tUWWd22AgUwL896o/_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/creaoagent/tUWWd22AgUwL896o/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/creaoagent/tUWWd22AgUwL896o/_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/creaoagent/tUWWd22AgUwL896o/_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/creaoagent/tUWWd22AgUwL896o/_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/creaoagent/tUWWd22AgUwL896o/_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/creaoagent/tUWWd22AgUwL896o/_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/creaoagent/tUWWd22AgUwL896o/_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/creaoagent/tUWWd22AgUwL896o/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get run status - CREAO Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Fetch status, result, usage, and error details for a run.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"CREAO Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.creao.ai/developer-api/runs/get-run-status\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://creaoagent.mintlify.site/_mintlify/api/og/v2?division=Agent+Runs\u0026amp;title=Get+run+status\u0026amp;description=Fetch+status%2C+result%2C+usage%2C+and+error+details+for+a+run.\u0026amp;theme=517419ff71a0ccc56d7c2a68\u0026amp;signature=dcd942944c266dc6624eacc464816fdf95f0c061a1d8ec0a6af3b496f4fce2e9\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get run status - CREAO Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Fetch status, result, usage, and error details for a run.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://creaoagent.mintlify.site/_mintlify/api/og/v2?division=Agent+Runs\u0026amp;title=Get+run+status\u0026amp;description=Fetch+status%2C+result%2C+usage%2C+and+error+details+for+a+run.\u0026amp;theme=517419ff71a0ccc56d7c2a68\u0026amp;signature=dcd942944c266dc6624eacc464816fdf95f0c061a1d8ec0a6af3b496f4fce2e9\">\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/creaoagent/tUWWd22AgUwL896o/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"CREAO Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.creao.ai/developer-api/runs/get-run-status\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/developer-api/runs/get-run-status.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.creao.ai/#organization\",\"name\":\"CREAO Documentation\",\"url\":\"https://docs.creao.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/creaoagent/qsO6D45JE0FrSrZO/logo/light.svg?fit=max\u0026auto=format\u0026n=qsO6D45JE0FrSrZO\u0026q=85\u0026s=c85112c81c4c08190781587305b2c952\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.creao.ai#website\",\"name\":\"CREAO Documentation\",\"url\":\"https://docs.creao.ai\",\"publisher\":{\"@id\":\"https://docs.creao.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.creao.ai/developer-api/runs/get-run-status#webpage\",\"url\":\"https://docs.creao.ai/developer-api/runs/get-run-status\",\"name\":\"Get run status\",\"description\":\"Fetch status, result, usage, and error details for a run.\",\"dateModified\":\"2026-11-14T02:48:58.541Z\",\"isPartOf\":{\"@id\":\"https://docs.creao.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.creao.ai/developer-api/runs/get-run-status#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.creao.ai/developer-api/runs/get-run-status#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Agent Runs\",\"item\":\"https://docs.creao.ai/developer-api/runs/create-async-run\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get run status\",\"item\":\"https://docs.creao.ai/developer-api/runs/get-run-status\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.creao.ai/developer-api/runs/get-run-status#apireference\",\"headline\":\"Get run status\",\"name\":\"Get run status\",\"description\":\"Fetch status, result, usage, and error details for a run.\",\"url\":\"https://docs.creao.ai/developer-api/runs/get-run-status\",\"mainEntityOfPage\":{\"@id\":\"https://docs.creao.ai/developer-api/runs/get-run-status#webpage\"},\"dateModified\":\"2026-11-14T02:48:58.541Z\",\"publisher\":{\"@id\":\"https://docs.creao.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.creao.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"CREAO Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"CREAO Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/developer-api/runs/get-run-status.md","siteName":"CREAO Documentation","nav":{"global":{"anchors":[{"anchor":"CREAO","icon":"rocket","href":"https://agent.creao.ai"},{"anchor":"Community","icon":"discord","href":"https://discord.gg/VPNExXcP9W"}]},"tabs":[{"tab":"Using CREAO","pages":[{"title":"Using CREAO","href":""}]},{"tab":"CREAO CLI","groups":[{"group":"Get Started","pages":[{"title":"CREAO CLI Overview","href":"/developer-api/overview"},{"title":"CREAO CLI Quickstart","href":"/developer-api/quickstart"},{"title":"Authentication","href":"/developer-api/authentication"},{"title":"Supported Models","href":"/developer-api/supported-models"}]},{"group":"Agents","pages":[{"title":"Create an agent","deprecated":null,"version":null,"sidebarTitle":"Create agent","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/agents","href":"/developer-api/agents/create-agent"},{"title":"List agents","deprecated":null,"version":null,"sidebarTitle":"List agents","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/agents","href":"/developer-api/agents/list-agents"},{"title":"Get an agent","deprecated":null,"version":null,"sidebarTitle":"Get agent","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/agents/{agent_id}","href":"/developer-api/agents/get-agent"},{"title":"Replace an agent","deprecated":null,"version":null,"sidebarTitle":"Replace agent","openapi":"/developer-api/developer-v1.openapi.yaml put /v1/agents/{agent_id}","href":"/developer-api/agents/replace-agent"},{"title":"Update agent settings","deprecated":null,"version":null,"sidebarTitle":"Update agent","openapi":"/developer-api/developer-v1.openapi.yaml patch /v1/agents/{agent_id}","href":"/developer-api/agents/update-agent"},{"title":"Edit an agent from instructions","deprecated":null,"version":null,"sidebarTitle":"Create agent edit","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/agents/{agent_id}/edits","href":"/developer-api/agents/create-agent-edit"},{"title":"Get agent edit status","deprecated":null,"version":null,"sidebarTitle":"Get agent edit","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/agents/{agent_id}/edits/{run_id}","href":"/developer-api/agents/get-agent-edit"}]},{"group":"Agent Memory","pages":[{"title":"Get agent memory","deprecated":null,"version":null,"sidebarTitle":"Get agent memory","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/agents/{agent_id}/memory","href":"/developer-api/agent-memory/get-agent-memory"},{"title":"Replace agent memory","deprecated":null,"version":null,"sidebarTitle":"Replace agent memory","openapi":"/developer-api/developer-v1.openapi.yaml put /v1/agents/{agent_id}/memory","href":"/developer-api/agent-memory/replace-agent-memory"},{"title":"Clear agent memory","deprecated":null,"version":null,"sidebarTitle":"Clear agent memory","openapi":"/developer-api/developer-v1.openapi.yaml delete /v1/agents/{agent_id}/memory","href":"/developer-api/agent-memory/clear-agent-memory"}]},{"group":"Agent Files","pages":[{"title":"List agent files","deprecated":null,"version":null,"sidebarTitle":"List agent files","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/agents/{agent_id}/files","href":"/developer-api/agent-files/list-agent-files"},{"title":"Get agent file","deprecated":null,"version":null,"sidebarTitle":"Get agent file","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/agents/{agent_id}/files/{file_id}","href":"/developer-api/agent-files/get-agent-file"}]},{"group":"Product Profile","pages":[{"title":"Get product profile","deprecated":null,"version":null,"sidebarTitle":"Get product profile","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/product-profile","href":"/developer-api/product-profile/get-product-profile"},{"title":"Replace product profile","deprecated":null,"version":null,"sidebarTitle":"Put product profile","openapi":"/developer-api/developer-v1.openapi.yaml put /v1/product-profile","href":"/developer-api/product-profile/put-product-profile"}]},{"group":"Agent Runs","pages":[{"title":"Create an async run","description":"Start a background CREAO CLI run.","deprecated":null,"version":null,"sidebarTitle":"Create async run","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/runs","href":"/developer-api/runs/create-async-run"},{"title":"Get run status","deprecated":null,"version":null,"sidebarTitle":"Get run status","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/runs/{run_id}","href":"/developer-api/runs/get-run-status"},{"title":"List runs","description":"Fetch recent CREAO CLI runs with optional status filtering.","deprecated":null,"version":null,"sidebarTitle":"List runs","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/runs","href":"/developer-api/runs/list-runs"},{"title":"Create a realtime run","deprecated":null,"version":null,"sidebarTitle":"Create realtime run","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/realtime/runs","href":"/developer-api/runs/create-realtime-run"}]},{"group":"Super Agent","pages":[{"title":"Create a Super Agent async run","deprecated":null,"version":null,"sidebarTitle":"Create async run","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/super-agent/runs","href":"/developer-api/super-agent/create-async-run"},{"title":"Get Super Agent run status","deprecated":null,"version":null,"sidebarTitle":"Get run status","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/super-agent/runs/{run_id}","href":"/developer-api/super-agent/get-run-status"},{"title":"List Super Agent runs","deprecated":null,"version":null,"sidebarTitle":"List runs","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/super-agent/runs","href":"/developer-api/super-agent/list-runs"},{"title":"Create a Super Agent realtime run","deprecated":null,"version":null,"sidebarTitle":"Create realtime run","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/super-agent/realtime/runs","href":"/developer-api/super-agent/create-realtime-run"}]},{"group":"Account","pages":[{"title":"Get account usage","deprecated":null,"version":null,"sidebarTitle":"Get account usage","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/account/usage","href":"/developer-api/account/get-account-usage"}]},{"group":"Workspaces","pages":[{"title":"List workspaces","deprecated":null,"version":null,"sidebarTitle":"List workspaces","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/workspaces","href":"/developer-api/workspaces/list-workspaces"},{"title":"Create a workspace","deprecated":null,"version":null,"sidebarTitle":"Create workspace","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/workspaces","href":"/developer-api/workspaces/create-workspace"},{"title":"Get a workspace","deprecated":null,"version":null,"sidebarTitle":"Get workspace","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/workspaces/{workspace_id}","href":"/developer-api/workspaces/get-workspace"},{"title":"Add an agent to a workspace","deprecated":null,"version":null,"sidebarTitle":"Add workspace agent","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/workspaces/{workspace_id}/agents","href":"/developer-api/workspaces/add-workspace-agent"},{"title":"Remove an agent from a workspace","deprecated":null,"version":null,"sidebarTitle":"Remove workspace agent","openapi":"/developer-api/developer-v1.openapi.yaml delete /v1/workspaces/{workspace_id}/agents/{agent_id}","href":"/developer-api/workspaces/remove-workspace-agent"}]},{"group":"Workspace Files","pages":[{"title":"List workspace files","deprecated":null,"version":null,"sidebarTitle":"List workspace files","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/workspaces/{workspace_id}/files","href":"/developer-api/workspace-files/list-workspace-files"},{"title":"Upload a workspace file","deprecated":null,"version":null,"sidebarTitle":"Upload workspace file","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/workspaces/{workspace_id}/files","href":"/developer-api/workspace-files/upload-workspace-file"},{"title":"Get workspace file","deprecated":null,"version":null,"sidebarTitle":"Get workspace file","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/workspaces/{workspace_id}/files/{file_id}","href":"/developer-api/workspace-files/get-workspace-file"},{"title":"Delete workspace file","deprecated":null,"version":null,"sidebarTitle":"Delete workspace file","openapi":"/developer-api/developer-v1.openapi.yaml delete /v1/workspaces/{workspace_id}/files/{file_id}","href":"/developer-api/workspace-files/delete-workspace-file"}]},{"group":"Secrets","pages":[{"title":"List secret keys","deprecated":null,"version":null,"sidebarTitle":"List secrets","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/secrets","href":"/developer-api/secrets/list-secrets"},{"title":"Add a secret","deprecated":null,"version":null,"sidebarTitle":"Create secret","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/secrets","href":"/developer-api/secrets/create-secret"},{"title":"Update a secret","deprecated":null,"version":null,"sidebarTitle":"Update secret","openapi":"/developer-api/developer-v1.openapi.yaml patch /v1/secrets/{name}","href":"/developer-api/secrets/update-secret"},{"title":"Delete a secret","deprecated":null,"version":null,"sidebarTitle":"Delete secret","openapi":"/developer-api/developer-v1.openapi.yaml delete /v1/secrets/{name}","href":"/developer-api/secrets/delete-secret"}]},{"group":"Skills","pages":[{"title":"List skills","deprecated":null,"version":null,"sidebarTitle":"List skills","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/skills","href":"/developer-api/skills/list-skills"},{"title":"Install a skill","deprecated":null,"version":null,"sidebarTitle":"Install skill","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/skills","href":"/developer-api/skills/install-skill"},{"title":"Get a skill","deprecated":null,"version":null,"sidebarTitle":"Get skill","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/skills/{skill_id}","href":"/developer-api/skills/get-skill"},{"title":"Enable a skill","deprecated":null,"version":null,"sidebarTitle":"Enable skill","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/skills/{skill_id}/enable","href":"/developer-api/skills/enable-skill"},{"title":"Disable a skill","deprecated":null,"version":null,"sidebarTitle":"Disable skill","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/skills/{skill_id}/disable","href":"/developer-api/skills/disable-skill"},{"title":"Refresh a skill","deprecated":null,"version":null,"sidebarTitle":"Refresh skill","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/skills/{skill_id}/refresh","href":"/developer-api/skills/refresh-skill"}]},{"group":"Rooms","pages":[{"title":"List rooms","deprecated":null,"version":null,"sidebarTitle":"List rooms","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/rooms","href":"/developer-api/rooms/list-rooms"},{"title":"Get a room","deprecated":null,"version":null,"sidebarTitle":"Get room","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/rooms/{room_id}","href":"/developer-api/rooms/get-room"},{"title":"List room messages","deprecated":null,"version":null,"sidebarTitle":"List room messages","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/rooms/{room_id}/messages","href":"/developer-api/rooms/list-room-messages"},{"title":"Post a room message","deprecated":null,"version":null,"sidebarTitle":"Post room message","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/rooms/{room_id}/messages","href":"/developer-api/rooms/post-room-message"},{"title":"List room channels","deprecated":null,"version":null,"sidebarTitle":"List room channels","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/rooms/{room_id}/channels","href":"/developer-api/rooms/list-room-channels"},{"title":"List room agents","deprecated":null,"version":null,"sidebarTitle":"List room agents","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/rooms/{room_id}/agents","href":"/developer-api/rooms/list-room-agents"},{"title":"Stream room events","deprecated":null,"version":null,"sidebarTitle":"Stream room events","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/rooms/{room_id}/events","href":"/developer-api/rooms/stream-room-events"}]},{"group":"Concepts","pages":[{"title":"Conversations","href":"/developer-api/conversations"},{"title":"Agent memory","href":"/developer-api/agent-memory"},{"title":"Agent files","href":"/developer-api/agent-files"},{"title":"Workspace files","href":"/developer-api/workspace-files"},{"title":"Workspaces","href":"/developer-api/workspaces"},{"title":"Secrets","href":"/developer-api/secrets"},{"title":"Skills","href":"/developer-api/skills"},{"title":"Rooms","href":"/developer-api/rooms"},{"title":"Models","href":"/developer-api/models"},{"title":"Streaming Events","href":"/developer-api/streaming-events"},{"title":"Webhooks","href":"/developer-api/webhooks"},{"title":"Errors","href":"/developer-api/errors"},{"title":"Rate Limits","href":"/developer-api/rate-limits"},{"title":"API Paths","href":"/developer-api/api-paths"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/community-and-updates/changelog"}]},{"tab":"Community","pages":[{"title":"Community","href":"/community-and-updates/community-hub"}]}]},"basePath":"","title":"Get run status - CREAO Documentation","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}