---
title: "List Triggers"
method: POST
path: "/v1/triggers/list"
tags: ["Triggers"]
---

# List Triggers

`POST /v1/triggers/list`

List triggers with filters and pagination.

    **Filters:**
    - `action_type`: Filter by action type (cluster, taxonomy_enrichment)
    - `trigger_type`: Filter by trigger type (cron, interval, event, conditional)
    - `status`: Filter by status (active, paused, disabled, failed)
    - `resource_id`: Filter by resource ID (cluster_id or taxonomy_id)

## Request body

- SharedTriggersModelsListTriggersRequest — Request to list triggers with filters.
  - `action_type` 'cluster' | 'taxonomy_enrichment' | 'batch_rerun' | 'collection_trigger' — Type of action to execute when trigger fires. Supported action types: - **cluster**: Execute clustering on a cluster definition - **taxonomy_enrichment**: Apply taxonomy enrichment to a collection - **batch_rerun**: Re-execute a completed/failed batch
  - `trigger_type` 'cron' | 'interval' | 'event' | 'conditional' — Type of trigger schedule. Supported trigger types: - **cron**: Schedule-based execution using cron expressions - **interval**: Fixed-interval execution - **event**: Event-driven execution - **conditional**: Condition-based execution
  - `status` 'active' | 'paused' | 'disabled' | 'failed' — Status of a trigger.
  - `resource_id` string, nullable — Filter by resource ID (cluster_id or taxonomy_id)
  - `offset` integer — Pagination offset
  - `limit` integer — Results per page
  - `sort_by` string — Field to sort by
  - `direction` string — Sort direction (asc/desc)

## Response `200`

Successful Response

- SharedTriggersModelsListTriggersResponse — Response for list triggers request.
  - `results` SharedTriggersModelsTriggerModel[], required — List of triggers
    - `trigger_id` string — Unique trigger identifier
    - `namespace_id` string, required — Namespace ID
    - `internal_id` string, required — Organization internal ID
    - `action_type` 'cluster' | 'taxonomy_enrichment' | 'batch_rerun' | 'collection_trigger', required — Type of action to execute when trigger fires. Supported action types: - **cluster**: Execute clustering on a cluster definition - **taxonomy_enrichment**: Apply taxonomy enrichment to a collection - **batch_rerun**: Re-execute a completed/failed batch
    - `action_config` object, required — Action-specific configuration
    - `trigger_type` 'cron' | 'interval' | 'event' | 'conditional', required — Type of trigger schedule. Supported trigger types: - **cron**: Schedule-based execution using cron expressions - **interval**: Fixed-interval execution - **event**: Event-driven execution - **conditional**: Condition-based execution
    - `schedule_config` object, required — Schedule-specific configuration
    - `status` 'active' | 'paused' | 'disabled' | 'failed' — Status of a trigger.
    - `last_triggered_at` string, date-time, nullable — Last time trigger fired
    - `last_execution_task_id` string, nullable — Task ID of last execution
    - `next_scheduled_at` string, date-time, nullable — Next scheduled execution time
    - `execution_count` integer — Total successful executions
    - `consecutive_failures` integer — Consecutive failures
    - `last_execution_status` string, nullable — Status of last execution
    - `last_execution_error` string, nullable — Error from last execution (if failed)
    - `event_counter` integer — Current event count since last trigger
    - `last_cooldown_at` string, date-time, nullable — Last time cooldown was applied
    - `baseline_snapshot` object, nullable — Baseline snapshot for drift measurement (captured after successful execution)
    - `last_drift_measurement` object, nullable — Result of most recent drift measurement check
    - `last_volume_measurement` object, nullable — Result of most recent volume (document count) condition check
    - `last_condition_check_at` string, date-time, nullable — When condition was last evaluated
    - `description` string, nullable — Human-readable description
    - `created_at` string, date-time — Creation timestamp
    - `updated_at` string, date-time — Last update timestamp
    - `created_by` string, nullable — User who created trigger
  - `total` integer, required — Total number of triggers
  - `offset` integer, required — Current offset
  - `limit` integer, required — Current limit

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

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