Upsert Agent Trigger

Create or update the authenticated user’s trigger for an integration on an agent (Assignment in the Duvo UI). 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}

Upsert Agent Trigger

cURL

curl --request PUT \
  --url https://api.duvo.ai/v2/triggers/{agentId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "integration_slug": "<string>",
  "trigger_type": "<string>",
  "filter_config": {},
  "enabled": true
}
'

200

{
  "id": "<string>",
  "agent_id": "<string>",
  "user_id": "<string>",
  "integration_slug": "<string>",
  "trigger_type": "<string>",
  "filter_config": {},
  "integration_instance_id": "<string>",
  "enabled": true,
  "created_at": "<string>",
  "updated_at": "<string>"
}

Authorizations

Authorization · string · header · required

API key authentication. Get your API key from the Duvo dashboard.

Path Parameters

agentId · string<uuid> · required

The agent's unique identifier

Body

application/json

integration_slug · string · required

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

trigger_type · string · required

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

filter_config · object

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

Show child attributes

enabled · boolean · default: true

Whether the trigger is active. Defaults to true.

Response

200

application/json

Default Response

id · string · required

agent_id · string · required

user_id · string · required

integration_slug · string · required

trigger_type · string · required

filter_config · object · required

Show child attributes

integration_instance_id · string · required

enabled · boolean · required

created_at · string · required

updated_at · string · required