---
title: "Changes to Create a routing rule"
method: POST
path: "/v2/routing-rules"
---

# Changes to Create a routing rule

`POST /v2/routing-rules`

> Every recorded change to this endpoint, newest first.
> 261 revisions in range; 73 not diffed.

## Timeline

Changed in 14 of 261 revisions.

- **2026-08-24** `addad33219df` — 17 breaking, 18 info
- **2026-08-21** `1586760a252f` — 12 breaking, 14 warning, 12 info
- **2026-08-21** `4fdc24e562eb` — 17 breaking, 18 info
- **2026-08-20** `be3fe58ce389` — 12 breaking, 14 warning, 12 info
- **2026-08-17** `f54fa34db0f4` — 17 breaking, 18 info
- **2026-08-17** `ed68e8b009d7` — 12 breaking, 14 warning, 12 info
- **2026-08-17** `d46bd23ae34c` — 17 breaking, 18 info
- **2026-08-17** `f459ad9381eb` — 12 breaking, 14 warning, 12 info
- **2026-08-14** `deb8d376faee` — 17 breaking, 18 info
- **2026-07-17** `2f27caf6888c` — 1 warning, 1 info
- **2026-07-16** `bee257c5b248` — 1 breaking, 1 info
- **2026-07-16** `801f61a5a056` — 1 warning, 1 info
- **2026-07-16** `42d5d2062527` — 1 breaking, 1 info
- **2026-07-14** `cbedd768fa93` — 1 warning, 1 info

## Changes

- **2026-08-24** `addad33219df` — 17 breaking, 18 info
  - the request property `models_config/models` became not nullable
  - removed the enum value `fallback` of the request property `models_config/mode`
  - removed the enum value `latency_based` of the request property `models_config/mode`
  - removed the enum value `round_robin` of the request property `models_config/mode`
  - removed the enum value `weighted` of the request property `models_config/mode`
  - the `priority` request property format changed from `int64` to `int32`
  - the response property `expression/cel` became optional for the status `201`
  - the response property `models_config/mode` became optional for the status `201`
  - the response property `models_config/models` became optional for the status `201`
  - the response property `models_config/models/items/model` became optional for the status `201`
  - the `description` response property's maxLength was unset from `2048` for the response status `201`
  - the `display_name` response property's maxLength was unset from `256` for the response status `201`
  - the `expression/cel` response property's maxLength was unset from `2000` for the response status `201`
  - the `models_config/models` response property's minItems was decreased from `1` to `0` for the response status `201`
  - the `display_name` response property's minLength was decreased from `1` to `0` for the response status `201`
  - the `expression/cel` response property's minLength was decreased from `1` to `0` for the response status `201`
  - the `models_config/models/items/model` response property's minLength was decreased from `1` to `0` for the response status `201`
  - added the new optional request property `cache_config`
  - added the new optional request property `expression/config`
  - added the new optional request property `plugins`
  - the request property `expression/cel` became optional
  - the request property `models_config/mode` became optional
  - the request property `models_config/models` became optional
  - the request property `models_config/models/items/model` became optional
  - the `display_name` request property's minLength was decreased from `1` to `0`
  - the `models_config/models/items/model` request property's minLength was decreased from `1` to `0`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `409`
  - added the optional property `cache_config` to the response with the `201` status
  - the response property `description` became required for the status `201`
  - removed the `fallback` enum value from the `models_config/mode` response property for the response status `201`
  - removed the `latency_based` enum value from the `models_config/mode` response property for the response status `201`
  - removed the `round_robin` enum value from the `models_config/mode` response property for the response status `201`
  - removed the `weighted` enum value from the `models_config/mode` response property for the response status `201`
  - added the required property `plugins` to the response with the `201` status
