Skip to main content
PUT
/
v2
/
triggers
/
{agentId}
Upsert Agent Trigger
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
}
'
{
  "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>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.duvo.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.

enabled
boolean
default:true

Whether the trigger is active. Defaults to true.

Response

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
integration_instance_id
string
required
enabled
boolean
required
created_at
string
required
updated_at
string
required