HumaboamAgent run templates (user JWT)
Endpoints for listing agent run templates. User JWT required (not agent token). Used by the app to show available run templates (e.g. in onboarding or dashboard).
Base path: /api/agent-run-templates
GET /api/agent-run-templates/
List agent run templates. In production only templates with in_production=true are returned; in local dev (APP_ENV=local) all templates are returned.
Request
| Where | Name | Type | Required | Description |
|---|---|---|---|---|
| Header | Authorization | string | Yes | Bearer <user JWT> |
Response (200)
Array of template objects:
| Field | Type | Description |
|---|---|---|
id | string | UUID. |
name | string | Template name (often used as workflow_id). |
description | string | Description. |
require_sign_in | boolean | Default true. |
is_search_agent | boolean | Default true. |
in_production | boolean | When false, excluded from list in production. |
shown_in_onboarding | boolean | Whether to show during onboarding. |
created_at | string | null | ISO 8601. |
updated_at | string | null | ISO 8601. |
Error responses
| Status | Cause |
|---|---|
| 401 | Missing or invalid user JWT. |
| 500 | Unable to load agent run templates. |
GET /api/agent-run-templates/{template_id}
Get a single agent run template by ID.
Request
| Where | Name | Type | Required | Description |
|---|---|---|---|---|
| Header | Authorization | string | Yes | Bearer <user JWT> |
| Path | template_id | string | Yes | Template UUID. |
Response (200)
Single template object (same shape as list items above).
Error responses
| Status | Cause |
|---|---|
| 401 | Missing or invalid user JWT. |
| 404 | Template not found. |
| 500 | Unable to load agent run template. |