RL

List training sessions

Lists all training sessions.

get/rl/training-sessions

Query parameters

statusstring[]

Status filters. When omitted, sessions in any status are returned.

limitinteger

Maximum number of sessions to return (1-100)

afterstring

Cursor for pagination (ID of the last session from the previous page)

model_resources_idstring

Filter sessions by the model resource they are attached to

created_bystring

Filter sessions in the current project by the creator ID. Pass "me" to show sessions you created.

Response

List of training sessions

Example response

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "display_name": "gsm8k-experiment-2",
      "metadata": {
        "wandb": {
          "entity": "example-org",
          "project": "grpo-gsm8k",
          "group": "gsm8k-35b-sweep",
          "run_name": "exp2-thinking-4k-ctx",
          "run_id": "abc123",
          "url": "https://wandb.ai/example-org/example-project/runs/run-id"
        }
      },
      "error": {
        "message": "The session could not start because the selected resource has no available capacity.",
        "occurred_at": "2026-01-02T00:00:05Z"
      },
      "inference_checkpoints": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "created_at": "2026-01-02T00:00:00Z",
          "registration": {
            "model_name": "username/Meta-Llama-3-8B-rl-step-42-20260216",
            "registered_at": "2026-01-02T00:00:00Z"
          }
        }
      ],
      "training_checkpoints": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "created_at": "2026-01-02T00:00:00Z"
        }
      ],
      "resume_from_checkpoint_id": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2026-01-02T00:00:00Z",
      "updated_at": "2026-01-02T00:00:05Z",
      "lora_config": {
        "rank": 32,
        "alpha": 64,
        "train_unembed": true
      },
      "model_resources_id": "123e4567-e89b-12d3-a456-426614174000",
      "base_model": "Qwen/Qwen3-0.6B",
      "created_by": "user_123"
    }
  ],
  "meta": {
    "limit": 20,
    "has_more": true,
    "next_cursor": "123e4567-e89b-12d3-a456-426614174000"
  }
}

Changes

Changed in 6 of the 14 revisions of this API.13217

    • added the optional property data/items/inference_checkpoints/items/registration/adapter_object_id to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/inference_checkpoints/items/registration/adapter_object_revision_id to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/inference_checkpoints/items/registration/model_object_id to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/inference_checkpoints/items/registration/model_object_revision_id to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/training_checkpoints/items/registration to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/lora_config/train_unembed to the response with the 200 status

      response-optional-property-added

    • added the optional property data/items/lora_config/seed to the response with the 200 status

      response-optional-property-added

    • added the required property data/items/base_model to the response with the 200 status

      response-required-property-added

    • added the optional property data/items/display_name to the response with the 200 status

      response-optional-property-added

    • added the required property data/items/metadata to the response with the 200 status

      response-required-property-added

  • 9ccc57e5e4b911See the full diff
    • the response property data/items/lora_config became optional for the status 200

      response-property-became-optional

    • removed the optional property data/items/lora_config/enable from the response with the 200 status

      response-optional-property-removed

    This revision also has 11 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 0c4fdad774351217See the full diff
    • for the query request parameter status, default value TRAINING_SESSION_STATUS_UNSPECIFIED was removed

      request-parameter-default-value-removed

    • removed the enum value TRAINING_SESSION_STATUS_CREATING from the query request parameter status

      request-parameter-enum-value-removed

    • removed the enum value TRAINING_SESSION_STATUS_ERROR from the query request parameter status

      request-parameter-enum-value-removed

    • removed the enum value TRAINING_SESSION_STATUS_EXPIRED from the query request parameter status

      request-parameter-enum-value-removed

    • removed the enum value TRAINING_SESSION_STATUS_RUNNING from the query request parameter status

      request-parameter-enum-value-removed

    • removed the enum value TRAINING_SESSION_STATUS_STOPPED from the query request parameter status

      request-parameter-enum-value-removed

    • removed the enum value TRAINING_SESSION_STATUS_STOPPING from the query request parameter status

      request-parameter-enum-value-removed

    • removed the enum value TRAINING_SESSION_STATUS_UNSPECIFIED from the query request parameter status

      request-parameter-enum-value-removed

    • the data/items/lora_config/alpha response's property type/format changed from integer/int64 to integer/ for status 200

      response-property-type-changed

    • the data/items/lora_config/dropout response's property type/format changed from number/float to number/ for status 200

      response-property-type-changed

    • the data/items/lora_config/rank response's property type/format changed from integer/int64 to integer/ for status 200

      response-property-type-changed

    • the meta/limit response's property type/format changed from integer/int32 to integer/ for status 200

      response-property-type-changed

    • removed the optional property data/items/optimizer_config from the response with the 200 status

      response-optional-property-removed

    • added the new optional query request parameter created_by

      new-optional-request-parameter

    • for the query request parameter limit, the type/format was generalized from integer/int32 to integer/

      request-parameter-type-generalized

    • for the query request parameter status, the type/format was generalized from string/ to array/

      request-parameter-type-generalized

    • the alpha response's property default value changed from 16 to 64 for the status 200

      response-property-default-value-changed

    • the dropout response's property default value changed from 0.05 to 0.0 for the status 200

      response-property-default-value-changed

    • the rank response's property default value changed from 8 to 32 for the status 200

      response-property-default-value-changed

    • added the required property data/items/created_by to the response with the 200 status

      response-required-property-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog