Org in a Box
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.

On this page