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 minutemaxSteps(integer, nullable): Node activations of one runretentionDays(integer, nullable): Finished runs are deleted after this many daysrunTimeoutHours(integer, nullable): A run's deadline when its flow sets noneplatform(FlowsLimits, required)maxRunsPerMinute(integer, nullable): The breaker – starts by events or webhooks per flow and minutemaxSteps(integer, nullable): Node activations of one runretentionDays(integer, nullable): Finished runs are deleted after this many daysrunTimeoutHours(integer, nullable): A run's deadline when its flow sets none
version(integer, required): 0 until the first saveupdatedAt(string (date-time)): When the settings were saved last; absent before the first saveupdatedBy(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"