## 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:

```json
{
  "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:

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

```bash
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}'
```
