---
title: "Launch the reviewed managed RL recipe"
method: POST
path: "/v1/rl-runs"
tags: ["RL"]
---

# Launch the reviewed managed RL recipe

`POST /v1/rl-runs`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/rl-runs`
- Auth: HTTP bearer

Uses ordinary workload admission, billing and tenant ownership. 202 confirms acceptance. Reuse the exact body and Idempotency-Key after an uncertain response. A changed configuration or runtime returns 409 review_changed. After an earlier uncertain submission, keep the original key and check existing runs before starting another attempt. 503 rl_unavailable means new managed launches are paused or the runtime is unqualified. A completed run does not by itself establish improved model quality.

## Headers

- `Idempotency-Key` string, required

## Request body

- RLRunRequest
  - `recipe_id` 'reasoning-gym-leg-counting'
  - `recipe_version` '1.0.0'
  - `mode` 'evaluate' | 'train'
  - `evaluation_tasks` integer
  - `training_steps` integer
  - `max_cost_usd` number: Deprecated compatibility field. Customer spending limits are not enforced.
  - `seed` integer
  - `include_traces` boolean: Opt in to prompt, model response and verifier text in live task events.
  - `review_token` string, required

## Response `202`

Success

- SubmitResult
  - `id` string, required
  - `workload_id` string, required
  - `status` string, required
  - `revision` integer, required

## Other responses

- `default`: Error. The JSON error and message fields are stable. Additional fields may provide details. Authentication, rate limits, and transient failures apply to all operations.

## Changes

- **2026-10-01** `ba84c74aeec8`: 2 info
  - the `max_cost_usd` request property default value `5` was removed
  - request property `max_cost_usd` deprecated
- **2026-10-01** `544fef290a54`: 2 warning, 2 info
  - the `max_cost_usd` request property's max was set to `100.00`
  - the `max_cost_usd` request property's min was set to `1.00`
  - the `max_cost_usd` request property default value `5` was added
  - request property `max_cost_usd` reactivated
- **2026-09-27** `dcc58d93c2cb`: 2 info
  - the `max_cost_usd` request property default value `5` was removed
  - request property `max_cost_usd` deprecated
- **2026-09-27** `90c4cb8514af`: 2 warning, 2 info
  - the `max_cost_usd` request property's max was set to `100.00`
  - the `max_cost_usd` request property's min was set to `1.00`
  - the `max_cost_usd` request property default value `5` was added
  - request property `max_cost_usd` reactivated
- **2026-09-26** `fddd7d91a5a5`: 2 info
  - the `max_cost_usd` request property default value `5` was removed
  - request property `max_cost_usd` deprecated

[Operation history](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/changes/v1/rl-runs/post.md)

---

[API](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api.md) - [All operations](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/revisions/a59210899d95?raw)