List, update, enable, disable, and delete your automations.
You can manage your automations by asking OpenHands directly—just like you created them.
Viewing Your Automations
List my automations
Show me the details of the "Daily Report" automation
Enabling and Disabling
Pause an automation without deleting it:
Disable the "Daily Report" automation
Turn it back on:
Enable the "Daily Report" automation
Disabling an automation keeps all its settings intact. Use this when you want to temporarily stop runs without losing your configuration.
Changing the Schedule
Change the "Daily Report" automation to run at 10 AM instead of 9 AM
Update the "Weekly Cleanup" automation to run on Sundays at 2 AM UTC
Changing the Run Timeout
Set the "Weekly Cleanup" automation timeout to 20 minutes
The maximum timeout depends on your deployment. Runs that exceed their timeout fail automatically.
Running Manually
Test an automation or run it outside its normal schedule:
Trigger the "Daily Report" automation now
Run the "Health Check" automation immediately
This is useful for:
Testing a newly created automation
Running a report on-demand
Debugging issues
Viewing Past Runs
Show me recent runs of the "Daily Report" automation
Each run creates a conversation that automatically appears in your conversations list. You can:
View in the OpenHands UI to see what happened
Continue if you want to interact with the sandbox
Debug if something went wrong
In an automation’s Activity Log, use Export JSON or Export CSV to download its complete run history.
Automations are user-scoped, so all your automation runs appear alongside your regular conversations. Look for them in your conversations list after each scheduled run.
On OpenHands Cloud, organization members can open a link to an automation-run conversation owned by another member and view it read-only. Start from the run link in the automation’s activity log or a conversation URL of the form /conversations/<id>. Read-only viewers can follow the full history but cannot send messages or change the agent configuration.
Run Statuses
Pending: Scheduled, waiting to start
Running: Currently executing
Completed: Finished successfully
Failed: Something went wrong—check the run details
Deleting Automations
Delete the "Old Report" automation
Deleting an automation is permanent. Consider disabling it instead if you might need it later.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"OpenHands Docs","colors":{"primary":"#99873c","light":"#ffe165","dark":"#ffe165"},"logo":{"light":"https://mintcdn.com/allhandsai/DjhqLcIy_hW6pRTg/logo/light.png?fit=max\u0026auto=format\u0026n=DjhqLcIy_hW6pRTg\u0026q=85\u0026s=49b636402b03f7279ca5e1afefeec1d2","dark":"https://mintcdn.com/allhandsai/DjhqLcIy_hW6pRTg/logo/dark.png?fit=max\u0026auto=format\u0026n=DjhqLcIy_hW6pRTg\u0026q=85\u0026s=e0c4017631cebc3a289798438e2c0d7a"},"favicon":"https://mintcdn.com/allhandsai/DjhqLcIy_hW6pRTg/openhands/logo-square.png?fit=max\u0026auto=format\u0026n=DjhqLcIy_hW6pRTg\u0026q=85\u0026s=6ef1bab575660ae6e2d44fcc57bc675f","appearance":{"default":"light"},"background":{"color":{"light":"#f7f3ee","dark":"#0B0D0E"}},"navbar":{"links":[],"primary":{"type":"github","href":"https://github.com/OpenHands/OpenHands"}},"footer":{"socials":{"slack":"https://openhands.dev/joinslack","github":"https://github.com/OpenHands"},"links":[{"header":"Links","items":[{"label":"Company","href":"https://openhands.dev/"},{"label":"Blog","href":"https://openhands.dev/blog"},{"label":"Cloud","href":"https://app.all-hands.dev"},{"label":"Enterprise","href":"https://openhands.dev/enterprise"}]}]},"seo":{"indexing":"navigable"},"integrations":{"gtm":{"tagId":"GTM-M9S7V5BQ"}},"contextual":{"options":["copy","view","download-spec","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"allhandsai","hasAudioNarration":false,"actualSubdomain":"allhandsai","customDomains":["docs.openhands.dev"],"gitSource":{"type":"github","owner":"openhands","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aff3e0d6d84f03323a42c39","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Cloud","count":197},{"language":"default","tag":"Cloud API","count":188},{"language":"default","tag":"REST API Reference","count":186},{"language":"default","tag":"SDK","count":128},{"language":"default","tag":"Guides","count":105},{"language":"default","tag":"API Reference","count":95},{"language":"default","tag":"Enterprise","count":79},{"language":"default","tag":"Home","count":58},{"language":"default","tag":"Remote Agent Server","count":55},{"language":"default","tag":"Agent Canvas","count":41}]},"assistantConfig":{"deflection":{"enabled":true,"email":"contact@openhands.dev","showHelpButton":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":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#banner *{color:rgb(67, 66, 64)}.oh-arch{--oh-arch-bg: #fbf9f6;--oh-arch-surface: #f2ede5;--oh-arch-card: #ffffff;--oh-arch-line: #e2dbd0;--oh-arch-text: #1c1b19;--oh-arch-text-secondary: #6b675f;--oh-arch-text-tertiary: #a39e93;--oh-arch-accent: #ffe165;--oh-arch-hover: #99873c;margin:1.5rem 0;border:1px solid var(--oh-arch-line);border-radius:12px;background:var(--oh-arch-bg);color:var(--oh-arch-text);overflow:hidden}.dark .oh-arch{--oh-arch-bg: #111416;--oh-arch-surface: #171b1e;--oh-arch-card: #1c2124;--oh-arch-line: #2d3337;--oh-arch-text: #f1efe9;--oh-arch-text-secondary: #a3a19a;--oh-arch-text-tertiary: #6f726f;--oh-arch-hover: #ffe165}.oh-arch-header{padding:18px 20px 0}.oh-arch-eyebrow,.oh-arch-label{font-family:ui-monospace, SFMono-Regular, Menlo, monospace;font-size:10px;font-weight:500;letter-spacing:0.08em;color:var(--oh-arch-text-secondary);fill:var(--oh-arch-text-secondary)}.oh-arch-eyebrow{text-transform:uppercase}.oh-arch-scroll{overflow-x:auto;scrollbar-width:thin}.oh-arch-diagram{display:block;width:100%;min-width:640px;height:auto}.oh-arch-boundary{fill:var(--oh-arch-surface);stroke:var(--oh-arch-line);stroke-dasharray:5 5}.oh-arch-card{fill:var(--oh-arch-card);stroke:var(--oh-arch-line);transition:stroke 150ms ease}.oh-arch-service:hover .oh-arch-card,.oh-arch-service:focus-visible .oh-arch-card{stroke:var(--oh-arch-hover);stroke-width:2}.oh-arch-service:focus-visible{outline:none}.oh-arch-icon{color:var(--oh-arch-text-secondary)}.oh-arch-name{fill:var(--oh-arch-text);font-size:15px;font-weight:600;letter-spacing:-0.025em}.oh-arch-detail{fill:var(--oh-arch-text-secondary);font-size:12px}.oh-arch-accent{fill:var(--oh-arch-accent)}.oh-arch-app-paths,.oh-arch-worker-paths,.oh-arch-external-paths,.oh-arch-arrows{fill:none;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round}.oh-arch-app-paths{stroke:var(--oh-arch-text)}.oh-arch-worker-paths,.oh-arch-external-paths,.oh-arch-arrows{stroke:var(--oh-arch-text-tertiary)}.oh-arch-external-paths{stroke-dasharray:4 6}.oh-arch-caption{border-top:1px solid var(--oh-arch-line);padding:16px 20px;font-size:12px;line-height:1.6;color:var(--oh-arch-text-secondary)}.oh-arch-legend{display:flex;flex-wrap:wrap;gap:8px 20px}.oh-arch-legend span{display:flex;align-items:center;gap:8px}.oh-arch-legend i{display:inline-block;width:18px;border-top:2px solid}.oh-arch-key-app{color:var(--oh-arch-text)}.oh-arch-key-worker,.oh-arch-key-external{color:var(--oh-arch-text-tertiary)}.oh-arch-legend .oh-arch-key-external{border-top-style:dashed}.oh-arch-caption p{margin:8px 0 0}@media (prefers-reduced-motion: reduce){.oh-arch-card{transition:none}}"}]}
{"page":{"pagePath":"openhands/usage/automations/managing-automations","slug":"/openhands/usage/automations/managing-automations","pageMetadata":{"title":"Managing Automations","description":"List, update, enable, disable, and delete your automations.","href":"/openhands/usage/automations/managing-automations"},"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: \"List, update, enable, disable, and delete your automations.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Tip,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`You can manage your automations by asking OpenHands directly—just like you created them.`}),`\n`,_jsx(Heading,{level:`2`,id:`viewing-your-automations`,children:`Viewing Your Automations`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`List my automations`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Show me the details of the \"Daily Report\" automation`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`enabling-and-disabling`,children:`Enabling and Disabling`}),`\n`,_jsx(_components.p,{children:`Pause an automation without deleting it:`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Disable the \"Daily Report\" automation`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`Turn it back on:`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Enable the \"Daily Report\" automation`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Disabling an automation keeps all its settings intact. Use this when you want to temporarily stop runs without losing your configuration.`})}),`\n`,_jsx(Heading,{level:`2`,id:`changing-the-schedule`,children:`Changing the Schedule`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Change the \"Daily Report\" automation to run at 10 AM instead of 9 AM`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Update the \"Weekly Cleanup\" automation to run on Sundays at 2 AM UTC`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`changing-the-run-timeout`,children:`Changing the Run Timeout`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Set the \"Weekly Cleanup\" automation timeout to 20 minutes`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`The maximum timeout depends on your deployment. Runs that exceed their timeout fail automatically.`}),`\n`,_jsx(Heading,{level:`2`,id:`running-manually`,children:`Running Manually`}),`\n`,_jsx(_components.p,{children:`Test an automation or run it outside its normal schedule:`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Trigger the \"Daily Report\" automation now`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Run the \"Health Check\" automation immediately`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`This is useful for:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Testing a newly created automation`}),`\n`,_jsx(_components.li,{children:`Running a report on-demand`}),`\n`,_jsx(_components.li,{children:`Debugging issues`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`viewing-past-runs`,children:`Viewing Past Runs`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Show me recent runs of the \"Daily Report\" automation`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`Each run creates a conversation that automatically appears in your conversations list. You can:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`View in the OpenHands UI`}),` to see what happened`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Continue`}),` if you want to interact with the sandbox`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Debug`}),` if something went wrong`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`In an automation’s `,_jsx(_components.code,{children:`Activity Log`}),`, use `,_jsx(_components.code,{children:`Export JSON`}),` or `,_jsx(_components.code,{children:`Export CSV`}),` to download its complete run history.`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Automations are user-scoped, so all your automation runs appear alongside your regular conversations. Look for them in your conversations list after each scheduled run.`})}),`\n`,_jsxs(_components.p,{children:[`On OpenHands Cloud, organization members can open a link to an automation-run conversation owned by another member and view it read-only. Start from the run link in the automation’s activity log or a conversation URL of the form `,_jsx(_components.code,{children:`/conversations/\u003cid>`}),`. Read-only viewers can follow the full history but cannot send messages or change the agent configuration.`]}),`\n`,_jsx(Heading,{level:`3`,id:`run-statuses`,children:`Run Statuses`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Pending`}),`: Scheduled, waiting to start`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Running`}),`: Currently executing`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Completed`}),`: Finished successfully`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Failed`}),`: Something went wrong—check the run details`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`deleting-automations`,children:`Deleting Automations`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Delete the \"Old Report\" automation`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Deleting an automation is permanent. Consider disabling it instead if you might need it later.`})}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next Steps`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/openhands/usage/automations/overview`,children:`Automations overview \u0026 examples`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/openhands/usage/automations/creating-automations`,children:`Create new automations`})}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Managing Automations","description":"List, update, enable, disable, and delete your automations.","href":"/openhands/usage/automations/managing-automations"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Viewing Your Automations","slug":"viewing-your-automations","depth":2,"children":[]},{"title":"Enabling and Disabling","slug":"enabling-and-disabling","depth":2,"children":[]},{"title":"Changing the Schedule","slug":"changing-the-schedule","depth":2,"children":[]},{"title":"Changing the Run Timeout","slug":"changing-the-run-timeout","depth":2,"children":[]},{"title":"Running Manually","slug":"running-manually","depth":2,"children":[]},{"title":"Viewing Past Runs","slug":"viewing-past-runs","depth":2,"children":[{"title":"Run Statuses","slug":"run-statuses","depth":3,"children":[]}]},{"title":"Deleting Automations","slug":"deleting-automations","depth":2,"children":[]},{"title":"Next Steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/allhandsai/dddab338317a519d/openhands/reo-init.js","/_mintlify/custom/allhandsai/ae719f15d762e1fe/openhands/posthog-init.js","/_mintlify/custom/allhandsai/b35f7f3c3c83fb4c/openhands/canvas-handoff.js","/_mintlify/custom/allhandsai/771d6371c43b73b7/openhands/linkedin-copy-tracking.js","/_mintlify/custom/allhandsai/46724455a27ebfc6/openhands/copy-click-tracking.js"],"subdomain":"allhandsai","siteName":"OpenHands Docs","title":"Managing Automations - OpenHands Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-25T20:04:22.793Z","originalFileLocation":"openhands/usage/automations/managing-automations.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=\"light\"}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=\"List, update, enable, disable, and delete your automations.\">\u003cmeta data-mint-head name=\"application-name\" content=\"OpenHands Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/allhandsai/NJyVpY-OoVetrcKF/_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/allhandsai/NJyVpY-OoVetrcKF/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/allhandsai/NJyVpY-OoVetrcKF/_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/allhandsai/NJyVpY-OoVetrcKF/_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/allhandsai/NJyVpY-OoVetrcKF/_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/allhandsai/NJyVpY-OoVetrcKF/_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/allhandsai/NJyVpY-OoVetrcKF/_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/allhandsai/NJyVpY-OoVetrcKF/_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/allhandsai/NJyVpY-OoVetrcKF/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Managing Automations - OpenHands Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"List, update, enable, disable, and delete your automations.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OpenHands Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.openhands.dev/openhands/usage/automations/managing-automations\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://allhandsai.mintlify.site/_mintlify/api/og/v2?division=Automations\u0026amp;title=Managing+Automations\u0026amp;description=List%2C+update%2C+enable%2C+disable%2C+and+delete+your+automations.\u0026amp;theme=2eb43b0b1453a2072ec6e8c0\u0026amp;signature=22d5fe1d3de50ca7b888b7f52804f4ad77555270dc7f79b3a27f43e2e8e53579\">\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=\"Managing Automations - OpenHands Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"List, update, enable, disable, and delete your automations.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://allhandsai.mintlify.site/_mintlify/api/og/v2?division=Automations\u0026amp;title=Managing+Automations\u0026amp;description=List%2C+update%2C+enable%2C+disable%2C+and+delete+your+automations.\u0026amp;theme=2eb43b0b1453a2072ec6e8c0\u0026amp;signature=22d5fe1d3de50ca7b888b7f52804f4ad77555270dc7f79b3a27f43e2e8e53579\">\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/allhandsai/NJyVpY-OoVetrcKF/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OpenHands Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#99873c\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.openhands.dev/openhands/usage/automations/managing-automations\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/openhands/usage/automations/managing-automations.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.openhands.dev/#organization\",\"name\":\"OpenHands Docs\",\"url\":\"https://docs.openhands.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/allhandsai/DjhqLcIy_hW6pRTg/logo/light.png?fit=max\u0026auto=format\u0026n=DjhqLcIy_hW6pRTg\u0026q=85\u0026s=49b636402b03f7279ca5e1afefeec1d2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.openhands.dev#website\",\"name\":\"OpenHands Docs\",\"url\":\"https://docs.openhands.dev\",\"publisher\":{\"@id\":\"https://docs.openhands.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.openhands.dev/openhands/usage/automations/managing-automations#webpage\",\"url\":\"https://docs.openhands.dev/openhands/usage/automations/managing-automations\",\"name\":\"Managing Automations\",\"description\":\"List, update, enable, disable, and delete your automations.\",\"dateModified\":\"2026-09-25T20:04:22.793Z\",\"isPartOf\":{\"@id\":\"https://docs.openhands.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.openhands.dev/openhands/usage/automations/managing-automations#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.openhands.dev/openhands/usage/automations/managing-automations#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Product Guides\",\"item\":\"https://docs.openhands.dev/openhands/usage/key-features\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Automations\",\"item\":\"https://docs.openhands.dev/openhands/usage/automations/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Managing Automations\",\"item\":\"https://docs.openhands.dev/openhands/usage/automations/managing-automations\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.openhands.dev/openhands/usage/automations/managing-automations#article\",\"headline\":\"Managing Automations\",\"name\":\"Managing Automations\",\"description\":\"List, update, enable, disable, and delete your automations.\",\"url\":\"https://docs.openhands.dev/openhands/usage/automations/managing-automations\",\"mainEntityOfPage\":{\"@id\":\"https://docs.openhands.dev/openhands/usage/automations/managing-automations#webpage\"},\"dateModified\":\"2026-09-25T20:04:22.793Z\",\"publisher\":{\"@id\":\"https://docs.openhands.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.openhands.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OpenHands Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"OpenHands Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/openhands/usage/automations/managing-automations.md","siteName":"OpenHands Docs","nav":{"global":null,"tabs":[{"tab":"Home","pages":[{"group":"Get Started","pages":[{"title":"Introduction","href":"/overview/introduction"},{"title":"Quick Start","href":"/overview/quickstart"},{"title":"Tutorial Library","href":"/openhands/usage/get-started/tutorials"}]},{"group":"Essential Guidelines","pages":[{"title":"When to Use OpenHands","href":"/openhands/usage/essential-guidelines/when-to-use-openhands"},{"title":"Prompting Best Practices","href":"/openhands/usage/tips/prompting-best-practices"},{"title":"Good vs. Bad Instructions","href":"/openhands/usage/essential-guidelines/good-vs-bad-instructions"},{"title":"OpenHands in Your SDLC","href":"/openhands/usage/essential-guidelines/sdlc-integration"}]},{"group":"Use Cases","pages":[{"title":"Use Cases Overview","href":"/openhands/usage/use-cases/overview"},{"title":"Vulnerability Remediation","href":"/openhands/usage/use-cases/vulnerability-remediation"},{"title":"Automated Code Review","href":"/openhands/usage/use-cases/code-review"},{"title":"Automated QA Testing","href":"/openhands/usage/use-cases/qa-changes"},{"title":"Incident Triage","href":"/openhands/usage/use-cases/incident-triage"},{"title":"COBOL Modernization","href":"/openhands/usage/use-cases/cobol-modernization"},{"title":"Dependency Upgrades","href":"/openhands/usage/use-cases/dependency-upgrades"},{"title":"Agent-Driven Daily Workflow","href":"/openhands/usage/use-cases/daily-workflow"},{"title":"Software Factory","href":"/openhands/usage/use-cases/software-factory"},{"title":"Spark Migrations","href":"/openhands/usage/use-cases/spark-migrations"}]},{"group":"Product Guides","pages":[{"title":"Key Features","href":"/openhands/usage/key-features"},{"title":"Hooks","href":"/openhands/usage/customization/hooks"},{"title":"Model Context Protocol (MCP)","href":"/overview/model-context-protocol"},{"group":"Skills","pages":[{"title":"Skills Overview","href":"/overview/skills"},{"title":"General Skills","href":"/overview/skills/repo"},{"title":"Keyword-Triggered Skills","href":"/overview/skills/keyword"},{"title":"Path-Triggered Rules","href":"/overview/skills/path"},{"title":"Organization and User Skills","href":"/overview/skills/org"},{"title":"Global Skills","href":"/overview/skills/public"},{"title":"Adding New Skills","href":"/overview/skills/adding"},{"title":"Creating New Skills","href":"/overview/skills/creating"},{"title":"Monitoring and Improving Skills","href":"/overview/skills/monitoring"}]},{"title":"Plugins","href":"/overview/plugins"},{"title":"Agent Plugins Packages","href":"/overview/agent-plugins"},{"group":"Automations","pages":[{"title":"Automations Overview","href":"/openhands/usage/automations/overview"},{"title":"Creating Automations","href":"/openhands/usage/automations/creating-automations"},{"title":"Event-Based Automations","description":"Trigger automations from custom webhooks, such as Linear, instead of cron schedules.","href":"/openhands/usage/automations/event-automations"},{"title":"Managing Automations","href":"/openhands/usage/automations/managing-automations"}]},{"title":"Repository Customization","description":"You can customize how OpenHands interacts with your repository by creating a `.openhands` directory at the root level.","href":"/openhands/usage/customization/repository"},{"group":"Settings","pages":[{"title":"Application Settings","href":"/openhands/usage/settings/application-settings"},{"title":"Language Model (LLM) Settings","href":"/openhands/usage/settings/llm-settings"},{"title":"Secrets Management","href":"/openhands/usage/settings/secrets-settings"},{"title":"Model Context Protocol (MCP)","href":"/openhands/usage/settings/mcp-settings"}]}]},{"group":"Additional Documentation","pages":[{"group":"Sandbox Server","pages":[{"title":"REST API (V1)","href":"/openhands/usage/api/v1"}]},{"group":"LLM Configuration","pages":[{"title":"Overview","href":"/openhands/usage/llms/llms"},{"group":"LLM Providers","pages":[{"title":"OpenHands","href":"/openhands/usage/llms/openhands-llms"},{"title":"AWS Bedrock","href":"/openhands/usage/llms/aws-bedrock"},{"title":"Azure","href":"/openhands/usage/llms/azure-llms"},{"title":"Use DigitalOcean Inference with OpenHands","href":"/openhands/usage/llms/digitalocean"},{"title":"Google Gemini/Vertex","href":"/openhands/usage/llms/google-llms"},{"title":"Groq","href":"/openhands/usage/llms/groq"},{"title":"Run Local LLMs with OpenHands","href":"/openhands/usage/llms/local-llms"},{"title":"LiteLLM Proxy","href":"/openhands/usage/llms/litellm-proxy"},{"title":"Moonshot AI","href":"/openhands/usage/llms/moonshot"},{"title":"OpenAI","href":"/openhands/usage/llms/openai-llms"},{"title":"Use OpenRouter with OpenHands","href":"/openhands/usage/llms/openrouter"}]}]}]},{"group":"OpenHands Community","pages":[{"title":"Community","href":"/overview/community"},{"title":"Contributing","href":"/overview/contributing"},{"title":"Issue Triage and the ready-for-dev Gate","href":"/overview/issue-lifecycle"},{"title":"FAQs","href":"/overview/faqs"},{"title":null,"href":"/openhands/usage/troubleshooting/feedback"}]}]},{"tab":"Agent Canvas","pages":[{"title":"Agent Canvas","href":"/openhands/usage/agent-canvas/overview"}]},{"tab":"SDK","pages":[{"title":"SDK","href":"/sdk"}]},{"tab":"Cloud","pages":[{"title":"Cloud","href":"/openhands/usage/cloud/openhands-cloud"}]},{"tab":"Enterprise","pages":[{"title":"Enterprise","href":"/enterprise/overview"}]},{"tab":"Enterprise Cookbook","pages":[{"title":"Enterprise Cookbook","href":"/cookbook"}]}]},"basePath":"","title":"Managing Automations - OpenHands Docs","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":[],"chunks":[]}