ConnectCloud Developers

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:

{
  "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"

View as Markdown · Interactive reference · OpenAPI