- **2026-08-21** `1586760a252f` — 12 breaking, 14 warning, 12 info
  - request property `models_config/mode` was restricted to a list of enum values
  - the request property `expression/cel` became required
  - the request property `models_config/mode` became required
  - the request property `models_config/models` became required
  - the request property `models_config/models/items/model` became required
  - the `models_config/models` request property's minItems was increased to `1`
  - the `display_name` request property's minLength was increased from `0` to `1`
  - the `models_config/models/items/model` request property's minLength was increased from `0` to `1`
  - the response property `models_config/models` became nullable for the status `201`
  - the response property `description` became optional for the status `201`
  - the `priority` response's property format changed from `int32` to `int64` for status `201`
  - removed the required property `plugins` from the response with the `201` status
  - the `description` request property's maxLength was set to `2048`
  - the `display_name` request property's maxLength was set to `256`
  - the `expression/cel` request property's maxLength was set to `2000`
  - the `models_config/models/items/weight` request property's max was set to `1.00`
  - the `models_config/models/items/weight` request property's min was set to `0.00`
  - the `priority` request property's min was set to `0.00`
  - removed the request property `cache_config`
  - removed the request property `expression/config`
  - removed the request property `plugins`
  - removed the optional property `cache_config` from the response with the `201` status
  - added the new `fallback` enum value to the `models_config/mode` response property for the response status `201`
  - added the new `latency_based` enum value to the `models_config/mode` response property for the response status `201`
  - added the new `round_robin` enum value to the `models_config/mode` response property for the response status `201`
  - added the new `weighted` enum value to the `models_config/mode` response property for the response status `201`
  - the request property `models_config/models` became nullable
  - added the new `fallback` enum value to the request property `models_config/mode`
  - added the new `latency_based` enum value to the request property `models_config/mode`
  - added the new `round_robin` enum value to the request property `models_config/mode`
  - added the new `weighted` enum value to the request property `models_config/mode`
  - the `priority` request property format was generalized from `int32` to `int64`
  - added the non-success response with the status `400`
  - added the non-success response with the status `409`
  - the response property `expression/cel` became required for the status `201`
  - the response property `models_config/mode` became required for the status `201`
  - the response property `models_config/models` became required for the status `201`
  - the response property `models_config/models/items/model` became required for the status `201`
- **2026-08-21** `4fdc24e562eb` — 17 breaking, 18 info
  - the request property `models_config/models` became not nullable
  - removed the enum value `fallback` of the request property `models_config/mode`
  - removed the enum value `latency_based` of the request property `models_config/mode`
  - removed the enum value `round_robin` of the request property `models_config/mode`
  - removed the enum value `weighted` of the request property `models_config/mode`
  - the `priority` request property format changed from `int64` to `int32`
  - the response property `expression/cel` became optional for the status `201`
  - the response property `models_config/mode` became optional for the status `201`
  - the response property `models_config/models` became optional for the status `201`
  - the response property `models_config/models/items/model` became optional for the status `201`
  - the `description` response property's maxLength was unset from `2048` for the response status `201`
  - the `display_name` response property's maxLength was unset from `256` for the response status `201`
  - the `expression/cel` response property's maxLength was unset from `2000` for the response status `201`
  - the `models_config/models` response property's minItems was decreased from `1` to `0` for the response status `201`
  - the `display_name` response property's minLength was decreased from `1` to `0` for the response status `201`
  - the `expression/cel` response property's minLength was decreased from `1` to `0` for the response status `201`
  - the `models_config/models/items/model` response property's minLength was decreased from `1` to `0` for the response status `201`
  - added the new optional request property `cache_config`
  - added the new optional request property `expression/config`
  - added the new optional request property `plugins`
  - the request property `expression/cel` became optional
  - the request property `models_config/mode` became optional
  - the request property `models_config/models` became optional
  - the request property `models_config/models/items/model` became optional
  - the `display_name` request property's minLength was decreased from `1` to `0`
  - the `models_config/models/items/model` request property's minLength was decreased from `1` to `0`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `409`
  - added the optional property `cache_config` to the response with the `201` status
  - the response property `description` became required for the status `201`
  - removed the `fallback` enum value from the `models_config/mode` response property for the response status `201`
  - removed the `latency_based` enum value from the `models_config/mode` response property for the response status `201`
  - removed the `round_robin` enum value from the `models_config/mode` response property for the response status `201`
  - removed the `weighted` enum value from the `models_config/mode` response property for the response status `201`
  - added the required property `plugins` to the response with the `201` status
