Referência da APIGatilhos
Disparar gatilho agora
Dispara o gatilho agora, fora da agenda, como o botão Disparar do editor. Com a conversa ocupada e o evento na fila, responde `queued: true`: ele roda no fim do turno. O que não chegou à conversa responde 409 `fire_failed`, com o motivo cru em `reason` (`agent-paused`, `busy`, `quota-exceeded`...). Exige o escopo triggers:write.
Atualizado em 04 de novembro de 2026
Authorization
chaveDeApi AuthorizationBearer <token>
Chave de API da organização, criada nas configurações. Envie-a em Authorization: Bearer <sua chave>.
In: header
Path Parameters
agentId*string
Id ou apelido do agente.
triggerId*string
Format
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/agents/string/triggers/497f6eca-6276-4993-bfeb-53cbbbba6f08/fire"{ "fired": true, "queued": true, "thread_id": "1de43264-67cb-48af-89f9-e865c375bb84"}