## List the triggers of the published version with their state (tenant:flows:read|write|admin; scoped flows the owning module's view)

`GET /api/flows/v1/flows/{id}/triggers`

Module: Flows · operationId: `listFlowTriggers` · Tag: Flows · Auth: access token (`Authorization: Bearer <accessToken>`)

A schedule shows its next and last fire. A webhook's token and secret are never shown here.

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string (uuid) | yes |  |

### Responses

- **200** Triggers, by id (`application/json`)
- **401** Missing, invalid or expired token (no body).
- **403** The token lacks the permission or has no active tenant (`forbidden`). Also: `person_required` (a service-account key on personal flows or the task inbox), `live_test_forbidden`, `forbidden_grant`, `starter_excluded`. (`application/json`)
- **404** The record does not exist in the token's tenant – or it belongs to a scope the caller may not view (a scoped flow stays hidden). (`application/json`)
- **503** A dependency is not available: `scope_unavailable` (the module that owns a flow's scope did not answer who may see and manage it – nothing of a scoped flow is shown or changed), `identity_unavailable` (HR), `ai_unavailable`, `ai_failed`. (`application/json`)

Fields of the 200 answer:

- `items` (array of Trigger, required): Triggers
  - `activatedAt` (string (date-time), required): Events before this time do not start the flow
  - `id` (string, required): Trigger id in the definition
  - `kind` (string, required): Trigger kind (one of `event`, `schedule`, `manual`, `webhook`)
  - `auth` (string): Authentication of a webhook (one of `token`, `hmac`)
  - `cron` (string): Cron expression of a schedule
  - `event` (string): Event type of an event trigger
  - `lastFiredAt` (string (date-time)): Last start by this trigger
  - `nextFireAt` (string (date-time)): Next slot of a schedule
  - `timezone` (string): Time zone of a schedule
- `total` (integer): Number of items

Example 200 answer:

```json
{
  "items": [
    {
      "activatedAt": "2026-10-25T14:05:00Z",
      "cron": "0 8 * * 1",
      "id": "montags",
      "kind": "schedule",
      "lastFiredAt": "2026-11-16T07:00:01Z",
      "nextFireAt": "2026-11-23T07:00:00Z",
      "timezone": "Europe/Berlin"
    }
  ],
  "total": 1
}
```

### Example request

```bash
curl -X GET 'https://api.mbcom.cloud/api/flows/v1/flows/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/triggers' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
