---
title: "Discover Triggers"
method: POST
path: "/triggers/discover"
tags: ["Triggers"]
---

# Discover Triggers

`POST /triggers/discover`

## Request body

- TriggerDiscoveryQuery — Request body for ``POST /triggers/discover``.
  - `use_cases` string[], required
  - `provider` string
  - `limit_alternatives` integer

## Response `200`

Successful Response

- TriggerCapabilitiesResult
  - `capabilities` TriggerCapability[]
    - `use_case` string, required
    - `integration` string, nullable
    - `event` DiscoveredTriggerEvent
      - `type` 'trigger'
      - `provider` string
      - `integration` string, required
      - `event_key` string, required
      - `trigger_config` object, nullable
      - `payload` object, nullable
      - `description` string, nullable
      - `provider_event` string, required
    - `alternatives` DiscoveredTriggerAlternative[]
      - `integration` string, required
      - `event_key` string, required
      - `description` string, nullable
      - `provider_event` string, required
    - `connection` TriggerCapabilityConnection
      - `state` 'ready' | 'needs_auth' | 'needs_input', required
      - `id` string, uuid, nullable
      - `slug` string, nullable
    - `note` string, nullable
  - `connections` TriggerConnectionRequirement[]
    - `integration` string, required
    - `state` 'ready' | 'needs_auth' | 'needs_input', required
    - `id` string, uuid, nullable
    - `slug` string, nullable
    - `connect` TriggerConnectAffordance
      - `endpoint` string
      - `body` object, required
  - `guidance` TriggerDiscoveryGuidance
    - `plan_steps` string[]
    - `pitfalls` string[]
  - `ready` boolean
  - `notes` string[]

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/agenta-ai/apis/agenta-api.md) · [All operations](https://skmtc.net/agenta-ai/apis/agenta-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agenta-ai/agenta-api/versions/ea6421d829f1/schema)