---
title: "List triggers"
method: GET
path: "/api/v1/w/{wId}/triggers"
tags: ["Triggers"]
---

# List triggers

`GET /api/v1/w/{wId}/triggers`

List the agent triggers (scheduled runs and webhooks) configured across the workspace
identified by {wId}. Requires a workspace admin API key.

## Path parameters

- `wId` string, required

## Query parameters

- `kind` 'schedule' | 'webhook'
- `limit` integer
- `offset` integer

## Response `200`

The workspace's triggers

- object
  - `triggers` Trigger[]
    - `id` integer, required
    - `sId` string, required — Unique string identifier for the trigger
    - `name` string, required
    - `agentConfigurationId` string, required — sId of the agent this trigger runs
    - `kind` 'schedule' | 'webhook', required
    - `status` 'enabled' | 'disabled' | 'disabled_by_manager' | 'relocating' | 'downgraded', required
    - `createdAt` integer, required
    - `customPrompt` string, nullable
    - `naturalLanguageDescription` string, nullable
    - `executionMode` 'user_pool' | 'workspace_pool', required
    - `configuration` object, required — For `kind: schedule`, either a cron config (`cron`, `timezone`) or an interval config (`intervalDays`, `dayOfWeek`, `hour`, `minute`, `timezone`). For `kind: webhook`, `{ includePayload, event?, filter? }`.
    - `webhookSource` object, nullable — Present only for `kind: webhook` triggers
      - `name` string
      - `provider` string

## Other responses

- `400` — Bad Request. Invalid query parameters.
- `401` — Unauthorized. Invalid or missing authentication token.
- `403` — Forbidden. Requires a workspace admin API key.
- `404` — Workspace not found.

## Changes

- **2026-09-08** `c376d96c49a9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/dust-tt/apis/dust-api-documentation/changes/api/v1/w/:wId/triggers/get.md)

---

[API](https://skmtc.dev/dust-tt/apis/dust-api-documentation.md) · [All operations](https://skmtc.dev/dust-tt/apis/dust-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/dust-tt/apis/dust-api-documentation/revisions/c376d96c49a9?raw)