Sign in
RL

Get training session

Gets a training session by its ID and returns its details.

get/rl/training-sessions/{session_id}

Path parameters

session_idstring required

ID of the training session

Response

Training session details

idstring required

ID of the training session

display_namestring

Display name used to identify the training session

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

resume_from_checkpoint_idstring

Checkpoint ID this session was resumed from

created_atstring date-time required

Timestamp when the training session was created

updated_atstring date-time required

Timestamp when the training session was last updated

model_resources_idstring required

Model resource this session is attached to. The session runs on that resource's GPU pods.

base_modelstring required

Base model the session trains, taken from the model resource it is attached to

created_bystring required

ID of the user who created the training session

Example response

{
  "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",
  "policy_state": {
    "pending_publish": true
  }
}

Changes

Changed in 7 of the 15 revisions of this API.4215

  • f4885bc384241See the full diff
    • ○

      added the required property policy_state to the response with the 200 status

      response-required-property-added

  • 1fab430e87d65See the full diff
    • ○

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

      response-optional-property-added

    • ○

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

      response-optional-property-added

    • ○

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

      response-optional-property-added

    • ○

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

      response-optional-property-added

    • ○

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

      response-optional-property-added

  • 468edbdc879c1See the full diff
    • ○

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

      response-optional-property-added

  • f26a23fab8e02See the full diff
    • ○

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

      response-optional-property-added

    • ○

      added the required property base_model to the response with the 200 status

      response-required-property-added

  • ebd4756a41e42See the full diff
    • ○

      added the optional property display_name to the response with the 200 status

      response-optional-property-added

    • ○

      added the required property metadata to the response with the 200 status

      response-required-property-added

  • 9ccc57e5e4b911See the full diff
    • ▲

      the response property lora_config became optional for the status 200

      response-property-became-optional

    • ●

      removed the optional property 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

  • 0c4fdad77435314See the full diff
    • ▲

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

      response-property-type-changed

    • ▲

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

      response-property-type-changed

    • ▲

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

      response-property-type-changed

    • ●

      removed the optional property optimizer_config from the response with the 200 status

      response-optional-property-removed

    • ○

      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 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