Replace the tenant's limits of flows (tenant:flows:admin)
PUT /api/flows/v1/settings
Module: Flows · operationId: updateFlowsSettings · Tag: Flows · Auth: access token (Authorization: Bearer <accessToken>)
Every limit is null (the platform's) or between 1 and the platform's value. Send the version read (0 before the first save); a stale one answers 409 version_conflict.
Request body
application/json (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 noneversion(integer, required): The settings version read (0 before the first save)
Example:
{
"maxRunsPerMinute": 30,
"maxSteps": 500,
"retentionDays": 30,
"runTimeoutHours": null,
"version": 3
}
Responses
- 200 The saved settings (
application/json) - 400 Invalid input (
invalid);fieldnames the first invalid field,details.fieldsevery one. (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) - 409 The state does not allow it: version_conflict (reload), no_changes, archived, key_taken, flow_disabled, flow_tripped, task_closed, run_finished. (
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 PUT 'https://api.mbcom.cloud/api/flows/v1/settings' \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
--data '{"maxRunsPerMinute":30,"maxSteps":500,"retentionDays":30,"runTimeoutHours":null,"version":3}'