Tasks

A task is saved work attached to a teammate. Use tasks when you want repeatable instructions that can run on demand or by trigger.

Create a task

Key fields

webhook_enabled — true when a webhook trigger is active. webhook_url is only set on first creation when webhook=True; it's not retrievable afterwards.

How to run tasks

Manually

Manual runs are best for on-demand actions from your UI or backend.

Pass task_setup_tools=False when you want a saved-task run to stay limited to the task's normal tools and skip the internal task-editing and integration-setup tools.

With human-in-the-loop

Use run_and_wait() to handle approval pauses inline — no manual polling loop needed:

Accepts the same callbacks as runs.create_and_wait(). See Human-in-the-Loop for the full callback API.

Scheduling

Set a cron schedule at creation time — no separate trigger call needed.

Webhook trigger

Enable a webhook at creation time — webhook_url is returned once.

Manage tasks

What's next

• Runs for run lifecycle, follow-ups, and statuses
• Human-in-the-Loop for approvals and plan review
• Webhook Events to react when runs complete