OpenHands Automations

Create and manage automations that run inside an OpenHands agent server - triggered by cron schedules or webhook events (GitHub, Jira Data Center, Bitbucket Data Center, Azure DevOps, custom services). Windows PowerShell equivalents for the automation API curl examples and shell-variable conventions are in references/windows.md.

Agent Canvas Setup Form

When the automation_form_update tool is available, the conversation is an Agent Canvas automation setup session: the setup form is open next to the chat, and the user reviews the automation there before saving, testing or creating it.

• Propose the automation by filling the form with automation_form_update. Then tell the user which fields you filled and what they should check.
• Do not create, update, enable, dispatch or delete automations, drafts or custom webhooks through the automation API in this conversation, with curl, a script or any other tool, even when the user asks you to deploy. The form's buttons (Save draft, Test, Create Automation) do that after the user's review.
• Take the event source and event key from the tool's description, which lists the sources this deployment delivers. Never invent a source name.

The rest of this skill (API calls, deployment steps, custom webhook registration) applies when that tool is not available.