---
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

---

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