---
title: "Updates the configuration of a simple flow. Changing the blueprint once the flow has items returns 409 Conflict."
method: PATCH
path: "/flow/simple/{flowId}"
tags: ["SimpleFlow"]
---

# Updates the configuration of a simple flow. Changing the blueprint once the flow has items returns 409 Conflict.

`PATCH /flow/simple/{flowId}`

## Path parameters

- `flowId` string, required

## Request body

- UpdateSimpleFlowConfigEndpointInput
  - `audienceId` string, nullable — Optional audience ID. When provided, the flow will only serve items to users in this audience. Set to null to remove the audience restriction.
  - `blueprint` IFlowRapidBlueprint
    - `_t` 'ClassifyBlueprint', required
    - `title` string, required
    - `categories` ClassifyBlueprintCategory[], required
      - `label` string, required
      - `value` string, required
  - `maxResponses` integer — The number of accepted responses per image after which the image stops collecting. At least MinResponses.
  - `minResponses` integer — The minimum average number of accepted responses per image for an item ending by time-to-live or stop to count as completed. At least 1.
  - `featureFlags` FeatureFlag[] — Feature flags to enable for this flow.
    - `key` string, required
    - `value` string, required
  - `targetResponseCount` integer, nullable — Target average response count per completed item. Set to null to disable PID control.
  - `pidProportionalGain` number, double — PID proportional gain.
  - `pidIntegralGain` number, double — PID integral gain.
  - `pidDerivativeGain` number, double — PID derivative gain.
  - `pidOutputOffset` number, double — Constant offset added to the PID output before clamping, shifting the controller's operating point.
  - `pidMinSessionsPerMinute` integer — Minimum sessions per minute the PID can set.
  - `pidMaxSessionsPerMinute` integer — Maximum sessions per minute the PID can set.
  - `pidBatchMode` 'Total' | 'PerBatch' | 'PerBatchTimeWeighted'

## Response `204`

No Content

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden

## Changes

- **2026-09-23** `229a5989cf68` — 1 warning
  - removed the request property `defaultTimeToLiveSeconds`
- **2026-09-20** `71d1f82c030f` — 2 warning, 2 info
  - removed the request property `maxDatapointsPerItem`
  - removed the request property `responsesRequired`
  - added the new optional request property `maxResponses`
  - added the new optional request property `minResponses`
- **2026-09-19** `0ed57e29d31d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/rapidata/apis/rapidata-api/changes/flow/simple/:flowId/patch.md)

---

[API](https://skmtc.dev/rapidata/apis/rapidata-api.md) · [All operations](https://skmtc.dev/rapidata/apis/rapidata-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rapidata/apis/rapidata-api/revisions/0cbca856ba0f?raw)