Creates a new BYO Agent that delegates conversations to an external AI Agent. Use this endpoint to register a BYO (Bring Your Own) agent powered by frameworks like Mastra, CrewAI, or LangGraph.
Validation: All referenced tools and actions are validated before the agent is created.
API Key (i.e. Rest API Key from the Dashboard).
Chat API version. Defaults to v3.0.
Name of the agent
"My Mastra Agent"
URL to the icon/avatar of the agent
Integration platform identifier
mastra Type of connection
agent Whether the agent is active
Mastra-specific configuration
List of tool names (must exist in the app's tools)
List of action names (must exist in the app's actions)
Metadata for the agent
Agent created successfully