Documentation | m8tes.ai

A teammate is a reusable persona with a name, instructions, and tools. Configure once, run many times.

Create a Teammate

Field	Type	Description
`name`	string (required)	Display name for the teammate
`instructions`	string	System prompt — what this teammate does
`tools`	string[]	Tool names (e.g. `["slack", "linear"]`). See Tools
`role`	string	Persona role, injected into prompt context
`goals`	string	Teammate goals, injected into system prompt
`user_id`	string	End-user ID for multi-tenancy
`metadata`	dict	Arbitrary key-value data stored with the teammate
`allowed_senders`	string[]	Email addresses or `@domain` patterns for email inbox

Only provided fields are updated — omitted fields remain unchanged.

Soft-deletes (archives) the teammate. Archived teammates won't appear in list results.

There are three ways to trigger a run on a teammate:

Method	Use Case
Message	Call `runs.create()` with a message — the most common way
Webhook	External systems POST to a webhook URL to start a run
Email Inbox	Inbound emails automatically trigger runs