ConnectCloud Developers

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 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): 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); field names the first invalid field, details.fields every 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 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 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}'

View as Markdown · Interactive reference · OpenAPI