Triggers

List Triggers

Changed on

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)
post/v1/triggers/list

Request

  • Base URL: https://api.mixpeek.com
  • URL: https://api.mixpeek.com/v1/triggers/list
  • Auth: HTTP bearer and API key in header X-Namespace

Request body

action_type'cluster' | 'taxonomy_enrichment' | 'batch_rerun' | 'collection_trigger' | 'retriever_execution' | 'alert_evaluation'

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
  • collection_trigger: Re-process a collection from its sources
  • retriever_execution: Execute a saved retriever with fixed inputs on a schedule (a canary / search probe), optionally judged against acceptance criteria (latency ceilings, minimum results, per-document LLM verdicts)
  • alert_evaluation: Evaluate a retriever alert in the trigger's namespace on the trigger's schedule. The periodic alert sweep then skips that alert in that namespace, so it runs on this schedule only
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_idstring nullable

Filter by resource ID (cluster_id or taxonomy_id)

offsetinteger

Pagination offset

limitinteger

Results per page

sort_bystring

Field to sort by

directionstring

Sort direction (asc/desc)

Response

Successful Response

totalinteger required

Total number of triggers

offsetinteger required

Current offset

limitinteger required

Current limit

Changes

  • 61a175e8eb9aRevision changes
    • warning

      removed the optional property from the response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • 38e0822db900Revision changes
    • warning

      added the new alert_evaluation enum value to the // response property for the response status

    • info

      added the new alert_evaluation enum value to the request property /