---
title: "Upsert Agent Trigger"
method: PUT
path: "/v2/triggers/{agentId}"
tags: ["Triggers"]
---

# Upsert Agent Trigger

`PUT /v2/triggers/{agentId}`

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.

## Path parameters

- `agentId` string, uuid, required

## Request body

- object
  - `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 — Whether the trigger is active. Defaults to true.

## Response `200`

Default Response

- object
  - `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
  - `auto_disabled_at` string, nullable, required
  - `auto_disabled_reason` string, nullable, required
  - `consecutive_missing_connection_failures` integer, required
  - `first_missing_connection_failure_at` string, nullable, required
  - `last_missing_connection_failure_at` string, nullable, required
  - `created_at` string, required
  - `updated_at` string, required

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response
- `409` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/duvo/apis/duvo-public-api.md) · [All operations](https://skmtc.net/duvo/apis/duvo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/duvo/duvo-public-api/revisions/dafcf3d868a9/schema)