- **2026-08-20** `be3fe58ce389` — 12 breaking, 14 warning, 12 info
  - request property `models_config/mode` was restricted to a list of enum values
  - the request property `expression/cel` became required
  - the request property `models_config/mode` became required
  - the request property `models_config/models` became required
  - the request property `models_config/models/items/model` became required
  - the `models_config/models` request property's minItems was increased to `1`
  - the `display_name` request property's minLength was increased from `0` to `1`
  - the `models_config/models/items/model` request property's minLength was increased from `0` to `1`
  - the response property `models_config/models` became nullable for the status `201`
  - the response property `description` became optional for the status `201`
  - the `priority` response's property format changed from `int32` to `int64` for status `201`
  - removed the required property `plugins` from the response with the `201` status
  - the `description` request property's maxLength was set to `2048`
  - the `display_name` request property's maxLength was set to `256`
  - the `expression/cel` request property's maxLength was set to `2000`
  - the `models_config/models/items/weight` request property's max was set to `1.00`
  - the `models_config/models/items/weight` request property's min was set to `0.00`
  - the `priority` request property's min was set to `0.00`
  - removed the request property `cache_config`
  - removed the request property `expression/config`
  - removed the request property `plugins`
  - removed the optional property `cache_config` from the response with the `201` status
  - added the new `fallback` enum value to the `models_config/mode` response property for the response status `201`
  - added the new `latency_based` enum value to the `models_config/mode` response property for the response status `201`
  - added the new `round_robin` enum value to the `models_config/mode` response property for the response status `201`
  - added the new `weighted` enum value to the `models_config/mode` response property for the response status `201`
  - the request property `models_config/models` became nullable
  - added the new `fallback` enum value to the request property `models_config/mode`
  - added the new `latency_based` enum value to the request property `models_config/mode`
  - added the new `round_robin` enum value to the request property `models_config/mode`
  - added the new `weighted` enum value to the request property `models_config/mode`
  - the `priority` request property format was generalized from `int32` to `int64`
  - added the non-success response with the status `400`
  - added the non-success response with the status `409`
  - the response property `expression/cel` became required for the status `201`
  - the response property `models_config/mode` became required for the status `201`
  - the response property `models_config/models` became required for the status `201`
  - the response property `models_config/models/items/model` became required for the status `201`
