RL

List training sessions

Changed on

Lists all training sessions.

get/v1/rl/training-sessions

Request

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

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": {
              "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
      }
    }
  ],
  "meta": {
    "limit": 20,
    "has_more": true,
    "next_cursor": "123e4567-e89b-12d3-a456-426614174000"
  }
}

Changes