---
title: "List training sessions"
method: GET
path: "/rl/training-sessions"
tags: ["RL"]
---

# List training sessions

`GET /rl/training-sessions`

Lists all training sessions.

## Query parameters

- `status` string[] — Status filters. When omitted, sessions in any status are returned.
- `limit` integer — Maximum number of sessions to return (1-100)
- `after` string — Cursor for pagination (ID of the last session from the previous page)
- `model_resources_id` string — Filter sessions by the model resource they are attached to
- `created_by` string — Filter sessions in the current project by the creator ID. Pass "me" to show sessions you created.

## Response `200`

List of training sessions

- RLTrainingSessionsListResponse — Paginated list of training sessions
  - `data` RLTrainingSession[] — List of training sessions
    - `id` string, required — ID of the training session
    - `display_name` string — Display name used to identify the training session
    - `metadata` RLTrainingSessionMetadata, required — Auxiliary metadata associated with a training session
      - `wandb` RLWandbMetadata — Details that associate a training session with a Weights & Biases run
        - `entity` string — Weights & Biases username or team that owns the project
        - `project` string — Weights & Biases project containing the run
        - `group` string — Weights & Biases group used to organize related runs
        - `run_name` string — Human-readable name of the Weights & Biases run
        - `run_id` string — Unique identifier assigned to the run by Weights & Biases
        - `url` string — HTTPS URL for the Weights & Biases run
    - `status` 'TRAINING_SESSION_STATUS_UNSPECIFIED' | 'TRAINING_SESSION_STATUS_CREATING' | 'TRAINING_SESSION_STATUS_RUNNING' | 'TRAINING_SESSION_STATUS_STOPPED' | 'TRAINING_SESSION_STATUS_STOPPING' | 'TRAINING_SESSION_STATUS_ERROR' | 'TRAINING_SESSION_STATUS_EXPIRED', required — Status of the training session
    - `error` RLTrainingSessionError — Structured detail for the training session's current error
      - `code` 'TRAINING_SESSION_ERROR_CODE_RESOURCE_UNAVAILABLE' | 'TRAINING_SESSION_ERROR_CODE_RESOURCE_AT_CAPACITY' | 'TRAINING_SESSION_ERROR_CODE_TIMED_OUT' | 'TRAINING_SESSION_ERROR_CODE_SESSION_FAILED', required — Finite machine-readable training session 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
    - `inference_checkpoints` RLInferenceCheckpoint[], required — List of saved inference checkpoints for this session
      - `id` string, required — Unique identifier for the checkpoint
      - `step` union, required — Training step at time of save
        - string
        - integer
      - `created_at` string, date-time, required — Timestamp when the checkpoint was created
      - `registration` RLInferenceCheckpointRegistration — Model registration details for an inference checkpoint
        - `model_name` string, required — Registered model name for downloading the checkpoint
        - `registered_at` string, date-time, required — Timestamp when the model was registered
        - `model_object_id` string — Together model registry object ID for the model checkpoint (e.g. `ml_...`), set on full-weight training sessions
        - `model_object_revision_id` string — Together model registry revision ID for the model checkpoint (e.g. `rv_...`)
        - `adapter_object_id` string — Together model registry object ID for the adapter checkpoint (e.g. `ml_...`), set on LoRA training sessions
        - `adapter_object_revision_id` string — Together model registry revision ID for the adapter checkpoint (e.g. `rv_...`)
    - `training_checkpoints` RLTrainingCheckpoint[], required — List of saved training checkpoints for this session
      - `id` string, required — Unique identifier for the checkpoint
      - `step` union, required — Training step at time of save
        - string
        - integer
      - `created_at` string, date-time, required — Timestamp when the checkpoint was created
      - `registration` RLTrainingCheckpointRegistration — Together model registry details for a training checkpoint
        - `object_id` string, required — Together model registry object ID for the training checkpoint artifact (e.g. `ml_...`)
        - `object_revision_id` string — Together model registry revision ID for the training checkpoint artifact (e.g. `rv_...`), empty when the upload reported no revision
    - `resume_from_checkpoint_id` string — Checkpoint ID this session was resumed from
    - `step` union, required — Current training step
      - string
      - integer
    - `created_at` string, date-time, required — Timestamp when the training session was created
    - `updated_at` string, date-time, required — Timestamp when the training session was last updated
    - `lora_config` RLLoraConfig — LoRA adapter configuration
      - `rank` integer — Rank of the LoRA adapter
      - `alpha` integer — Alpha of the LoRA adapter
      - `dropout` number — Dropout of the LoRA adapter
      - `seed` union — Random seed for initializing LoRA adapter weights. Ignored when LoRA is disabled or the session resumes from a checkpoint.
        - string
        - integer
      - `train_unembed` boolean — Whether to also train a LoRA adapter on the output head. Defaults to true.
    - `model_resources_id` string, required — Model resource this session is attached to. The session runs on that resource's GPU pods.
    - `base_model` string, required — Base model the session trains, taken from the model resource it is attached to
    - `created_by` string, required — ID of the user who created the training session
  - `meta` RLListMeta — 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/1fab430e87d6/schema)