- **2026-08-17** `f54fa34db0f4` — 17 breaking, 18 info
  - the request property `models_config/models` became not nullable
  - removed the enum value `fallback` of the request property `models_config/mode`
  - removed the enum value `latency_based` of the request property `models_config/mode`
  - removed the enum value `round_robin` of the request property `models_config/mode`
  - removed the enum value `weighted` of the request property `models_config/mode`
  - the `priority` request property format changed from `int64` to `int32`
  - the response property `expression/cel` became optional for the status `201`
  - the response property `models_config/mode` became optional for the status `201`
  - the response property `models_config/models` became optional for the status `201`
  - the response property `models_config/models/items/model` became optional for the status `201`
  - the `description` response property's maxLength was unset from `2048` for the response status `201`
  - the `display_name` response property's maxLength was unset from `256` for the response status `201`
  - the `expression/cel` response property's maxLength was unset from `2000` for the response status `201`
  - the `models_config/models` response property's minItems was decreased from `1` to `0` for the response status `201`
  - the `display_name` response property's minLength was decreased from `1` to `0` for the response status `201`
  - the `expression/cel` response property's minLength was decreased from `1` to `0` for the response status `201`
  - the `models_config/models/items/model` response property's minLength was decreased from `1` to `0` for the response status `201`
  - added the new optional request property `cache_config`
  - added the new optional request property `expression/config`
  - added the new optional request property `plugins`
  - the request property `expression/cel` became optional
  - the request property `models_config/mode` became optional
  - the request property `models_config/models` became optional
  - the request property `models_config/models/items/model` became optional
  - the `display_name` request property's minLength was decreased from `1` to `0`
  - the `models_config/models/items/model` request property's minLength was decreased from `1` to `0`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `409`
  - added the optional property `cache_config` to the response with the `201` status
  - the response property `description` became required for the status `201`
  - removed the `fallback` enum value from the `models_config/mode` response property for the response status `201`
  - removed the `latency_based` enum value from the `models_config/mode` response property for the response status `201`
  - removed the `round_robin` enum value from the `models_config/mode` response property for the response status `201`
  - removed the `weighted` enum value from the `models_config/mode` response property for the response status `201`
  - added the required property `plugins` to the response with the `201` status
- **2026-08-17** `ed68e8b009d7` — 12 breaking, 14 warning, 12 info
  - request property `models_config/mode` was restricted to a list of enum values
  - the request property `expression/cel` became required
  - the request property `models_config/mode` became required
  - the request property `models_config/models` became required
  - the request property `models_config/models/items/model` became required
  - the `models_config/models` request property's minItems was increased to `1`
  - the `display_name` request property's minLength was increased from `0` to `1`
  - the `models_config/models/items/model` request property's minLength was increased from `0` to `1`
  - the response property `models_config/models` became nullable for the status `201`
  - the response property `description` became optional for the status `201`
  - the `priority` response's property format changed from `int32` to `int64` for status `201`
  - removed the required property `plugins` from the response with the `201` status
  - the `description` request property's maxLength was set to `2048`
  - the `display_name` request property's maxLength was set to `256`
  - the `expression/cel` request property's maxLength was set to `2000`
  - the `models_config/models/items/weight` request property's max was set to `1.00`
  - the `models_config/models/items/weight` request property's min was set to `0.00`
  - the `priority` request property's min was set to `0.00`
  - removed the request property `cache_config`
  - removed the request property `expression/config`
  - removed the request property `plugins`
  - removed the optional property `cache_config` from the response with the `201` status
  - added the new `fallback` enum value to the `models_config/mode` response property for the response status `201`
  - added the new `latency_based` enum value to the `models_config/mode` response property for the response status `201`
  - added the new `round_robin` enum value to the `models_config/mode` response property for the response status `201`
  - added the new `weighted` enum value to the `models_config/mode` response property for the response status `201`
  - the request property `models_config/models` became nullable
  - added the new `fallback` enum value to the request property `models_config/mode`
  - added the new `latency_based` enum value to the request property `models_config/mode`
  - added the new `round_robin` enum value to the request property `models_config/mode`
  - added the new `weighted` enum value to the request property `models_config/mode`
  - the `priority` request property format was generalized from `int32` to `int64`
  - added the non-success response with the status `400`
  - added the non-success response with the status `409`
  - the response property `expression/cel` became required for the status `201`
  - the response property `models_config/mode` became required for the status `201`
  - the response property `models_config/models` became required for the status `201`
  - the response property `models_config/models/items/model` became required for the status `201`
