---
title: "Updates the configuration of a ranking flow."
method: PATCH
path: "/flow/ranking/{flowId}/config"
tags: ["RankingFlow"]
---

# Updates the configuration of a ranking flow.

`PATCH /flow/ranking/{flowId}/config`

## Path parameters

- `flowId` string, required

## Request body

- UpdateConfigEndpointInput
  - `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.
  - `criteria` string — The ranking criteria used to compare items.
  - `startingElo` integer — Initial Elo rating for new items.
  - `minResponses` integer — Minimum number of responses per comparison.
  - `maxResponses` integer — Maximum number of responses per comparison.
  - `serveResponses` integer, nullable — Number of accepted responses per rapid at which to stop serving. Set to null to remove. Must be less than or equal to MaxResponses when both are set.
  - `serveToResponseRatio` number, double, nullable — Ratio of concurrent serves to max responses. Set to null to remove the limit.
  - `serveTimeoutSeconds` integer, nullable — Time in seconds a user has to submit an answer after loading the task. Set to null to use the global default.
  - `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

---

[API](https://skmtc.net/rapidata/apis/rapidata-api.md) · [All operations](https://skmtc.net/rapidata/apis/rapidata-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rapidata/rapidata-api/revisions/e42ec51c7b88/schema)