VolundOS
Referência da APIGatilhos

Vincular conversa ao gatilho de agenda

A conversa em que o gatilho dispara. Vincular liga `resume_last_thread`; desvincular não mexe nele. Exige o escopo triggers:write.

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

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/v1/agents/string/triggers/497f6eca-6276-4993-bfeb-53cbbbba6f08/thread" \  -H "Content-Type: application/json" \  -d '{    "thread_id": "string"  }'
{  "trigger_id": "5727dbbb-3b26-4abe-aec6-181eabbdb21c",  "thread_id": "1de43264-67cb-48af-89f9-e865c375bb84",  "created_thread": true}

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.

Listar gatilhos de App

Os gatilhos de App do agente: eventos de uma integração (novo e-mail, nova issue...) que disparam o agente. Exige `configure` no agente, avaliado como a pessoa da chave. Exige o escopo triggers:read.