API Reference
Templates API
CRUD for agent templates.
GET /v1/templates
List all templates visible to the authenticated user (global + tenant-scoped).
Response:
{
"templates": [
{
"id": "uuid",
"slug": "research-analyst",
"name": "Research Analyst",
"description": "Deep web research...",
"category": "research",
"tools": ["bash", "read"],
"modelOverride": { "providerID": "anthropic", "modelID": "claude-sonnet-4-5" },
"isPublished": true
}
]
}
POST /v1/templates
Create a custom template. Requires admin.manage_templates permission.
Request:
{
"name": "Sales SDR",
"slug": "sdr",
"description": "Qualifies leads, drafts outreach",
"category": "sales",
"systemPrompt": "You are an expert SDR...",
"tools": ["*"],
"modelOverride": { "providerID": "anthropic", "modelID": "claude-opus-4-7" },
"isPublished": true
}
The API uses camelCase field names, including systemPrompt and modelOverride.providerID / modelOverride.modelID.
PATCH /v1/templates/:id
Update a template. Requires admin.manage_templates.
DELETE /v1/templates/:id
Delete a template. Requires admin.manage_templates. Cannot delete global templates.