- **2026-08-17** `d46bd23ae34c` — 17 breaking, 18 info
  - the request property `models_config/models` became not nullable
  - removed the enum value `fallback` of the request property `models_config/mode`
  - removed the enum value `latency_based` of the request property `models_config/mode`
  - removed the enum value `round_robin` of the request property `models_config/mode`
  - removed the enum value `weighted` of the request property `models_config/mode`
  - the `priority` request property format changed from `int64` to `int32`
  - the response property `expression/cel` became optional for the status `201`
  - the response property `models_config/mode` became optional for the status `201`
  - the response property `models_config/models` became optional for the status `201`
  - the response property `models_config/models/items/model` became optional for the status `201`
  - the `description` response property's maxLength was unset from `2048` for the response status `201`
  - the `display_name` response property's maxLength was unset from `256` for the response status `201`
  - the `expression/cel` response property's maxLength was unset from `2000` for the response status `201`
  - the `models_config/models` response property's minItems was decreased from `1` to `0` for the response status `201`
  - the `display_name` response property's minLength was decreased from `1` to `0` for the response status `201`
  - the `expression/cel` response property's minLength was decreased from `1` to `0` for the response status `201`
  - the `models_config/models/items/model` response property's minLength was decreased from `1` to `0` for the response status `201`
  - added the new optional request property `cache_config`
  - added the new optional request property `expression/config`
  - added the new optional request property `plugins`
  - the request property `expression/cel` became optional
  - the request property `models_config/mode` became optional
  - the request property `models_config/models` became optional
  - the request property `models_config/models/items/model` became optional
  - the `display_name` request property's minLength was decreased from `1` to `0`
  - the `models_config/models/items/model` request property's minLength was decreased from `1` to `0`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `409`
  - added the optional property `cache_config` to the response with the `201` status
  - the response property `description` became required for the status `201`
  - removed the `fallback` enum value from the `models_config/mode` response property for the response status `201`
  - removed the `latency_based` enum value from the `models_config/mode` response property for the response status `201`
  - removed the `round_robin` enum value from the `models_config/mode` response property for the response status `201`
  - removed the `weighted` enum value from the `models_config/mode` response property for the response status `201`
  - added the required property `plugins` to the response with the `201` status
- **2026-08-17** `f459ad9381eb` — 12 breaking, 14 warning, 12 info
  - request property `models_config/mode` was restricted to a list of enum values
  - the request property `expression/cel` became required
  - the request property `models_config/mode` became required
  - the request property `models_config/models` became required
  - the request property `models_config/models/items/model` became required
  - the `models_config/models` request property's minItems was increased to `1`
  - the `display_name` request property's minLength was increased from `0` to `1`
  - the `models_config/models/items/model` request property's minLength was increased from `0` to `1`
  - the response property `models_config/models` became nullable for the status `201`
  - the response property `description` became optional for the status `201`
  - the `priority` response's property format changed from `int32` to `int64` for status `201`
  - removed the required property `plugins` from the response with the `201` status
  - the `description` request property's maxLength was set to `2048`
  - the `display_name` request property's maxLength was set to `256`
  - the `expression/cel` request property's maxLength was set to `2000`
  - the `models_config/models/items/weight` request property's max was set to `1.00`
  - the `models_config/models/items/weight` request property's min was set to `0.00`
  - the `priority` request property's min was set to `0.00`
  - removed the request property `cache_config`
  - removed the request property `expression/config`
  - removed the request property `plugins`
  - removed the optional property `cache_config` from the response with the `201` status
  - added the new `fallback` enum value to the `models_config/mode` response property for the response status `201`
  - added the new `latency_based` enum value to the `models_config/mode` response property for the response status `201`
  - added the new `round_robin` enum value to the `models_config/mode` response property for the response status `201`
  - added the new `weighted` enum value to the `models_config/mode` response property for the response status `201`
  - the request property `models_config/models` became nullable
  - added the new `fallback` enum value to the request property `models_config/mode`
  - added the new `latency_based` enum value to the request property `models_config/mode`
  - added the new `round_robin` enum value to the request property `models_config/mode`
  - added the new `weighted` enum value to the request property `models_config/mode`
  - the `priority` request property format was generalized from `int32` to `int64`
  - added the non-success response with the status `400`
  - added the non-success response with the status `409`
  - the response property `expression/cel` became required for the status `201`
  - the response property `models_config/mode` became required for the status `201`
  - the response property `models_config/models` became required for the status `201`
  - the response property `models_config/models/items/model` became required for the status `201`
