Automation

Schedule agent tasks on a recurring basis or execute them on demand via webhooks.

Automation is in BETA.

Automation lets you schedule tasks for your agents or trigger them from external systems via webhooks. Each automation defines a prompt (the instruction for the agent) and a trigger type (schedule or webhook).

Creating an Automation

1. Open the agent’s configuration page
2. Scroll to the Automation section and click Add automation
3. Choose a trigger type and configure it (see below)
4. Enter the Prompt — the instruction text that tells the agent what to do when triggered
5. Click Create

Schedule Triggers

Run an automation on a recurring schedule:

Frequency	Options
Every minute	Runs every minute
Hourly	Select the minute of each hour
Daily	Select the time of day
Weekly	Select one or more days of the week and the time
Monthly	Select a specific date, or a relative day (e.g., “first Monday”), and the time

All schedule configurations include a timezone setting.

Webhook Triggers

Run an automation when an external system sends a request:

1. Create the automation with Webhook as the trigger type
2. A Webhook Secret is displayed at creation — copy it immediately, as it cannot be retrieved later
3. External systems trigger the automation by sending a POST request:

POST /jobs/trigger/{job_id}
Header: X-Job-Secret: <your-webhook-secret>

The Webhook Secret is shown only once when the automation is created. Store it securely. If lost, you must delete the automation and create a new one.

The webhook executes the job asynchronously and returns an HTTP 202 Accepted response:

{
  "success": true,
  "job_id": "<job_id>",
  "message": "Job execution started"
}

If the secret is missing or invalid, the endpoint returns 401 Unauthorized.

Prompt

Skills in Prompts

When creating an automation, you can insert skills (abilities) into the prompt to give the agent access to specialized capabilities during execution.

1. In the prompt editor, click the + button
2. Select a skill from the list of enabled skills
3. The skill is inserted into the prompt as a tagged reference

Skills in prompts require the agent_skills feature flag to be enabled.

MCP Tools

When you create an automation, the MCP tools picker shows the apps the job can actually use:

• Shared apps connected to the agent
• Your own Private apps

Private apps belonging to other users don’t appear. Pick only the tools the job needs — anything you disable in the agent’s Apps settings is excluded automatically.

Job Ownership

Each automation belongs to its creator and runs as that user — whether triggered manually, on a schedule, or by a webhook. Your own Private apps keep working in your scheduled and webhook automations, even when no one is signed in; apps owned by other users are never used on your behalf.

The automation list shows only the jobs you created. Teammates’ automations are not displayed, and other members of the agent cannot edit, disable, or trigger yours.

Managing Automations

From the automation list, you can:

• Enable / Disable — Toggle an automation on or off without deleting it
• Edit — Modify the schedule, prompt, or other settings
• Delete — Permanently remove the automation
• Cancel — Stop a currently running execution
• Retry — Re-run a failed execution

You cannot edit or delete an automation while it is running. Wait for the execution to complete or cancel it first.

The trigger type (schedule or webhook) cannot be changed after creation. To switch trigger types, delete the automation and create a new one.

Automation Status

Status	Description
Awaiting run	Triggered and queued for execution
Running	Currently executing
Completed	Finished successfully
Failed	Execution encountered an error

Related

• Managing Agents — Agent creation and configuration
• Apps (MCP) — Connecting MCP apps and managing their access scope
• Skills — Adding AI capability packages
• API & MCP Access — Accessing agents from external tools