{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Fabro","colors":{"primary":"#357F9E","light":"#67B2D7","dark":"#357F9E"},"logo":{"light":"https://mintcdn.com/qltysoftware-21b56213/-urDLCwpQ5cwP5xH/logo/light.svg?fit=max\u0026auto=format\u0026n=-urDLCwpQ5cwP5xH\u0026q=85\u0026s=6956186f08cfc81047825dc8804d608d","dark":"https://mintcdn.com/qltysoftware-21b56213/-urDLCwpQ5cwP5xH/logo/dark.svg?fit=max\u0026auto=format\u0026n=-urDLCwpQ5cwP5xH\u0026q=85\u0026s=d81187a35e5416e36f882a582c9081b0"},"favicon":"https://mintcdn.com/qltysoftware-21b56213/cmr0Bl6XIobDw8XV/favicon.svg?fit=max\u0026auto=format\u0026n=cmr0Bl6XIobDw8XV\u0026q=85\u0026s=bccc7de06947c121e4aaa40f1eb786b7","navbar":{"primary":{"type":"button","label":"Get Started","href":"/getting-started/introduction"}},"footer":{"socials":{"x":"https://x.com/fabro_sh","github":"https://github.com/fabro-sh"}},"styling":{"codeblocks":{"languages":{"custom":["/languages/dot.json","/languages/fabro.json"]}},"latex":true},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"qltysoftware-21b56213","hasAudioNarration":false,"actualSubdomain":"qltysoftware-21b56213","customDomains":["docs.fabro.sh"],"gitSource":{"type":"github","owner":"fabro-sh","repo":"fabro","deployBranch":"main","contentDirectory":"docs/public","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adb96dbe291c0b0d5a6a18b","collectionId":"283b34c7-9ab1-4c61-b560-6a956d8e8b19","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adb96dbe291c0b0d5a6a18b"},"entitlements":{},"buildId":"6adb96dbe291c0b0d5a6a18b","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"Changelog","count":144},{"language":"default","tag":"Documentation","count":65},{"language":"default","tag":"API Reference","count":46},{"language":"default","tag":"March 2026","count":29},{"language":"default","tag":"April 2026","count":28},{"language":"default","tag":"May 2026","count":28},{"language":"default","tag":"July 2026","count":18},{"language":"default","tag":"June 2026","count":17},{"language":"default","tag":"August 2026","count":17},{"language":"default","tag":"Guides","count":16}]},"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":true},"customCss":[],"page":{"pagePath":"api-reference/automations/create-automation-run","slug":"/api-reference/automations/create-automation-run","pageMetadata":{"title":"Create automation run","description":"Creates a new run by firing the automation's enabled API trigger.","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml post /api/v1/automations/{id}/runs","href":"/api-reference/automations/create-automation-run","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: \"Creates a new run by firing the automation’s enabled API trigger.\"\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":{"codeStyling":{"languages":{"custom":["/languages/dot.json","/languages/fabro.json"]}},"config":{},"pageMetadata":{"title":"Create automation run","description":"Creates a new run by firing the automation's enabled API trigger.","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml post /api/v1/automations/{id}/runs","href":"/api-reference/automations/create-automation-run","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/qltysoftware-21b56213/3bd11446cf383877/dot-highlight.js"],"openApiReferenceData":{"operation":{"operationId":"createAutomationRun","tags":["Automations"],"summary":"Create automation run","description":"Creates a new run by firing the automation's enabled API trigger.","parameters":["8b6acda0-fb4a-41e7-a99b-813c430ea541"],"responses":{"201":"c8e3fa49-9e71-4f72-938c-de2bb7cd6835","404":"643b772f-258e-4cb7-9bc1-08c5300630b3","409":"1f147bd6-478f-4e6f-909e-11a575317f4f","422":"4e8650d7-1725-4cac-b59a-c19fa7331165"},"method":"post","type":"path","servers":[],"security":["997801b2-a1e9-4630-a2b4-0eb4963e2da0","d0ce1aed-392f-4fe8-895d-aa4b8deffc3b"],"path":"/api/v1/automations/{id}/runs","baseUrlOptions":[],"title":"Create automation run","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"8b6acda0-fb4a-41e7-a99b-813c430ea541":{"name":"id","in":"path","required":true,"description":"Unique automation identifier.","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,62}$","isRequired":true,"description":"Unique automation identifier.","uniqueKey":"","typeLabel":"string"},"example":"nightly-deps"}},"responses":{"c8e3fa49-9e71-4f72-938c-de2bb7cd6835":{"description":"Run created","content":{"application/json":{"schema":{"description":"Canonical public run shape.","type":"object","required":["id","title","goal","workflow","automation","repository","created_by","origin","labels","lifecycle","sandbox","models","source_directory","timestamps","timing","usage","size","ask_fabro","diff","pull_request","current_question","superseded_by","retried_from","links","children_count"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"children_count":{"type":"integer","format":"uint64","minimum":0,"description":"Number of runs currently linked to this run as their orchestration parent.","isRequired":true,"uniqueKey":"children_count","typeLabel":"integer\u003cuint64>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"goal":{"type":"string","isRequired":true,"uniqueKey":"goal","typeLabel":"string"},"workflow":{"type":"object","required":["slug","name","graph_name","node_count","edge_count"],"properties":{"slug":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"workflow.slug.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"workflow.slug.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"workflow.slug","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"workflow.name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"workflow.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"workflow.name","typeLabel":"string | null"},"graph_name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"workflow.graph_name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"workflow.graph_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"workflow.graph_name","typeLabel":"string | null"},"node_count":{"type":"integer","format":"int64","description":"Number of nodes in the workflow graph.","isRequired":true,"uniqueKey":"workflow.node_count","typeLabel":"integer\u003cint64>"},"edge_count":{"type":"integer","format":"int64","description":"Number of edges in the workflow graph.","isRequired":true,"uniqueKey":"workflow.edge_count","typeLabel":"integer\u003cint64>"}},"isRequired":true,"uniqueKey":"workflow","typeLabel":"object"},"automation":{"oneOf":[{"type":"object","required":["id","name"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"automation.oneOf.0.id","typeLabel":"string"},"name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"automation.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"automation.oneOf.0.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"automation.oneOf.0.name","typeLabel":"string | null"},"trigger_id":{"oneOf":[{"type":"string","uniqueKey":"automation.oneOf.0.trigger_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"automation.oneOf.0.trigger_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"automation.oneOf.0.trigger_id","typeLabel":"string | null"},"workflow_source":{"oneOf":[{"type":"object","description":"Resolved workflow source for automation runs that declare one.","required":["repo","branch","resolved_sha"],"properties":{"repo":{"type":"string","description":"GitHub repository slug in `owner/name` form.","isRequired":true,"uniqueKey":"automation.oneOf.0.workflow_source.oneOf.0.repo","typeLabel":"string"},"branch":{"type":"string","description":"Required branch fallback and audit context.","isRequired":true,"uniqueKey":"automation.oneOf.0.workflow_source.oneOf.0.branch","typeLabel":"string"},"resolved_sha":{"type":"string","pattern":"^[0-9a-f]{40}$","description":"Exact lowercase Git commit that supplied the workflow bytes.","isRequired":true,"uniqueKey":"automation.oneOf.0.workflow_source.oneOf.0.resolved_sha","typeLabel":"string"},"tag":{"type":"string","description":"Optional tag requested by the automation.","uniqueKey":"automation.oneOf.0.workflow_source.oneOf.0.tag","typeLabel":"string"},"sha":{"type":"string","pattern":"^[0-9a-f]{40}$","description":"Optional exact commit requested by the automation.","uniqueKey":"automation.oneOf.0.workflow_source.oneOf.0.sha","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"automation.oneOf.0.workflow_source.oneOf.0","typeLabel":"object"},{"type":"null","description":"Resolved workflow source for automation runs that declare one.","uniqueKey":"automation.oneOf.0.workflow_source.oneOf.1","typeLabel":"null"}],"uniqueKey":"automation.oneOf.0.workflow_source","typeLabel":"object | null"}},"isRequired":true,"uniqueKey":"automation.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"automation.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"automation","typeLabel":"object | null"},"repository":{"oneOf":[{"type":"object","description":"Durable repository metadata for a run.","required":["name","origin_url","provider"],"properties":{"name":{"type":"string","example":"fabro-sh/fabro","isRequired":true,"uniqueKey":"repository.oneOf.0.name","typeLabel":"string"},"origin_url":{"oneOf":[{"type":"string","example":"https://github.com/fabro-sh/fabro.git","isRequired":true,"uniqueKey":"repository.oneOf.0.origin_url.oneOf.0","typeLabel":"string"},{"type":"null","example":"https://github.com/fabro-sh/fabro.git","isRequired":true,"uniqueKey":"repository.oneOf.0.origin_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"repository.oneOf.0.origin_url","typeLabel":"string | null"},"provider":{"type":"string","enum":["github","git","unknown"],"isRequired":true,"uniqueKey":"repository.oneOf.0.provider","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"repository.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"repository.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"repository","typeLabel":"object | null"},"created_by":{"oneOf":[{"type":"object","required":["kind","identity","login","auth_method"],"properties":{"kind":{"type":"string","enum":["user"],"isRequired":true,"uniqueKey":"created_by.oneOf.0.kind","typeLabel":"enum\u003cstring>"},"identity":{"type":"object","required":["issuer","subject"],"properties":{"issuer":{"type":"string","isRequired":true,"uniqueKey":"created_by.oneOf.0.identity.issuer","typeLabel":"string"},"subject":{"type":"string","isRequired":true,"uniqueKey":"created_by.oneOf.0.identity.subject","typeLabel":"string"}},"isRequired":true,"uniqueKey":"created_by.oneOf.0.identity","typeLabel":"object"},"login":{"type":"string","isRequired":true,"uniqueKey":"created_by.oneOf.0.login","typeLabel":"string"},"auth_method":{"description":"Runtime user authentication method.","type":"string","enum":["github","dev_token"],"isRequired":true,"uniqueKey":"created_by.oneOf.0.auth_method","typeLabel":"enum\u003cstring>"},"avatar_url":{"oneOf":[{"type":"string","uniqueKey":"created_by.oneOf.0.avatar_url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"created_by.oneOf.0.avatar_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"created_by.oneOf.0.avatar_url","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"created_by.oneOf.0","typeLabel":"object"},{"type":"object","required":["kind","run_id"],"properties":{"kind":{"type":"string","enum":["worker"],"isRequired":true,"uniqueKey":"created_by.oneOf.1.kind","typeLabel":"enum\u003cstring>"},"run_id":{"type":"string","isRequired":true,"uniqueKey":"created_by.oneOf.1.run_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"created_by.oneOf.1","typeLabel":"object"},{"type":"object","required":["kind","delivery_id"],"properties":{"kind":{"type":"string","enum":["webhook"],"isRequired":true,"uniqueKey":"created_by.oneOf.2.kind","typeLabel":"enum\u003cstring>"},"delivery_id":{"type":"string","isRequired":true,"uniqueKey":"created_by.oneOf.2.delivery_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"created_by.oneOf.2","typeLabel":"object"},{"type":"object","required":["kind","team_id","user_id"],"properties":{"kind":{"type":"string","enum":["slack"],"isRequired":true,"uniqueKey":"created_by.oneOf.3.kind","typeLabel":"enum\u003cstring>"},"team_id":{"type":"string","isRequired":true,"uniqueKey":"created_by.oneOf.3.team_id","typeLabel":"string"},"user_id":{"type":"string","isRequired":true,"uniqueKey":"created_by.oneOf.3.user_id","typeLabel":"string"},"user_name":{"oneOf":[{"type":"string","uniqueKey":"created_by.oneOf.3.user_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"created_by.oneOf.3.user_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"created_by.oneOf.3.user_name","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"created_by.oneOf.3","typeLabel":"object"},{"type":"object","required":["kind"],"properties":{"kind":{"type":"string","enum":["agent"],"isRequired":true,"uniqueKey":"created_by.oneOf.4.kind","typeLabel":"enum\u003cstring>"},"session_id":{"oneOf":[{"type":"string","uniqueKey":"created_by.oneOf.4.session_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"created_by.oneOf.4.session_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"created_by.oneOf.4.session_id","typeLabel":"string | null"},"parent_session_id":{"oneOf":[{"type":"string","uniqueKey":"created_by.oneOf.4.parent_session_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"created_by.oneOf.4.parent_session_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"created_by.oneOf.4.parent_session_id","typeLabel":"string | null"},"model":{"oneOf":[{"type":"string","uniqueKey":"created_by.oneOf.4.model.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"created_by.oneOf.4.model.oneOf.1","typeLabel":"null"}],"uniqueKey":"created_by.oneOf.4.model","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"created_by.oneOf.4","typeLabel":"object"},{"type":"object","required":["kind","system_kind"],"properties":{"kind":{"type":"string","enum":["system"],"isRequired":true,"uniqueKey":"created_by.oneOf.5.kind","typeLabel":"enum\u003cstring>"},"system_kind":{"type":"string","enum":["engine","watchdog","timeout"],"isRequired":true,"uniqueKey":"created_by.oneOf.5.system_kind","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"created_by.oneOf.5","typeLabel":"object"}],"isRequired":true,"uniqueKey":"created_by","typeLabel":"object"},"origin":{"type":"object","required":["kind"],"properties":{"kind":{"type":"string","enum":["api"],"isRequired":true,"uniqueKey":"origin.kind","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"origin","typeLabel":"object"},"labels":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"labels.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"labels","typeLabel":"object"},"lifecycle":{"type":"object","required":["status","approval","pending_control","queue_position","error","archived","archived_at"],"properties":{"status":{"oneOf":[{"type":"object","description":"Execution status of a run. Archive state is represented separately on `RunLifecycle.archived` so terminal status payloads remain intact.\n","required":["kind"],"properties":{"kind":{"type":"string","enum":["submitted"],"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.0.kind","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.0","typeLabel":"object"},{"type":"object","description":"Execution status of a run. Archive state is represented separately on `RunLifecycle.archived` so terminal status payloads remain intact.\n","required":["kind","reason"],"properties":{"kind":{"type":"string","enum":["pending"],"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.1.kind","typeLabel":"enum\u003cstring>"},"reason":{"description":"Reason a pre-execution run is pending instead of runnable.","type":"string","enum":["approval_required"],"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.1.reason","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.1","typeLabel":"object"},{"type":"object","description":"Execution status of a run. Archive state is represented separately on `RunLifecycle.archived` so terminal status payloads remain intact.\n","required":["kind"],"properties":{"kind":{"type":"string","enum":["runnable"],"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.2.kind","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.2","typeLabel":"object"},{"type":"object","description":"Execution status of a run. Archive state is represented separately on `RunLifecycle.archived` so terminal status payloads remain intact.\n","required":["kind"],"properties":{"kind":{"type":"string","enum":["starting"],"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.3.kind","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.3","typeLabel":"object"},{"type":"object","description":"Execution status of a run. Archive state is represented separately on `RunLifecycle.archived` so terminal status payloads remain intact.\n","required":["kind"],"properties":{"kind":{"type":"string","enum":["running"],"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.4.kind","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.4","typeLabel":"object"},{"type":"object","description":"Execution status of a run. Archive state is represented separately on `RunLifecycle.archived` so terminal status payloads remain intact.\n","required":["kind","blocked_reason"],"properties":{"kind":{"type":"string","enum":["blocked"],"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.5.kind","typeLabel":"enum\u003cstring>"},"blocked_reason":{"description":"Specific reason a run is blocked on external intervention.","type":"string","enum":["human_input_required"],"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.5.blocked_reason","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.5","typeLabel":"object"},{"type":"object","description":"Execution status of a run. Archive state is represented separately on `RunLifecycle.archived` so terminal status payloads remain intact.\n","required":["kind","prior_block"],"properties":{"kind":{"type":"string","enum":["paused"],"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.6.kind","typeLabel":"enum\u003cstring>"},"prior_block":{"oneOf":[{"type":"string","description":"Specific reason a run is blocked on external intervention.","enum":["human_input_required"],"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.6.prior_block.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"lifecycle.status.oneOf.6.prior_block.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.6.prior_block","typeLabel":"enum\u003cstring> | null"}},"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.6","typeLabel":"object"},{"type":"object","description":"Execution status of a run. Archive state is represented separately on `RunLifecycle.archived` so terminal status payloads remain intact.\n","required":["kind"],"properties":{"kind":{"type":"string","enum":["removing"],"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.7.kind","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.7","typeLabel":"object"},{"type":"object","description":"Execution status of a run. Archive state is represented separately on `RunLifecycle.archived` so terminal status payloads remain intact.\n","required":["kind","reason"],"properties":{"kind":{"type":"string","enum":["succeeded"],"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.8.kind","typeLabel":"enum\u003cstring>"},"reason":{"description":"Reason attached to a successful terminal run status.","type":"string","enum":["completed","partial_success"],"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.8.reason","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.8","typeLabel":"object"},{"type":"object","description":"Execution status of a run. Archive state is represented separately on `RunLifecycle.archived` so terminal status payloads remain intact.\n","required":["kind","reason"],"properties":{"kind":{"type":"string","enum":["failed"],"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.9.kind","typeLabel":"enum\u003cstring>"},"reason":{"description":"Reason attached to a failed terminal run status.","type":"string","enum":["workflow_error","publish_failed","cancelled","approval_denied","terminated","transient_infra","budget_exhausted","launch_failed","bootstrap_failed","sandbox_init_failed"],"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.9.reason","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.9","typeLabel":"object"},{"type":"object","description":"Execution status of a run. Archive state is represented separately on `RunLifecycle.archived` so terminal status payloads remain intact.\n","required":["kind"],"properties":{"kind":{"type":"string","enum":["dead"],"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.10.kind","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"lifecycle.status.oneOf.10","typeLabel":"object"}],"isRequired":true,"uniqueKey":"lifecycle.status","typeLabel":"object"},"approval":{"oneOf":[{"type":"object","description":"Pre-execution approval state for runs that require one-time human approval.","required":["state","requested_at","decided_at","denial_reason"],"properties":{"state":{"description":"State of a run's pre-execution approval request.","type":"string","enum":["pending","approved","denied"],"isRequired":true,"uniqueKey":"lifecycle.approval.oneOf.0.state","typeLabel":"enum\u003cstring>"},"requested_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"lifecycle.approval.oneOf.0.requested_at","typeLabel":"string\u003cdate-time>"},"decided_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"lifecycle.approval.oneOf.0.decided_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"lifecycle.approval.oneOf.0.decided_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"lifecycle.approval.oneOf.0.decided_at","typeLabel":"string\u003cdate-time> | null"},"denial_reason":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"lifecycle.approval.oneOf.0.denial_reason.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"lifecycle.approval.oneOf.0.denial_reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"lifecycle.approval.oneOf.0.denial_reason","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"lifecycle.approval.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"lifecycle.approval.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"lifecycle.approval","typeLabel":"object | null"},"pending_control":{"oneOf":[{"type":"string","description":"Run control action requested by the API.","enum":["cancel","pause","unpause"],"isRequired":true,"uniqueKey":"lifecycle.pending_control.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"lifecycle.pending_control.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"lifecycle.pending_control","typeLabel":"enum\u003cstring> | null"},"queue_position":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"lifecycle.queue_position.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"lifecycle.queue_position.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"lifecycle.queue_position","typeLabel":"integer | null"},"error":{"oneOf":[{"type":"object","description":"Error information for a failed run.","required":["message"],"properties":{"message":{"type":"string","description":"Error message.","example":"Stage 'apply-changes' exceeded maximum retries.","isRequired":true,"uniqueKey":"lifecycle.error.oneOf.0.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"lifecycle.error.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"lifecycle.error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"lifecycle.error","typeLabel":"object | null"},"archived":{"type":"boolean","isRequired":true,"uniqueKey":"lifecycle.archived","typeLabel":"boolean"},"archived_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"lifecycle.archived_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"lifecycle.archived_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"lifecycle.archived_at","typeLabel":"string\u003cdate-time> | null"}},"isRequired":true,"uniqueKey":"lifecycle","typeLabel":"object"},"sandbox":{"oneOf":[{"type":"object","description":"Sandbox lifecycle record for a run. A run can have a requested sandbox plan before it has an initialized sandbox instance.","required":["kind","plan"],"properties":{"kind":{"description":"Lifecycle state for a run sandbox request.","type":"string","enum":["planned","initializing","ready","failed"],"isRequired":true,"uniqueKey":"sandbox.oneOf.0.kind","typeLabel":"enum\u003cstring>"},"plan":{"description":"Requested sandbox provider and base image/snapshot from run settings.","type":"object","required":["provider"],"properties":{"provider":{"description":"Sandbox provider kind. `local`, `docker`, and `daytona` are bundled\nwith the server; any other value names a sandbox-driver plugin\nconfigured under `server.sandbox.providers.\u003ckind>`.\n","type":"string","pattern":"^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$","example":"docker","isRequired":true,"uniqueKey":"sandbox.oneOf.0.plan.provider","typeLabel":"string"},"image":{"oneOf":[{"type":"string","uniqueKey":"sandbox.oneOf.0.plan.image.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"sandbox.oneOf.0.plan.image.oneOf.1","typeLabel":"null"}],"uniqueKey":"sandbox.oneOf.0.plan.image","typeLabel":"string | null"},"snapshot":{"oneOf":[{"type":"string","uniqueKey":"sandbox.oneOf.0.plan.snapshot.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"sandbox.oneOf.0.plan.snapshot.oneOf.1","typeLabel":"null"}],"uniqueKey":"sandbox.oneOf.0.plan.snapshot","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"sandbox.oneOf.0.plan","typeLabel":"object"},"instance":{"oneOf":[{"type":"object","description":"Present only when `kind` is `ready`.","required":["provider","runtime"],"properties":{"provider":{"description":"Sandbox provider kind. `local`, `docker`, and `daytona` are bundled\nwith the server; any other value names a sandbox-driver plugin\nconfigured under `server.sandbox.providers.\u003ckind>`.\n","type":"string","pattern":"^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$","example":"docker","isRequired":true,"uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.provider","typeLabel":"string"},"runtime":{"type":"object","required":["id","working_directory","repo_cloned","clone_origin_url","clone_branch"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime.id","typeLabel":"string"},"working_directory":{"type":"string","isRequired":true,"uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime.working_directory","typeLabel":"string"},"repo_cloned":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime.repo_cloned.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime.repo_cloned.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime.repo_cloned","typeLabel":"boolean | null"},"clone_origin_url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime.clone_origin_url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime.clone_origin_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime.clone_origin_url","typeLabel":"string | null"},"clone_branch":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime.clone_branch.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime.clone_branch.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime.clone_branch","typeLabel":"string | null"},"workspace_root":{"oneOf":[{"type":"string","uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime.workspace_root.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime.workspace_root.oneOf.1","typeLabel":"null"}],"uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime.workspace_root","typeLabel":"string | null"},"repos_root":{"oneOf":[{"type":"string","uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime.repos_root.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime.repos_root.oneOf.1","typeLabel":"null"}],"uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime.repos_root","typeLabel":"string | null"},"primary_repo_path":{"oneOf":[{"type":"string","uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime.primary_repo_path.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime.primary_repo_path.oneOf.1","typeLabel":"null"}],"uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime.primary_repo_path","typeLabel":"string | null"},"primary_repo_link":{"oneOf":[{"type":"string","uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime.primary_repo_link.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime.primary_repo_link.oneOf.1","typeLabel":"null"}],"uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime.primary_repo_link","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.runtime","typeLabel":"object"},"image":{"oneOf":[{"type":"string","uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.image.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.image.oneOf.1","typeLabel":"null"}],"uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.image","typeLabel":"string | null"},"snapshot":{"oneOf":[{"type":"string","uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.snapshot.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.snapshot.oneOf.1","typeLabel":"null"}],"uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.snapshot","typeLabel":"string | null"},"ready_duration_ms":{"oneOf":[{"type":"integer","format":"uint64","minimum":0,"description":"How long the sandbox took to become ready, when recorded.","uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.ready_duration_ms.oneOf.0","typeLabel":"integer\u003cuint64>"},{"type":"null","format":"uint64","minimum":0,"description":"How long the sandbox took to become ready, when recorded.","uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.ready_duration_ms.oneOf.1","typeLabel":"null"}],"uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.ready_duration_ms","typeLabel":"integer\u003cuint64> | null"},"retained":{"oneOf":[{"type":"boolean","description":"Whether the sandbox still exists after the run released it\n(kept, stopped or running) or was removed. Absent until the\nrelease.\n","uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.retained.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the sandbox still exists after the run released it\n(kept, stopped or running) or was removed. Absent until the\nrelease.\n","uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.retained.oneOf.1","typeLabel":"null"}],"uniqueKey":"sandbox.oneOf.0.instance.oneOf.0.retained","typeLabel":"boolean | null"}},"uniqueKey":"sandbox.oneOf.0.instance.oneOf.0","typeLabel":"object"},{"type":"null","description":"Present only when `kind` is `ready`.","uniqueKey":"sandbox.oneOf.0.instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"sandbox.oneOf.0.instance","typeLabel":"object | null"},"failure":{"oneOf":[{"type":"object","description":"Present only when `kind` is `failed`.","required":["provider","error","causes","duration_ms"],"properties":{"provider":{"type":"string","description":"Provider reported by the sandbox initialization event.","isRequired":true,"uniqueKey":"sandbox.oneOf.0.failure.oneOf.0.provider","typeLabel":"string"},"error":{"type":"string","isRequired":true,"uniqueKey":"sandbox.oneOf.0.failure.oneOf.0.error","typeLabel":"string"},"causes":{"type":"array","items":{"type":"string","uniqueKey":"sandbox.oneOf.0.failure.oneOf.0.causes.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"sandbox.oneOf.0.failure.oneOf.0.causes","typeLabel":"string[]"},"duration_ms":{"type":"integer","format":"uint64","minimum":0,"isRequired":true,"uniqueKey":"sandbox.oneOf.0.failure.oneOf.0.duration_ms","typeLabel":"integer\u003cuint64>"}},"uniqueKey":"sandbox.oneOf.0.failure.oneOf.0","typeLabel":"object"},{"type":"null","description":"Present only when `kind` is `failed`.","uniqueKey":"sandbox.oneOf.0.failure.oneOf.1","typeLabel":"null"}],"uniqueKey":"sandbox.oneOf.0.failure","typeLabel":"object | null"}},"isRequired":true,"uniqueKey":"sandbox.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"sandbox.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sandbox","typeLabel":"object | null"},"models":{"type":"array","items":{"type":"object","required":["provider","name"],"properties":{"provider":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"models.items.[INDEX].provider.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"models.items.[INDEX].provider.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"models.items.[INDEX].provider","typeLabel":"string | null"},"name":{"type":"string","isRequired":true,"uniqueKey":"models.items.[INDEX].name","typeLabel":"string"}},"uniqueKey":"models.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"models","typeLabel":"object[]"},"source_directory":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"source_directory.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"source_directory.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"source_directory","typeLabel":"string | null"},"timestamps":{"type":"object","required":["created_at","started_at","last_event_at","completed_at"],"properties":{"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"timestamps.created_at","typeLabel":"string\u003cdate-time>"},"started_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"timestamps.started_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"timestamps.started_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"timestamps.started_at","typeLabel":"string\u003cdate-time> | null"},"last_event_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"timestamps.last_event_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"timestamps.last_event_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"timestamps.last_event_at","typeLabel":"string\u003cdate-time> | null"},"completed_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"timestamps.completed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"timestamps.completed_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"timestamps.completed_at","typeLabel":"string\u003cdate-time> | null"}},"isRequired":true,"uniqueKey":"timestamps","typeLabel":"object"},"timing":{"oneOf":[{"type":"object","description":"Run-level timing rollup. Wall time is the run's clock duration;\nactive timing sums work across stage visits.\n","required":["wall_time_ms","inference_time_ms","tool_time_ms","active_time_ms"],"properties":{"wall_time_ms":{"type":"integer","format":"uint64","minimum":0,"example":420000,"isRequired":true,"uniqueKey":"timing.oneOf.0.wall_time_ms","typeLabel":"integer\u003cuint64>"},"inference_time_ms":{"type":"integer","format":"uint64","minimum":0,"default":0,"example":120000,"isRequired":true,"uniqueKey":"timing.oneOf.0.inference_time_ms","typeLabel":"integer\u003cuint64>"},"tool_time_ms":{"type":"integer","format":"uint64","minimum":0,"default":0,"example":60000,"isRequired":true,"uniqueKey":"timing.oneOf.0.tool_time_ms","typeLabel":"integer\u003cuint64>"},"active_time_ms":{"type":"integer","format":"uint64","minimum":0,"description":"Equals `inference_time_ms + tool_time_ms`.","example":180000,"isRequired":true,"uniqueKey":"timing.oneOf.0.active_time_ms","typeLabel":"integer\u003cuint64>"}},"isRequired":true,"uniqueKey":"timing.oneOf.0","typeLabel":"object"},{"type":"null","description":"Run-level timing rollup. Wall time is the run's clock duration;\nactive timing sums work across stage visits.\n","isRequired":true,"uniqueKey":"timing.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"timing","typeLabel":"object | null"},"usage":{"description":"The run's usage summed across every stage visit so far: the conclusion's total once the run ended, else the sum of the stages'.","type":"object","required":["tokens"],"properties":{"tokens":{"description":"lithos `TokenCounts`: five disjoint token buckets. Every token is counted in exactly one, so their plain sum is the total. `input` excludes cache reads and writes, while `output` excludes reasoning tokens when the provider reports them separately. A bucket that is absent reads as zero.\n","type":"object","properties":{"input":{"type":"integer","format":"uint64","minimum":0,"default":0,"description":"Prompt tokens that were neither read from nor written to a cache.","uniqueKey":"usage.tokens.input","typeLabel":"integer\u003cuint64>"},"output":{"type":"integer","format":"uint64","minimum":0,"default":0,"description":"Completion tokens that are not reasoning tokens.","uniqueKey":"usage.tokens.output","typeLabel":"integer\u003cuint64>"},"reasoning":{"type":"integer","format":"uint64","minimum":0,"default":0,"description":"Completion tokens spent on reasoning, priced at the output rate.","uniqueKey":"usage.tokens.reasoning","typeLabel":"integer\u003cuint64>"},"cache_read":{"type":"integer","format":"uint64","minimum":0,"default":0,"description":"Prompt tokens served from a provider cache.","uniqueKey":"usage.tokens.cache_read","typeLabel":"integer\u003cuint64>"},"cache_write":{"type":"integer","format":"uint64","minimum":0,"default":0,"description":"Prompt tokens written into a provider cache.","uniqueKey":"usage.tokens.cache_write","typeLabel":"integer\u003cuint64>"}},"isRequired":true,"uniqueKey":"usage.tokens","typeLabel":"object"},"cost":{"description":"lithos `Cost`: a USD amount in micros and where it came from.","type":"object","required":["usd_micros","source"],"properties":{"usd_micros":{"type":"integer","format":"uint64","minimum":0,"isRequired":true,"uniqueKey":"usage.cost.usd_micros","typeLabel":"integer\u003cuint64>"},"source":{"type":"string","description":"Where a cost came from: `catalog` (estimated from catalog prices), `provider` (the provider's own reported cost), or `application` (a sum the caller assembled from differently sourced parts).\n","enum":["catalog","provider","application"],"isRequired":true,"uniqueKey":"usage.cost.source","typeLabel":"enum\u003cstring>"}},"uniqueKey":"usage.cost","typeLabel":"object"}},"isRequired":true,"uniqueKey":"usage","typeLabel":"object"},"size":{"type":"string","enum":["XS","S","M","L","XL"],"description":"Run size bucket derived from the run's current cost.","isRequired":true,"uniqueKey":"size","typeLabel":"enum\u003cstring>"},"ask_fabro":{"description":"Readiness and defaults for starting an Ask Fabro session on this run.","type":"object","required":["available","unavailable_reason","default_model"],"properties":{"available":{"type":"boolean","isRequired":true,"uniqueKey":"ask_fabro.available","typeLabel":"boolean"},"unavailable_reason":{"oneOf":[{"type":"string","enum":["no_sandbox","sandbox_not_ready","llm_unconfigured",null],"isRequired":true,"uniqueKey":"ask_fabro.unavailable_reason.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["no_sandbox","sandbox_not_ready","llm_unconfigured",null],"isRequired":true,"uniqueKey":"ask_fabro.unavailable_reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"ask_fabro.unavailable_reason","typeLabel":"enum\u003cstring> | null"},"default_model":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"ask_fabro.default_model.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"ask_fabro.default_model.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"ask_fabro.default_model","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"ask_fabro","typeLabel":"object"},"diff":{"oneOf":[{"type":"object","description":"Cheap aggregate file and line counts for a run diff.","required":["files_changed","additions","deletions"],"properties":{"files_changed":{"type":"integer","description":"Total number of changed files, including binary files.","example":42,"isRequired":true,"uniqueKey":"diff.oneOf.0.files_changed","typeLabel":"integer"},"additions":{"type":"integer","description":"Total lines added across text files.","example":567,"isRequired":true,"uniqueKey":"diff.oneOf.0.additions","typeLabel":"integer"},"deletions":{"type":"integer","description":"Total lines deleted across text files.","example":234,"isRequired":true,"uniqueKey":"diff.oneOf.0.deletions","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"diff.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"diff.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"diff","typeLabel":"object | null"},"pull_request":{"oneOf":[{"type":"object","description":"Minimal GitHub pull request link associated with a run.","required":["owner","repo","number","html_url"],"properties":{"owner":{"type":"string","example":"fabro-sh","isRequired":true,"uniqueKey":"pull_request.oneOf.0.owner","typeLabel":"string"},"repo":{"type":"string","example":"fabro","isRequired":true,"uniqueKey":"pull_request.oneOf.0.repo","typeLabel":"string"},"number":{"type":"integer","example":123,"isRequired":true,"uniqueKey":"pull_request.oneOf.0.number","typeLabel":"integer"},"html_url":{"type":"string","format":"uri","description":"Computed GitHub web URL for the pull request.","example":"https://github.com/fabro-sh/fabro/pull/123","isRequired":true,"uniqueKey":"pull_request.oneOf.0.html_url","typeLabel":"string\u003curi>"}},"isRequired":true,"uniqueKey":"pull_request.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"pull_request.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"pull_request","typeLabel":"object | null"},"current_question":{"oneOf":[{"type":"object","description":"A pending human-in-the-loop question summary.","required":["text"],"properties":{"text":{"type":"string","description":"Question text.","example":"Accept or push for another round?","isRequired":true,"uniqueKey":"current_question.oneOf.0.text","typeLabel":"string"}},"isRequired":true,"uniqueKey":"current_question.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"current_question.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"current_question","typeLabel":"object | null"},"superseded_by":{"oneOf":[{"type":"string","description":"Run ID that superseded this run via rewind, if any.","isRequired":true,"uniqueKey":"superseded_by.oneOf.0","typeLabel":"string"},{"type":"null","description":"Run ID that superseded this run via rewind, if any.","isRequired":true,"uniqueKey":"superseded_by.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"superseded_by","typeLabel":"string | null"},"retried_from":{"oneOf":[{"type":"string","description":"Source run ID when this run was created by manual retry.","isRequired":true,"uniqueKey":"retried_from.oneOf.0","typeLabel":"string"},{"type":"null","description":"Source run ID when this run was created by manual retry.","isRequired":true,"uniqueKey":"retried_from.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"retried_from","typeLabel":"string | null"},"links":{"type":"object","required":["web"],"properties":{"web":{"oneOf":[{"type":"string","format":"uri","isRequired":true,"uniqueKey":"links.web.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","isRequired":true,"uniqueKey":"links.web.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"links.web","typeLabel":"string\u003curi> | null"}},"isRequired":true,"uniqueKey":"links","typeLabel":"object"},"parent_id":{"oneOf":[{"type":"string","description":"Current orchestration parent run ID, if linked.","uniqueKey":"parent_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Current orchestration parent run ID, if linked.","uniqueKey":"parent_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"parent_id","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","children_count":1,"title":"\u003cstring>","goal":"\u003cstring>","workflow":{"slug":"\u003cstring>","name":"\u003cstring>","graph_name":"\u003cstring>","node_count":123,"edge_count":123},"automation":{"id":"\u003cstring>","name":"\u003cstring>","trigger_id":"\u003cstring>","workflow_source":{"repo":"\u003cstring>","branch":"\u003cstring>","resolved_sha":"\u003cstring>","tag":"\u003cstring>","sha":"\u003cstring>"}},"repository":{"name":"fabro-sh/fabro","origin_url":"https://github.com/fabro-sh/fabro.git","provider":"github"},"created_by":{"kind":"user","identity":{"issuer":"\u003cstring>","subject":"\u003cstring>"},"login":"\u003cstring>","auth_method":"github","avatar_url":"\u003cstring>"},"origin":{"kind":"api"},"labels":{},"lifecycle":{"status":{"kind":"submitted"},"approval":{"state":"pending","requested_at":"2023-11-07T05:31:56Z","decided_at":"2023-11-07T05:31:56Z","denial_reason":"\u003cstring>"},"pending_control":"cancel","queue_position":123,"error":{"message":"Stage 'apply-changes' exceeded maximum retries."},"archived":true,"archived_at":"2023-11-07T05:31:56Z"},"sandbox":{"kind":"planned","plan":{"provider":"docker","image":"\u003cstring>","snapshot":"\u003cstring>"},"instance":{"provider":"docker","runtime":{"id":"\u003cstring>","working_directory":"\u003cstring>","repo_cloned":true,"clone_origin_url":"\u003cstring>","clone_branch":"\u003cstring>","workspace_root":"\u003cstring>","repos_root":"\u003cstring>","primary_repo_path":"\u003cstring>","primary_repo_link":"\u003cstring>"},"image":"\u003cstring>","snapshot":"\u003cstring>","ready_duration_ms":1,"retained":true},"failure":{"provider":"\u003cstring>","error":"\u003cstring>","causes":["\u003cstring>"],"duration_ms":1}},"models":[{"provider":"\u003cstring>","name":"\u003cstring>"}],"source_directory":"\u003cstring>","timestamps":{"created_at":"2023-11-07T05:31:56Z","started_at":"2023-11-07T05:31:56Z","last_event_at":"2023-11-07T05:31:56Z","completed_at":"2023-11-07T05:31:56Z"},"timing":{"wall_time_ms":420000,"inference_time_ms":120000,"tool_time_ms":60000,"active_time_ms":180000},"usage":{"tokens":{"input":0,"output":0,"reasoning":0,"cache_read":0,"cache_write":0},"cost":{"usd_micros":1,"source":"catalog"}},"size":"XS","ask_fabro":{"available":true,"unavailable_reason":"no_sandbox","default_model":"\u003cstring>"},"diff":{"files_changed":42,"additions":567,"deletions":234},"pull_request":{"owner":"fabro-sh","repo":"fabro","number":123,"html_url":"https://github.com/fabro-sh/fabro/pull/123"},"current_question":{"text":"Accept or push for another round?"},"superseded_by":"\u003cstring>","retried_from":"\u003cstring>","links":{"web":"\u003cstring>"},"parent_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"643b772f-258e-4cb7-9bc1-08c5300630b3":{"description":"Automation not found","headers":{"x-request-id":{"description":"Server-generated request identifier emitted on every response and referenced on standard error responses for correlating client errors with server logs.\n","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"description":"Standard error response containing one or more error entries.","type":"object","required":["errors"],"properties":{"errors":{"type":"array","description":"List of error entries.","items":{"description":"A single error entry in an error response.","type":"object","required":["status","title","detail"],"properties":{"status":{"type":"string","description":"HTTP status code as a string.","example":"404","isRequired":true,"uniqueKey":"errors.items.[INDEX].status","typeLabel":"string"},"title":{"type":"string","description":"Short error classification.","example":"Not Found","isRequired":true,"uniqueKey":"errors.items.[INDEX].title","typeLabel":"string"},"detail":{"type":"string","description":"Human-readable error description.","example":"Run not found.","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"code":{"type":"string","description":"Optional machine-readable error code for structured client handling.","example":"access_token_expired","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"request_id":{"type":"string","format":"uuid","description":"Server-generated request identifier; matches the x-request-id response header.","uniqueKey":"errors.items.[INDEX].request_id","typeLabel":"string\u003cuuid>"},"meta":{"type":"object","additionalProperties":true,"description":"Optional structured details specific to the error `code`, for clients that act on them. Each code documents the members it sets.","uniqueKey":"errors.items.[INDEX].meta","typeLabel":"object"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"request_id":{"type":"string","format":"uuid","description":"Server-generated request identifier; matches the x-request-id response header.","uniqueKey":"request_id","typeLabel":"string\u003cuuid>"},"leftover_env_keys":{"type":"array","description":"Optional list of runtime env keys that were written before an install failure. Currently populated by `POST /install/finish` failure responses only.","items":{"type":"string","uniqueKey":"leftover_env_keys.items.[INDEX]","typeLabel":"string"},"uniqueKey":"leftover_env_keys","typeLabel":"string[]"},"removed_env_keys":{"type":"array","description":"Optional list of runtime env keys that were actually removed before an install failure. Currently populated by `POST /install/finish` failure responses only.","items":{"type":"string","uniqueKey":"removed_env_keys.items.[INDEX]","typeLabel":"string"},"uniqueKey":"removed_env_keys","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"status":"404","title":"Not Found","detail":"Run not found.","code":"access_token_expired","request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","meta":{}}],"request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","leftover_env_keys":["\u003cstring>"],"removed_env_keys":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"1f147bd6-478f-4e6f-909e-11a575317f4f":{"description":"Automation has no enabled API trigger","headers":{"x-request-id":{"description":"Server-generated request identifier emitted on every response and referenced on standard error responses for correlating client errors with server logs.\n","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"description":"Standard error response containing one or more error entries.","type":"object","required":["errors"],"properties":{"errors":{"type":"array","description":"List of error entries.","items":{"description":"A single error entry in an error response.","type":"object","required":["status","title","detail"],"properties":{"status":{"type":"string","description":"HTTP status code as a string.","example":"404","isRequired":true,"uniqueKey":"errors.items.[INDEX].status","typeLabel":"string"},"title":{"type":"string","description":"Short error classification.","example":"Not Found","isRequired":true,"uniqueKey":"errors.items.[INDEX].title","typeLabel":"string"},"detail":{"type":"string","description":"Human-readable error description.","example":"Run not found.","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"code":{"type":"string","description":"Optional machine-readable error code for structured client handling.","example":"access_token_expired","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"request_id":{"type":"string","format":"uuid","description":"Server-generated request identifier; matches the x-request-id response header.","uniqueKey":"errors.items.[INDEX].request_id","typeLabel":"string\u003cuuid>"},"meta":{"type":"object","additionalProperties":true,"description":"Optional structured details specific to the error `code`, for clients that act on them. Each code documents the members it sets.","uniqueKey":"errors.items.[INDEX].meta","typeLabel":"object"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"request_id":{"type":"string","format":"uuid","description":"Server-generated request identifier; matches the x-request-id response header.","uniqueKey":"request_id","typeLabel":"string\u003cuuid>"},"leftover_env_keys":{"type":"array","description":"Optional list of runtime env keys that were written before an install failure. Currently populated by `POST /install/finish` failure responses only.","items":{"type":"string","uniqueKey":"leftover_env_keys.items.[INDEX]","typeLabel":"string"},"uniqueKey":"leftover_env_keys","typeLabel":"string[]"},"removed_env_keys":{"type":"array","description":"Optional list of runtime env keys that were actually removed before an install failure. Currently populated by `POST /install/finish` failure responses only.","items":{"type":"string","uniqueKey":"removed_env_keys.items.[INDEX]","typeLabel":"string"},"uniqueKey":"removed_env_keys","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"status":"404","title":"Not Found","detail":"Run not found.","code":"access_token_expired","request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","meta":{}}],"request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","leftover_env_keys":["\u003cstring>"],"removed_env_keys":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"4e8650d7-1725-4cac-b59a-c19fa7331165":{"description":"Automation target could not be materialized into a run","headers":{"x-request-id":{"description":"Server-generated request identifier emitted on every response and referenced on standard error responses for correlating client errors with server logs.\n","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"description":"Standard error response containing one or more error entries.","type":"object","required":["errors"],"properties":{"errors":{"type":"array","description":"List of error entries.","items":{"description":"A single error entry in an error response.","type":"object","required":["status","title","detail"],"properties":{"status":{"type":"string","description":"HTTP status code as a string.","example":"404","isRequired":true,"uniqueKey":"errors.items.[INDEX].status","typeLabel":"string"},"title":{"type":"string","description":"Short error classification.","example":"Not Found","isRequired":true,"uniqueKey":"errors.items.[INDEX].title","typeLabel":"string"},"detail":{"type":"string","description":"Human-readable error description.","example":"Run not found.","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"code":{"type":"string","description":"Optional machine-readable error code for structured client handling.","example":"access_token_expired","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"request_id":{"type":"string","format":"uuid","description":"Server-generated request identifier; matches the x-request-id response header.","uniqueKey":"errors.items.[INDEX].request_id","typeLabel":"string\u003cuuid>"},"meta":{"type":"object","additionalProperties":true,"description":"Optional structured details specific to the error `code`, for clients that act on them. Each code documents the members it sets.","uniqueKey":"errors.items.[INDEX].meta","typeLabel":"object"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"request_id":{"type":"string","format":"uuid","description":"Server-generated request identifier; matches the x-request-id response header.","uniqueKey":"request_id","typeLabel":"string\u003cuuid>"},"leftover_env_keys":{"type":"array","description":"Optional list of runtime env keys that were written before an install failure. Currently populated by `POST /install/finish` failure responses only.","items":{"type":"string","uniqueKey":"leftover_env_keys.items.[INDEX]","typeLabel":"string"},"uniqueKey":"leftover_env_keys","typeLabel":"string[]"},"removed_env_keys":{"type":"array","description":"Optional list of runtime env keys that were actually removed before an install failure. Currently populated by `POST /install/finish` failure responses only.","items":{"type":"string","uniqueKey":"removed_env_keys.items.[INDEX]","typeLabel":"string"},"uniqueKey":"removed_env_keys","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"status":"404","title":"Not Found","detail":"Run not found.","code":"access_token_expired","request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","meta":{}}],"request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","leftover_env_keys":["\u003cstring>"],"removed_env_keys":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"997801b2-a1e9-4630-a2b4-0eb4963e2da0":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"opaque","description":"Raw dev token passed as `Authorization: Bearer fabro_dev_...` when `server.auth.methods` includes `dev-token`.\n","scopes":[],"schemeName":"BearerAuth"}},"d0ce1aed-392f-4fe8-895d-aa4b8deffc3b":{"SessionCookie":{"type":"apiKey","in":"cookie","name":"__fabro_session","description":"Private session cookie issued after a successful web login. The server verifies and decodes the cookie before authenticating the request.\n","scopes":[],"schemeName":"SessionCookie"}}},"servers":{},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"opaque","description":"Raw dev token passed as `Authorization: Bearer fabro_dev_...` when `server.auth.methods` includes `dev-token`.\n","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Raw dev token passed as `Authorization: Bearer fabro_dev_...` when `server.auth.methods` includes `dev-token`.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"},{"schemes":[{"scheme":{"type":"apiKey","in":"cookie","name":"__fabro_session","description":"Private session cookie issued after a successful web login. The server verifies and decodes the cookie before authenticating the request.\n","scopes":[],"schemeName":"SessionCookie"},"schema":{"title":"__fabro_session","type":"string","description":"Private session cookie issued after a successful web login. The server verifies and decodes the cookie before authenticating the request.\n","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"SessionCookie","name":"__fabro_session"}],"title":"SessionCookie"}]},"originalFileLocation":"api-reference/fabro-api.yaml"},"subdomain":"qltysoftware-21b56213","siteName":"Fabro","title":"Create automation run - Fabro","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-23T17:19:29.064Z","originalFileLocation":"api-reference/automations/create-automation-run.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=\"Creates a new run by firing the automation\u0026#x27;s enabled API trigger.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Fabro\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/qltysoftware-21b56213/HxsAqw6_xQvbbHcd/_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/qltysoftware-21b56213/HxsAqw6_xQvbbHcd/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/qltysoftware-21b56213/HxsAqw6_xQvbbHcd/_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/qltysoftware-21b56213/HxsAqw6_xQvbbHcd/_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/qltysoftware-21b56213/HxsAqw6_xQvbbHcd/_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/qltysoftware-21b56213/HxsAqw6_xQvbbHcd/_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/qltysoftware-21b56213/HxsAqw6_xQvbbHcd/_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/qltysoftware-21b56213/HxsAqw6_xQvbbHcd/_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/qltysoftware-21b56213/HxsAqw6_xQvbbHcd/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create automation run - Fabro\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a new run by firing the automation\u0026#x27;s enabled API trigger.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Fabro\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.fabro.sh/api-reference/automations/create-automation-run\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://qltysoftware-21b56213.mintlify.app/_mintlify/api/og/v2?division=Automations\u0026amp;title=Create+automation+run\u0026amp;description=Creates+a+new+run+by+firing+the+automation%27s+enabled+API+trigger.\u0026amp;theme=28e7ed71f21f688d6b038590\u0026amp;signature=07576fbf2815ee0d32a08659adf2d6436eaa471073831adf6881a2e7904476d1\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create automation run - Fabro\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a new run by firing the automation\u0026#x27;s enabled API trigger.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://qltysoftware-21b56213.mintlify.app/_mintlify/api/og/v2?division=Automations\u0026amp;title=Create+automation+run\u0026amp;description=Creates+a+new+run+by+firing+the+automation%27s+enabled+API+trigger.\u0026amp;theme=28e7ed71f21f688d6b038590\u0026amp;signature=07576fbf2815ee0d32a08659adf2d6436eaa471073831adf6881a2e7904476d1\">\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/qltysoftware-21b56213/HxsAqw6_xQvbbHcd/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Fabro\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#357F9E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.fabro.sh/api-reference/automations/create-automation-run\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/automations/create-automation-run.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.fabro.sh/#organization\",\"name\":\"Fabro\",\"url\":\"https://docs.fabro.sh\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/qltysoftware-21b56213/-urDLCwpQ5cwP5xH/logo/light.svg?fit=max\u0026auto=format\u0026n=-urDLCwpQ5cwP5xH\u0026q=85\u0026s=6956186f08cfc81047825dc8804d608d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.fabro.sh#website\",\"name\":\"Fabro\",\"url\":\"https://docs.fabro.sh\",\"publisher\":{\"@id\":\"https://docs.fabro.sh/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.fabro.sh/api-reference/automations/create-automation-run#webpage\",\"url\":\"https://docs.fabro.sh/api-reference/automations/create-automation-run\",\"name\":\"Create automation run\",\"description\":\"Creates a new run by firing the automation's enabled API trigger.\",\"dateModified\":\"2026-10-23T17:19:29.064Z\",\"isPartOf\":{\"@id\":\"https://docs.fabro.sh#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fabro.sh/api-reference/automations/create-automation-run#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fabro.sh/api-reference/automations/create-automation-run#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Automations\",\"item\":\"https://docs.fabro.sh/api-reference/automations/list-automations\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create automation run\",\"item\":\"https://docs.fabro.sh/api-reference/automations/create-automation-run\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.fabro.sh/api-reference/automations/create-automation-run#apireference\",\"headline\":\"Create automation run\",\"name\":\"Create automation run\",\"description\":\"Creates a new run by firing the automation's enabled API trigger.\",\"url\":\"https://docs.fabro.sh/api-reference/automations/create-automation-run\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fabro.sh/api-reference/automations/create-automation-run#webpage\"},\"dateModified\":\"2026-10-23T17:19:29.064Z\",\"publisher\":{\"@id\":\"https://docs.fabro.sh/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.fabro.sh#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Fabro\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Fabro","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book","pages":[{"title":"Documentation","href":"/getting-started/introduction"}]},{"tab":"Guides","icon":"graduation-cap","pages":[{"title":"Guides","href":"/tutorials/hello-world"}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Using the API","icon":"code","pages":[{"title":"API Overview","href":"/api-reference/overview"},{"title":"Client SDKs","href":"/api-reference/client-sdks"}]},{"group":"Workflow Versions","icon":"code-branch","pages":[{"title":"Create Workflow Version","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml post /api/v1/workflow-versions","href":"/api-reference/workflow-versions/create-workflow-version"}]},{"group":"Runs","icon":"play","pages":[{"title":"List Runs","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml get /api/v1/runs","href":"/api-reference/runs/list-runs"},{"title":"Create Run","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml post /api/v1/runs","href":"/api-reference/runs/create-run"},{"title":"Retrieve Run","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml get /api/v1/runs/{id}","href":"/api-reference/runs/retrieve-run"},{"title":"Link Run Parent","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml put /api/v1/runs/{id}/parent","href":"/api-reference/runs/link-run-parent"},{"title":"Unlink Run Parent","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml delete /api/v1/runs/{id}/parent","href":"/api-reference/runs/unlink-run-parent"},{"title":"Start Run","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml post /api/v1/runs/{id}/start","href":"/api-reference/runs/start-run"},{"title":"Approve Run","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml post /api/v1/runs/{id}/approve","href":"/api-reference/runs/approve-run"},{"title":"Deny Run","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml post /api/v1/runs/{id}/deny","href":"/api-reference/runs/deny-run"},{"title":"Cancel Run","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml post /api/v1/runs/{id}/cancel","href":"/api-reference/runs/cancel-run"},{"title":"Pause Run","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml post /api/v1/runs/{id}/pause","href":"/api-reference/runs/pause-run"},{"title":"Unpause Run","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml post /api/v1/runs/{id}/unpause","href":"/api-reference/runs/unpause-run"},{"title":"Create Run Pull Request","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml post /api/v1/runs/{id}/pull_request","href":"/api-reference/runs/create-run-pull-request"},{"title":"Get Run Pull Request Creation","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml get /api/v1/runs/{id}/pull_request/creation","href":"/api-reference/runs/get-run-pull-request-creation"},{"title":"Render SVG","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml get /api/v1/runs/{id}/graph","href":"/api-reference/runs/render-svg"},{"title":"List Run Events","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml get /api/v1/runs/{id}/events","href":"/api-reference/run-internals/list-run-events"}]},{"group":"Human-in-the-Loop","icon":"hand","pages":[{"title":"List Run Questions","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml get /api/v1/runs/{id}/questions","href":"/api-reference/human-in-the-loop/list-run-questions"},{"title":"Submit Run Answer","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml post /api/v1/runs/{id}/questions/{qid}/answer","href":"/api-reference/human-in-the-loop/submit-run-answer"},{"title":"Preview URL","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml post /api/v1/runs/{id}/preview","href":"/api-reference/human-in-the-loop/preview-url"}]},{"group":"Run Outputs","icon":"file-export","pages":[{"title":"List Run Artifacts","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml get /api/v1/runs/{id}/artifacts","href":"/api-reference/run-internals/list-run-artifacts"},{"title":"Download Run Artifacts","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml get /api/v1/runs/{id}/artifacts/download","href":"/api-reference/run-internals/download-run-artifacts"},{"title":"Retrieve Run Usage","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml get /api/v1/runs/{id}/usage","href":"/api-reference/run-outputs/retrieve-run-usage"},{"group":"Run Internals","icon":"microchip","pages":[{"title":"List Run Stages","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml get /api/v1/runs/{id}/stages","href":"/api-reference/run-internals/list-run-stages"},{"title":"Retrieve Run Settings","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml get /api/v1/runs/{id}/settings","href":"/api-reference/run-internals/retrieve-run-settings"}]}]},{"group":"Automations","icon":"robot","pages":[{"title":"List automations","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml get /api/v1/automations","href":"/api-reference/automations/list-automations"},{"title":"Create automation","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml post /api/v1/automations","href":"/api-reference/automations/create-automation"},{"title":"Retrieve automation","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml get /api/v1/automations/{id}","href":"/api-reference/automations/retrieve-automation"},{"title":"Replace automation","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml put /api/v1/automations/{id}","href":"/api-reference/automations/replace-automation"},{"title":"Delete automation","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml delete /api/v1/automations/{id}","href":"/api-reference/automations/delete-automation"},{"title":"List automation runs","description":"Returns durable runs created by one automation.","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml get /api/v1/automations/{id}/runs","href":"/api-reference/automations/list-automation-runs"},{"title":"Create automation run","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml post /api/v1/automations/{id}/runs","href":"/api-reference/automations/create-automation-run"}]},{"group":"Environments","icon":"box","pages":[{"title":"List environments","description":"Returns all server-managed environment definitions, sorted by id.","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml get /api/v1/environments","href":"/api-reference/environments/list-environments"},{"title":"Create environment","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml post /api/v1/environments","href":"/api-reference/environments/create-environment"},{"title":"Retrieve environment","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml get /api/v1/environments/{id}","href":"/api-reference/environments/retrieve-environment"},{"title":"Replace environment","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml put /api/v1/environments/{id}","href":"/api-reference/environments/replace-environment"},{"title":"Delete environment","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml delete /api/v1/environments/{id}","href":"/api-reference/environments/delete-environment"}]},{"group":"Variables","icon":"brackets-curly","pages":[{"title":"List variables","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml get /api/v1/variables","href":"/api-reference/variables/list-variables"},{"title":"Store or update a variable","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml post /api/v1/variables","href":"/api-reference/variables/store-or-update-a-variable"},{"title":"Get a variable","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml get /api/v1/variables/{name}","href":"/api-reference/variables/get-a-variable"},{"title":"Replace a variable value","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml put /api/v1/variables/{name}","href":"/api-reference/variables/replace-a-variable-value"},{"title":"Delete a variable","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml delete /api/v1/variables/{name}","href":"/api-reference/variables/delete-a-variable"}]},{"group":"More","icon":"ellipsis","pages":[{"group":"Administration","icon":"gear","pages":[{"title":"Retrieve Server Settings","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml get /api/v1/settings","href":"/api-reference/settings/retrieve-server-settings"}]},{"group":"Models","icon":"microchip","pages":[{"title":"List Models","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml get /api/v1/models","href":"/api-reference/models/list-models"},{"title":"Test Model","deprecated":null,"version":null,"openapi":"/api-reference/fabro-api.yaml post /api/v1/models/{id}/test","href":"/api-reference/models/test-model"}]}]}]},{"tab":"Changelog","icon":"clock-rotate-left","pages":[{"title":"Changelog","href":"/changelog/2026-09-03"}]}]},"title":"Create automation run - Fabro","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}