VolundOS
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
POST
/v1/agents/{agentId}/triggers/{triggerId}/fire

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
Formatuuid

Response 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"}