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): TriggersactivatedAt(string (date-time), required): Events before this time do not start the flowid(string, required): Trigger id in the definitionkind(string, required): Trigger kind (one ofevent,schedule,manual,webhook)auth(string): Authentication of a webhook (one oftoken,hmac)cron(string): Cron expression of a scheduleevent(string): Event type of an event triggerlastFiredAt(string (date-time)): Last start by this triggernextFireAt(string (date-time)): Next slot of a scheduletimezone(string): Time zone of a schedule
total(integer): Number of items
Example 200 answer:
{
"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
curl -X GET 'https://api.mbcom.cloud/api/flows/v1/flows/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/triggers' \
-H "Authorization: Bearer $ACCESS_TOKEN"