---
title: "List triggers"
method: GET
path: "/v1/projects/{project_id}/triggers"
tags: ["Triggers"]
---

# List triggers

`GET /v1/projects/{project_id}/triggers`

## Request

- Base URL: `https://api.naturali.ai`
- URL: `https://api.naturali.ai/v1/projects/{project_id}/triggers`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.naturali.ai/authorize`, token URL `https://api.naturali.ai/token`, scopes: `mcp:access`)

Lists triggers. Filter by project, starter type, or target type.

## Query parameters

- `type` 'manual' | 'webhook' | 'schedule' | 'event'
- `target_type` 'orchestration' | 'agent' | 'tool' | 'eval'
- `limit` integer
- `offset` integer

## Response `200`

A list of triggers

- object
  - `data` Trigger[], required
    - `id` string
    - `project_id` string
    - `name` string
    - `description` string, nullable
    - `type` 'manual' | 'webhook' | 'schedule' | 'event'
    - `target_type` 'orchestration' | 'agent' | 'tool' | 'eval'
    - `target_id` string: Public ID of the target resource (orchestration, agent, tool, or eval)
    - `action` string, nullable: Tool targets only — the action for mcp tools
    - `input` object, nullable: Static input, shallow-merged under fire-time input. For `eval` targets the effective input may carry `agent_version` and `baseline_run_id`, which are passed to the queued run.
    - `cron` string, nullable: 5-field cron expression (UTC). Present only for schedule triggers
    - `event_pattern` string, nullable: Internal-event subscription pattern. Present only for event triggers: `*`, `prefix.*`, or an exact event name
    - `active` boolean
    - `policy_id` string, nullable: Optional boundary policy that further restricts firings
    - `next_fire_at` string, date-time, nullable: Read-only, schedule triggers only. Server-computed next fire time
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/naturali/apis/naturali-ai-api.md) · [All operations](https://skmtc.dev/naturali/apis/naturali-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/naturali/apis/naturali-ai-api/revisions/e4905b78f422?raw)