Documentation | m8tes.ai

A task is a reusable instruction template attached to a teammate. Define the work once, then trigger it manually, on a schedule, via webhook, or by email.

Create a Task

Fields

Field	Type	Description
`teammate_id`	int (required)	The teammate that runs this task
`instructions`	string (required)	What the teammate should do
`name`	string	Display name for the task
`tools`	string[]	Override teammate tools for this task
`expected_output`	string	Description of expected output format
`goals`	string	Task-specific goals
`user_id`	string	End-user ID for multi-tenancy

Run a Task

Execute a saved task on demand:

Run Options

Field	Type	Default	Description
`stream`	bool	`true`	Enable real-time event streaming
`user_id`	string	—	End-user ID for multi-tenancy
`metadata`	dict	—	Arbitrary key-value data
`memory`	bool	`true`	Include saved per-user memories
`history`	bool	`true`	Include previous run context
`human_in_the_loop`	bool	`false`	Enable interactive features — see Human-in-the-Loop
`permission_mode`	string	`"autonomous"`	See Permissions. Requires `human_in_the_loop` for non-autonomous modes

Note: permission_mode values other than "autonomous" require human_in_the_loop=true.

For automated execution, attach a trigger instead — see below.

Run Tasks with Triggers

Tasks become automated when you attach a trigger:

Trigger	How it works
Scheduling	Cron expressions or fixed intervals
Webhook	External systems POST to a URL to trigger the task
Email Inbox	Inbound emails trigger a run

Quick Example: Schedule a Task

Python

Quick Example: Webhook Trigger

Python

Quick Example: Email Trigger

Python

List Tasks

Update a Task

Delete a Task

What's Next

Scheduling — automate tasks with cron and intervals
Webhook Triggers — trigger tasks from external systems
Runs — understand run execution and streaming