---
title: "List model resources"
method: GET
path: "/rl/model-resources"
tags: ["RL"]
---

# List model resources

`GET /rl/model-resources`

Lists the caller's model resources.

## Query parameters

- `status` string[] — Status filters. When omitted, resources in any status are returned.
- `limit` integer — Maximum number of resources to return (1-100)
- `after` string — Cursor for pagination
- `created_by` string — Filter resources in the current project by the creator ID. Pass "me" to show resources you created.

## Response `200`

List of model resources

- RLModelResourcesListResponse — Paginated list of model resources
  - `data` RLModelResources[], required — List of model resources
    - `id` string, required — Unique identifier for the model resource
    - `status` 'MODEL_RESOURCES_STATUS_PENDING' | 'MODEL_RESOURCES_STATUS_CREATING' | 'MODEL_RESOURCES_STATUS_READY' | 'MODEL_RESOURCES_STATUS_ERROR' | 'MODEL_RESOURCES_STATUS_STOPPED' | 'MODEL_RESOURCES_STATUS_STOPPING', required — Lifecycle status of a model resource
    - `error` RLModelResourcesError — Structured detail for the model resource's current error
      - `code` 'MODEL_RESOURCES_ERROR_CODE_CAPACITY_UNAVAILABLE' | 'MODEL_RESOURCES_ERROR_CODE_PROVISIONING_FAILED', required — Finite machine-readable model resource lifecycle error code
      - `message` string, required — User-safe human-readable detail for the current status
      - `occurred_at` string, date-time, required — Timestamp when this error was reported
    - `base_model` string, required — Base model the resource is provisioned for
    - `compute_config` RLComputeConfig, required — Compute layout for a model resource
      - `num_generator_replicas` integer, required — Number of generator replicas. 0 means the resource runs the trainer only, with no generator.
    - `lora_enabled` boolean, required — Whether the resource hosts LoRA sessions or a full-weight session
    - `created_at` string, date-time, required — Timestamp when the model resource was created
    - `updated_at` string, date-time, required — Timestamp when the model resource was last updated
    - `optimizer_config` RLOptimizerConfig, required — Optimizer configuration
      - `adamw` RLAdamWOptimizerConfig — AdamW optimizer configuration
      - `muon` RLMuonOptimizerConfig — Advanced configuration for the Muon optimizer.
        - `scaling_strategy` 'MUON_SCALING_STRATEGY_UNSPECIFIED' | 'MUON_SCALING_STRATEGY_MATCH_ADAMW' | 'MUON_SCALING_STRATEGY_ORIGINAL'
    - `created_by` string, required — ID of the user who created the model resource
  - `meta` RLListMeta, required — Pagination metadata for list responses
    - `limit` integer — Maximum number of items returned per page
    - `has_more` boolean — Whether more items exist beyond this page
    - `next_cursor` string — Cursor to use as the 'after' parameter for the next page. Empty when has_more is false.

## Other responses

- `default` — An unexpected error response.

---

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