Documentation | m8tes.ai

A teammate is a reusable agent definition. You configure it once, then trigger runs as often as you need.

Create a teammate

Key fields

Field	Type	Description
`name`	string (optional)	Teammate name. Auto-generated if omitted.
`instructions`	string	Core behavior and context
`tools`	string[]	Allowed tools for this teammate
`role`	string	Optional persona role
`goals`	string	Optional goals injected into prompt context
`default_permission_mode`	string	One of `autonomous`, `approval`, or `plan`; used for direct runs and new task defaults
`user_id`	string	End-user scope. See Users
`allowed_senders`	string[]	Allowed addresses or `@domain` patterns for email triggers
`email_inbox`	bool	Enable email inbox at creation. Returns `email_address` immediately.
`webhook`	bool	Enable webhook trigger at creation. Returns `webhook_url` once.

Triggering runs from teammates

Introduction

A teammate can be triggered in three ways: a direct message, inbound email, or webhook.

Direct runs inherit the teammate's default_permission_mode unless you explicitly override permission_mode on the run request.

Message

Use direct messages when your app already has user input and needs immediate output.

Python

Email Inbox

Use email inbox when email itself should trigger the run.

Webhook

Use webhook when an external system should trigger runs over HTTP.

The webhook URL is shown once at creation or when calling enable_webhook(). Save it — it cannot be retrieved again. To rotate, call enable_webhook() which invalidates the old URL.

Manage teammates