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

FieldTypeDescription
teammate_idint (required)Teammate that executes the task
instructionsstring (required)What should happen when the task runs
namestringTask label
toolsstring[]Optional override of teammate tools
expected_outputstringOutput format expectation
goalsstringTask-specific goals injected into prompt context
user_idstringEnd-user scope. See Users

How to run tasks

Manually

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

Python

Scheduling

Scheduling runs a task automatically on a cadence.

Webhook trigger

Webhook triggers let external systems start the task.

Manage tasks

Python

What's next