VolundOS
Referência da APIGatilhos

Excluir gatilho de agenda

Apaga o agendamento. As conversas que ele abriu ficam. Exige o escopo triggers:write.

Atualizado em 04 de novembro de 2026
DELETE
/v1/agents/{agentId}/triggers/{triggerId}

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

curl -X DELETE "https://example.com/v1/agents/string/triggers/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "deleted": true,  "trigger_id": "5727dbbb-3b26-4abe-aec6-181eabbdb21c"}

Atualizar gatilho de agenda

Só o que vier no corpo muda. `{ "enabled": false }` sozinho desliga sem revalidar a agenda; qualquer outro campo junta o corpo ao gatilho atual e valida o resultado como na criação. Um gatilho `once` só aceita `{ "enabled" }`: para mudar mensagem ou instante, apague e crie outro. A conversa vinculada muda por PUT .../thread. Exige o escopo triggers:write.

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.