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.
/v1/agent-templatesRequires 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 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 } } } ]}Set platform web search limits
Requires platform-administrator authority. Generated from the production route registered in `internal/features/websearch/inbound/http.go`.
Read an agent template edition
Requires an authenticated user JWT. Generated from the production route registered in `internal/features/agents/inbound/roles.go`. Reads an immutable Engine-owned edition with presentation. External editions include identity, presentation and a setup_required boolean derived from the declared tools. Internal workflow steps and setup questions are empty. Edition is a separate sequential number, not necessarily the Blinq version. Retained editions stay readable after a release change. Use the instantiated agent's template read for its saved edition. Applications cannot publish or replace template content.