---
title: "List Triggers"
method: GET
path: "/v1/triggers/"
tags: ["v1", "protected", "triggers"]
---

# List Triggers

`GET /v1/triggers/`

List triggers with optional filtering.

Returns a list of triggers that match the specified criteria. Supports
filtering by agent ID, trigger type, and active status.

Access Control:
    Returns all triggers within the current user's workspace (workspace isolation).
    All users in the same workspace can see all workspace triggers.

Args:
    secret_manager: Injected secret manager (to resolve credential presence)
    agent_id: Optional agent ID filter
    trigger_type: Optional trigger type filter
    active_only: Whether to only return active triggers
    limit: Maximum number of triggers to return
    user_context: Authentication context
    trigger_service: Injected trigger service

Returns:
    List of triggers matching the criteria

## Query parameters

- `agent_id` string, uuid, nullable — Filter by agent ID
- `trigger_type` string, nullable — Filter by trigger type (cron, webhook)
- `active_only` boolean — Only return active triggers
- `limit` integer — Maximum number of triggers to return

## Response `200`

Successful Response

- TriggerResponse[]
  - `agent_id` string, uuid, required
  - `allowed_methods` string[], nullable
  - `conditions` object, required
  - `consecutive_failures` integer, required
  - `created_at` string, required
  - `created_by` string, required
  - `cron_expression` string, nullable
  - `data_extractor` string, nullable
  - `description` string, required
  - `event_types` string[]
  - `failure_threshold` integer, required
  - `has_channel_credentials` boolean
  - `id` string, uuid, required
  - `is_active` boolean, required
  - `last_execution_at` string, nullable
  - `name` string, required
  - `next_run_time` string, nullable
  - `task_parameters` object, required
  - `timezone` string, nullable
  - `trigger_type` string, required
  - `updated_at` string, required
  - `validation_rules` object, nullable
  - `webhook_config` object, nullable
  - `webhook_id` string, nullable
  - `webhook_type` string, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-07-08** `8940d7f77282` — 4 breaking
  - the `items/created_at` response's property type/format changed from `string`/`date-time` to `string`/`` for status `200`
  - the `items/last_execution_at/anyOf[subschema #1]/` response's property type/format changed from `string`/`date-time` to `string`/`` for status `200`
  - the `items/next_run_time/anyOf[subschema #1]/` response's property type/format changed from `string`/`date-time` to `string`/`` for status `200`
  - the `items/updated_at` response's property type/format changed from `string`/`date-time` to `string`/`` for status `200`
- **2026-04-29** `e1a530c0a2d5` — 1 info
  - added the optional property `items/data_extractor` to the response with the `200` status
- **2026-03-30** `e9c153221160` — 1 warning
  - removed the optional property `items/data_extractor` from the response with the `200` status

[Change history](https://skmtc.dev/agentarea/apis/agentarea-api/changes/v1/triggers/get.md)

---

[API](https://skmtc.dev/agentarea/apis/agentarea-api.md) · [All operations](https://skmtc.dev/agentarea/apis/agentarea-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agentarea/agentarea-api/revisions/d29cbb0c8cc9/schema)