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

```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 GET 'https://api.mbcom.cloud/api/flows/v1/settings' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
