Agents API
The Agents API lets you manage agent templates — the reusable configurations that power each step in your workflows.
Endpoints
List Agent Templates
GET /api/v1/agents
Returns all agent templates available to the authenticated user, including system templates.
Get Agent Template
GET /api/v1/agents/:id
Returns a single agent template with its full configuration.
Create Agent Template
POST /api/v1/agents
Creates a new agent template. Required fields: name, default_prompt. Optional fields include default_tools, default_tasks, tags, and short_description.
List Available Tools
GET /api/v1/agents/tools
Returns the list of tools available for agent configuration. This endpoint does not require authentication. Each tool includes a name, description, and parameters schema.
Agent vs Action Templates
Templates with step_type: "agent" are LLM-powered agents. Templates with step_type: "action" are deterministic action steps (e.g., send email). Action templates have an action_type field that determines their behavior.