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

# List model resources

`GET /v1/rl/model-resources`

## Request

- Base URL: `https://api.together.ai`
- URL: `https://api.together.ai/v1/rl/model-resources`
- Auth: HTTP bearer

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_WAIT_TIMEOUT' | 'MODEL_RESOURCES_ERROR_CODE_PROVISIONING_FAILED' | 'MODEL_RESOURCES_ERROR_CODE_RESOURCE_UNAVAILABLE', 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
    - `status_details` RLModelResourcesStatusDetails, required: Details of a model resource's current status
      - `queue_position` integer: Estimated place of the resource in the queue: the number of older resources of the same GPU type still waiting for GPUs, plus one. Set only while the resource waits for GPUs.
    - `base_model` string, required: Base model the resource is provisioned for
    - `base_weights_ref` string: Model-registry model whose weights the resource trains in place of the base model's own, pinned to the revision resolved when the resource was created. Absent when the resource trains the base model's own weights.
    - `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.
      - `gpu_type` 'H100-80GB' | 'B200-SXM': GPU type selected for this resource.
    - `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
      - `adam` RLAdamConfig: Adam optimizer configuration
      - `muon` RLMuonConfig: Advanced configuration for the Muon optimizer.
        - `scaling_strategy` 'MUON_SCALING_STRATEGY_UNSPECIFIED' | 'MUON_SCALING_STRATEGY_MATCH_ADAM' | 'MUON_SCALING_STRATEGY_ORIGINAL'
    - `created_by` string, required: ID of the user who created the model resource
    - `inactive_timeout` integer, required: Seconds without activity after which the resource stops and its sessions expire. Every operation on any of its sessions restarts the count.
    - `expires_at` string, date-time: The earliest time the resource can stop for inactivity, which also expires its sessions. It is the resource's last activity plus `inactive_timeout` seconds. Becoming ready, a session start and every operation on any of its sessions count as activity, and the resource does not stop while an operation is running. An extend expiry call can move it later. It never moves earlier. Refreshed about once a minute. Set while the resource is ready.
  - `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.

## Changes

- **2026-10-28** `93438ddac711`: 2 info
  - added the optional property `data/items/expires_at` to the response with the `200` status
  - added the required property `data/items/inactive_timeout` to the response with the `200` status
- **2026-10-22** `bb5257b3173a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/together/apis/together-apis/changes/v1/rl/model-resources/get.md)

---

[API](https://skmtc.dev/together/apis/together-apis.md) - [All operations](https://skmtc.dev/together/apis/together-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/together/apis/together-apis/revisions/93438ddac711?raw)