OpenHands Automations

Create and manage automations that run in OpenHands Cloud sandboxes — triggered by cron schedules or webhook events (GitHub, custom services).

⚠️ CRITICAL — Agent behavior rules:

1. ALWAYS use preset endpoints to create automations. They handle all SDK boilerplate, tarball packaging, and upload automatically:
   • Prompt preset (POST /v1/preset/prompt) — for simple tasks with a natural language prompt
   • Plugin preset (POST /v1/preset/plugin) — when plugins with skills, MCP configs, or commands are needed
2. NEVER write custom SDK scripts or create tarballs. Do not generate Python SDK code, setup.sh files, or tarball uploads unless the user explicitly asks for it.
3. If neither preset can satisfy the requirement, do NOT silently fall back to custom automation. Instead, explain the available options to the user:
   • Prompt preset — simple natural language prompt execution
   • Plugin preset — load plugins with extended capabilities (skills, MCP, hooks, commands)
   • Custom SDK script — full control over code; point them to references/custom-automation.md
   • Let the user choose which approach to use.
4. Only create custom SDK scripts if the user explicitly requests it. Refer to references/custom-automation.md for the full reference.

Authentication