RL

Get training session

Changed on

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

get/v1/rl/training-sessions/{session_id}

Request

  • Base URL
    https://api.together.ai
  • URL
    https://api.together.ai/v1/rl/training-sessions/{session_id}
  • Auth
    HTTP bearer

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

ID of the model resource used by this training session.

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": {
          "id": "ml_abc123",
          "revision_id": "rv_def456"
        },
        "adapter": {
          "id": "ml_abc123",
          "revision_id": "rv_def456"
        }
      }
    }
  ],
  "training_checkpoints": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2026-01-02T00:00:00Z",
      "registration": {
        "id": "ml_abc123",
        "revision_id": "rv_def456"
      }
    }
  ],
  "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.5-4B",
  "created_by": "user_123",
  "policy_state": {
    "pending_publish": true
  }
}

Changes