---
title: "List Optimization Modules"
method: GET
path: "/api/v1/optimization/modules"
tags: ["optimization"]
---

# List Optimization Modules

`GET /api/v1/optimization/modules`

Return the list of registered optimizable DSPy modules.

## Response `200`

Successful Response

- GEPAModuleInfo[]
  - `slug` string, required — Unique module identifier slug.
  - `label` string, required — Human-readable module label.
  - `description` string — Human-readable description of what this module optimizes.
  - `program_spec` string, required — DSPy program specification string.
  - `required_dataset_keys` string[], required — Dataset keys required for this module's examples.
  - `input_keys` string[] — Dataset keys used as DSPy inputs for this optimization target.
  - `output_keys` string[] — Dataset keys scored as DSPy outputs for this optimization target.
  - `runtime_module_name` string, nullable — Runtime module registry name when this target adapts a runtime module.
  - `signature_class_name` string, nullable — DSPy signature class optimized by this target, when available.
  - `optimization_target_kind` string — Optimization target kind such as custom, runtime-signature, or skill.
  - `offline_only` boolean — Whether this module can only be optimized through offline optimization endpoints.

## Other responses

- `401` — Authentication is required or the provided token is invalid.

## Changes

- **2026-06-12** `4a415e33915a` — 5 info
  - added the optional property `items/input_keys` to the response with the `200` status
  - added the optional property `items/optimization_target_kind` to the response with the `200` status
  - added the optional property `items/output_keys` to the response with the `200` status
  - added the optional property `items/runtime_module_name` to the response with the `200` status
  - …1 more
- **2026-05-23** `6178f925cdec` — 1 info
  - added the optional property `items/offline_only` to the response with the `200` status
- **2026-04-14** `3044e5c4a9da` — 1 info
  - added the optional property `items/description` to the response with the `200` status
- **2026-04-14** `08de6302fd74` — 1 info
  - endpoint added
- **2026-03-19** `78507b29ed8f` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/qredence/apis/fleet-rlm/changes/api/v1/optimization/modules/get.md)

---

[API](https://skmtc.dev/qredence/apis/fleet-rlm.md) · [All operations](https://skmtc.dev/qredence/apis/fleet-rlm/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/qredence/fleet-rlm/revisions/2b8dc83eb784/schema)