Document automation run timeouts

openhands/usage/automations/creating-automations.mdx

@@ -1,17 +1,17 @@
 ---
 title: Creating Automations
 description: Learn how to create scheduled automations using the Automation Skill.
 ---
 
 The easiest way to create an automation is to ask OpenHands directly. The Automation Skill handles all the details—you just describe what you want.
 
 ## Prompt vs Plugin Automations
 
 There are two types of automations:
 
 <Tabs>
   <Tab title="Prompt-based">
     Most automations are prompt-based. Just describe the task in natural language:
 
     ```
     Create an automation called "Daily Standup Summary" that runs every weekday 
@@ -47,6 +47,7 @@
 - **What it should do**: Describe the task clearly
 - **When it should run**: Daily, weekly, every hour, etc.
 - **Timezone** (optional): Defaults to UTC if not specified
+- **Run timeout** (optional): Defaults to 10 minutes; maximum 30 minutes
 - **Name** (optional): The agent can suggest one based on your description
 - **Plugins** (optional): Mention specific plugins if you need extended capabilities
 
@@ -120,12 +121,16 @@
 - "first day of each month"
 - "twice a day at 9 AM and 5 PM"
 
 The agent converts this to the appropriate cron schedule.
 
 <Tip>
 If you're familiar with cron expressions, you can specify them directly: "Run on cron schedule `0 9 * * 1-5`"
 </Tip>
 
+## Run Timeouts
+
+Each run stops after its timeout. The default is 10 minutes; you can request up to 30 minutes, for example: "Use a 20-minute timeout."
+
 ## After Creation
 
 Once your automation is created:

openhands/usage/automations/managing-automations.mdx

@@ -1,11 +1,11 @@
 ---
 title: Managing Automations
 description: 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
@@ -43,6 +43,14 @@
 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
+```
+
+Timeouts can be up to 30 minutes. Runs that exceed their timeout fail automatically.
+
 ## Running Manually
 
 Test an automation or run it outside its normal schedule:
@@ -72,7 +80,7 @@
 - **Debug** if something went wrong
 
 <Tip>
 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.
 </Tip>
 
 ### Run Statuses
@@ -82,7 +90,7 @@
 - **Completed**: Finished successfully
 - **Failed**: Something went wrong—check the run details
 
 ## Deleting Automations
 
 ```
 Delete the "Old Report" automation