v1

latestOpenAPI 3.0.32026-07-222111928.0 KB

Triggers

Upsert Agent Trigger

Create or update the authenticated user's trigger for an integration on an agent. The integration must already be connected to the agent (its OAuth connection set up in the Duvo dashboard). Set enabled: false to pause a trigger without deleting it.

put/v2/triggers/{agentId}

Path parameters

agentIdstring uuid required

The agent's unique identifier

Request body

integration_slugstring required

Integration slug the trigger fires for (e.g. gmail, outlook, linear-native, google-drive).

trigger_typestring required

Trigger type within the integration (e.g. email_received). Discover valid values via the trigger types endpoint.

filter_configobject

Integration-specific filter config (e.g. sender/subject filters). Shape comes from the integration's filter schema.

enabledboolean

Whether the trigger is active. Defaults to true.

Response

Default Response

idstring required

agent_idstring required

user_idstring required

integration_slugstring required

trigger_typestring required

filter_configobject required

integration_instance_idstring required

enabledboolean required

auto_disabled_atstring nullable required

auto_disabled_reasonstring nullable required

consecutive_missing_connection_failuresinteger required

first_missing_connection_failure_atstring nullable required

last_missing_connection_failure_atstring nullable required

created_atstring required

updated_atstring required