---
title: "Discover managed RL recipes and availability"
method: GET
path: "/v1/rl-recipes"
tags: ["RL"]
---

# Discover managed RL recipes and availability

`GET /v1/rl-recipes`

## Request

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

## Response `200`

Success

- object
  - `recipes` RLRecipeDescriptor[], required
    - `held_out_measures` string, required
    - `id` string, required
    - `version` string, required
    - `environment_id` string, required
    - `name` string, required
    - `model` string, required
    - `model_revision` string, required
    - `taskset` string, required
    - `modes` string[], required
    - `available` boolean, required
    - `unavailable_reason` string
    - `defaults` RLRecipeDefaults, required
      - `evaluation_tasks` integer, required
      - `training_steps` integer, required
      - `max_cost_usd` number: Deprecated compatibility field. Customer spending limits are not enforced.
      - `seed` integer, required
    - `limits` RLRecipeLimits, required
      - `comparison_tasks_min` integer, required
      - `evaluation_tasks_min` integer, required
      - `evaluation_tasks_max` integer, required
      - `training_steps_min` integer, required
      - `training_steps_max` integer, required
    - `outputs` RLRecipeOutput[], required
      - `name` string, required
      - `description` string, 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`: 1 breaking, 2 info
  - the response property `recipes/items/defaults/max_cost_usd` became optional for the status `200`
  - the `max_cost_usd` response's property default value `5` was removed for the status `200`
  - response property `recipes/items/defaults/max_cost_usd` deprecated
- **2026-10-01** `544fef290a54`: 3 info
  - the response property `recipes/items/defaults/max_cost_usd` became required for the status `200`
  - the `max_cost_usd` response's property default value `5` was added for the status `200`
  - response property `recipes/items/defaults/max_cost_usd` reactivated
- **2026-09-27** `dcc58d93c2cb`: 1 breaking, 2 info
  - the response property `recipes/items/defaults/max_cost_usd` became optional for the status `200`
  - the `max_cost_usd` response's property default value `5` was removed for the status `200`
  - response property `recipes/items/defaults/max_cost_usd` deprecated
- **2026-09-27** `90c4cb8514af`: 3 info
  - the response property `recipes/items/defaults/max_cost_usd` became required for the status `200`
  - the `max_cost_usd` response's property default value `5` was added for the status `200`
  - response property `recipes/items/defaults/max_cost_usd` reactivated
- …earlier changes not shown

[Operation history](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/changes/v1/rl-recipes/get.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)