- **2026-08-14** `deb8d376faee` — 17 breaking, 18 info
  - the request property `models_config/models` became not nullable
  - removed the enum value `fallback` of the request property `models_config/mode`
  - removed the enum value `latency_based` of the request property `models_config/mode`
  - removed the enum value `round_robin` of the request property `models_config/mode`
  - removed the enum value `weighted` of the request property `models_config/mode`
  - the `priority` request property format changed from `int64` to `int32`
  - the response property `expression/cel` became optional for the status `201`
  - the response property `models_config/mode` became optional for the status `201`
  - the response property `models_config/models` became optional for the status `201`
  - the response property `models_config/models/items/model` became optional for the status `201`
  - the `description` response property's maxLength was unset from `2048` for the response status `201`
  - the `display_name` response property's maxLength was unset from `256` for the response status `201`
  - the `expression/cel` response property's maxLength was unset from `2000` for the response status `201`
  - the `models_config/models` response property's minItems was decreased from `1` to `0` for the response status `201`
  - the `display_name` response property's minLength was decreased from `1` to `0` for the response status `201`
  - the `expression/cel` response property's minLength was decreased from `1` to `0` for the response status `201`
  - the `models_config/models/items/model` response property's minLength was decreased from `1` to `0` for the response status `201`
  - added the new optional request property `cache_config`
  - added the new optional request property `expression/config`
  - added the new optional request property `plugins`
  - the request property `expression/cel` became optional
  - the request property `models_config/mode` became optional
  - the request property `models_config/models` became optional
  - the request property `models_config/models/items/model` became optional
  - the `display_name` request property's minLength was decreased from `1` to `0`
  - the `models_config/models/items/model` request property's minLength was decreased from `1` to `0`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `409`
  - added the optional property `cache_config` to the response with the `201` status
  - the response property `description` became required for the status `201`
  - removed the `fallback` enum value from the `models_config/mode` response property for the response status `201`
  - removed the `latency_based` enum value from the `models_config/mode` response property for the response status `201`
  - removed the `round_robin` enum value from the `models_config/mode` response property for the response status `201`
  - removed the `weighted` enum value from the `models_config/mode` response property for the response status `201`
  - added the required property `plugins` to the response with the `201` status
- **2026-07-17** `2f27caf6888c` — 1 warning, 1 info
  - added the new `latency_based` enum value to the `models_config/mode` response property for the response status `201`
  - added the new `latency_based` enum value to the request property `models_config/mode`
- **2026-07-16** `bee257c5b248` — 1 breaking, 1 info
  - removed the enum value `latency_based` of the request property `models_config/mode`
  - removed the `latency_based` enum value from the `models_config/mode` response property for the response status `201`
- **2026-07-16** `801f61a5a056` — 1 warning, 1 info
  - added the new `latency_based` enum value to the `models_config/mode` response property for the response status `201`
  - added the new `latency_based` enum value to the request property `models_config/mode`
- **2026-07-16** `42d5d2062527` — 1 breaking, 1 info
  - removed the enum value `latency_based` of the request property `models_config/mode`
  - removed the `latency_based` enum value from the `models_config/mode` response property for the response status `201`
- **2026-07-14** `cbedd768fa93` — 1 warning, 1 info
  - added the new `latency_based` enum value to the `models_config/mode` response property for the response status `201`
  - added the new `latency_based` enum value to the request property `models_config/mode`

---

[Operation](https://skmtc.dev/orq-ai/apis/orq-ai-api/docs/v2/routing-rules/post.md) · [API](https://skmtc.dev/orq-ai/apis/orq-ai-api.md) · [Page](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/routing-rules/post)
