Listar templates
Lista o catálogo recortado pelo alcance: um template global é visível a todos, um de cliente só a quem o alcança. type (text/voice) e status (active/inactive/all, padrão active) estreitam; tenant_id aplica a visão de um cliente dentro do alcance, e um cliente fora dele responde 404 TENANT_NOT_FOUND.
Autorização
bearer templates:readCredencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.
Em: header
Escopo: templates:read
Parâmetros de consulta
Estreita por espécie.
Valor em
- "text"
- "voice"
Os ativos (padrão), os inativos ou todos.
Valor em
- "active"
- "inactive"
- "all"
Estreita para um cliente (só faz sentido em alcance de plataforma ou de revenda).
int64Cursor opaco devolvido em page.next_cursor da página anterior. Omita para começar do início.
Tamanho da página. Padrão 50; o máximo é o da coleção: 200, ou até 500 nas coleções de itens pequenos.
int320 <= valueCorpo da resposta
application/json
application/json
curl -X GET "https://example.com/templates"{ "data": [ { "agent_instructions": "string", "agent_mode": "simple", "agent_type": "sdr", "apply_policy": null, "config": null, "created_at": "string", "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4", "description": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "is_default": true, "name": "string", "origin_template_id": "059a4309-9d59-48c5-b0fa-7a904a9be6f8", "output_contract": "string", "owner_tenant_id": 0, "promptforge_recipe": null, "setup_mode": "direct", "status": "active", "template_version": 0, "type": "text", "updated_at": "string", "wizard_schema": null } ], "page": { "has_more": true, "next_cursor": "string" }}