API referenceEndpoints

List agent templates

Requires an authenticated user JWT. Generated from the production route registered in `internal/features/agents/inbound/roles.go`. Returns shared Engine-owned template summaries across Engine applications under the existing tenant model. Built-in listings/presentation stay unchanged. An external Blinq appears only with an accepted current version and availability=available, carrying executor_mode=external and a setup_required boolean indicating whether the release needs a connected account. Hidden and pending-only Blinqs are absent. A promotion appends one immutable edition; rollback selects its existing edition. Shared content and appearance never expose private setup or work. No SaaS publication is needed.

GET/v1/agent-templates

Requires an authenticated user JWT. Generated from the production route registered in internal/features/agents/inbound/roles.go. Returns shared Engine-owned template summaries across Engine applications under the existing tenant model. Built-in listings/presentation stay unchanged. An external Blinq appears only with an accepted current version and availability=available, carrying executor_mode=external and a setup_required boolean indicating whether the release needs a connected account. Hidden and pending-only Blinqs are absent. A promotion appends one immutable edition; rollback selects its existing edition. Shared content and appearance never expose private setup or work. No SaaS publication is needed.

Authorization

bearerAuth
AuthorizationBearer <token>

Engine-issued API key or tenant-signed JWT.

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/agent-templates"
{  "items": [    {      "role_id": "string",      "edition": 0,      "name": "string",      "description": "string",      "color": "string",      "avatar": "string",      "availability": "available",      "executor_mode": "external",      "setup_required": true,      "details": "string",      "capabilities": {        "accepts_messages": true,        "models": [          "string"        ],        "starts_on_hire": true,        "schedule_cron": "string",        "inbox_actions": [          "string"        ],        "reads_context": true,        "tools": [          "string"        ],        "limits": {          "max_model_calls": 0,          "max_input_tokens": 0,          "max_output_tokens": 0,          "max_cost_micros": 0        }      }    }  ]}