ConnectCloud Developers

The tenant's limits of flows and the platform's (tenant:flows:read|write|admin)

GET /api/flows/v1/settings

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

A tenant may lower four limits below the platform's: the breaker (maxRunsPerMinute – a flow started more often by events or webhooks pauses), a run's deadline when its flow sets none (runTimeoutHours), the node activations of one run (maxSteps) and how long finished runs are kept (retentionDays). null is the platform's value (platform). Changes apply to new runs and checks within 30 seconds.

Responses

  • 200 The settings (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)

Fields of the 200 answer:

  • maxRunsPerMinute (integer, nullable): The breaker – starts by events or webhooks per flow and minute
  • maxSteps (integer, nullable): Node activations of one run
  • retentionDays (integer, nullable): Finished runs are deleted after this many days
  • runTimeoutHours (integer, nullable): A run's deadline when its flow sets none
  • platform (FlowsLimits, required)
    • maxRunsPerMinute (integer, nullable): The breaker – starts by events or webhooks per flow and minute
    • maxSteps (integer, nullable): Node activations of one run
    • retentionDays (integer, nullable): Finished runs are deleted after this many days
    • runTimeoutHours (integer, nullable): A run's deadline when its flow sets none
  • version (integer, required): 0 until the first save
  • updatedAt (string (date-time)): When the settings were saved last; absent before the first save
  • updatedBy (string): E-mail of who saved the settings last; absent before the first save

Example 200 answer:

{
  "maxRunsPerMinute": 30,
  "maxSteps": 500,
  "platform": {
    "maxRunsPerMinute": 60,
    "maxSteps": 1000,
    "retentionDays": 90,
    "runTimeoutHours": 720
  },
  "retentionDays": 30,
  "runTimeoutHours": null,
  "updatedAt": "2026-10-02T11:30:00Z",
  "updatedBy": "thomas.pfeiffer@muster-it.example",
  "version": 3
}

Example request

curl -X GET 'https://api.mbcom.cloud/api/flows/v1/settings' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

View as Markdown · Interactive reference · OpenAPI