---
title: "Get Tcli Cluster"
method: GET
path: "/api/v1/tcli/clusters/{cluster_profile}"
tags: ["tcli"]
---

# Get Tcli Cluster

`GET /api/v1/tcli/clusters/{cluster_profile}`

## Path parameters

- `cluster_profile` string, required

## Response `200`

Successful Response

- TcliClusterStatus
  - `cluster_name` string, required
  - `cluster_provider_name` string, required
  - `node_type` string, required
  - `scheduler_namespace` string, required
  - `scheduler_cluster` string, required
  - `waiters_configmap` string, required
  - `collected_at` string, required
  - `summary` TcliClusterSummary, required
    - `total` integer, required
    - `ready` integer, required
    - `unhealthy` integer, required
    - `busy` integer, required
    - `reserved` integer, required
    - `queued` integer, required
    - `gpu_total` integer, required
    - `gpu_used` integer, required
    - `gpu_free` integer, required
    - `gpu_nodes_total` integer, required
    - `gpu_nodes_idle` integer, required
    - `gpu_nodes_partial` integer, required
    - `gpu_nodes_full` integer, required
  - `jobs` TcliJobSummary[], required
    - `model_service_id` string, required
    - `model_name` string, required
    - `k8s_model_label` string, required
    - `namespace` string, required
    - `cluster_name` string, nullable, required
    - `base_url` string, required
    - `base_url_healthy` boolean, required
    - `service_status` 'ready' | 'unhealthy' | 'busy', required
    - `service_pool` 'shared' | 'reserved', required
    - `service_xid` string, nullable, required
    - `no_active_xid_since` integer, nullable, required
    - `ttl` integer, nullable, required
    - `num_consecutive_successful_hello_samples` integer, nullable, required
    - `lora_slots` integer, required
    - `lora_in_use` integer, required
    - `lora_holders` string[], required
    - `user` string, nullable, required
    - `deployed_by` string, nullable, required
    - `deployed_at` string, nullable, required
    - `eta_minutes_remaining` number, nullable, required
    - `eta_at` string, nullable, required
    - `total_steps` number, nullable, required
    - `current_steps` number, nullable, required
    - `last_step_time` string, nullable, required
    - `metric_values` object, required
    - `pods` TcliPodSummary[], required
      - `name` string, required
      - `node` string, nullable, required
      - `phase` string, nullable, required
      - `cpu_requested_millis` integer, required
      - `memory_requested_bytes` integer, required
    - `nodes` string[], required
    - `xm_job` TcliXmJobRef, required
      - `job_name` string, required
      - `experiment` string, nullable, required
      - `status` 'running' | 'pending' | 'succeeded' | 'failed' | 'unknown', required
      - `age_seconds` integer, nullable, required
      - `created_at` string, nullable, required
      - `started_at` string, nullable, required
      - `completed_at` string, nullable, required
      - `node_names` string[], required
  - `nodes` TcliNodeSummary[], required
    - `name` string, required
    - `ready` boolean, required
    - `unschedulable` boolean, required
    - `gpu_allocatable` integer, required
    - `gpu_requested` integer, required
    - `gpu_free` integer, required
    - `occupants` TcliOccupant[], required
      - `name` string, required
      - `namespace` string, required
      - `kind` 'tcli_endpoint' | 'xm_runner' | 'other', required
      - `gpu_requested` integer, required
      - `phase` string, nullable, required
      - `model_service_id` string, nullable, required
      - `model_name` string, nullable, required
      - `job_or_service_name` string, nullable, required
      - `cluster_name` string, nullable, required
      - `service_status` 'ready' | 'unhealthy' | 'busy', nullable, required
      - `service_pool` 'shared' | 'reserved', nullable, required
      - `xid` string, nullable, required
      - `xm_job_name` string, nullable, required
      - `experiment` string, nullable, required
    - `node_state` 'free' | 'claimed' | 'occupied', required
    - `cluster_names` string[], required
    - `taints` string[], required
    - `taint_user` string, nullable, required
    - `has_tcli_endpoint` boolean, required
    - `is_idle` boolean, required
  - `waiters` TcliWaiterSummary[], required
    - `xid` string, required
    - `model` string, required
    - `job_kind` string, required
    - `job_name` string, nullable, required
    - `user` string, nullable, required
    - `eta_minutes_remaining` number, nullable, required
    - `eta_at` string, nullable, required
    - `total_steps` number, nullable, required
    - `current_steps` number, nullable, required
    - `last_step_time` string, nullable, required
    - `allocated_at` string, nullable, required
    - `queued_seconds` number, nullable, required
    - `status` string, nullable, required
    - `queued_at` string, required
    - `heartbeat` string, required
    - `waiting_seconds` integer, required
  - `metrics` TcliMetricPoint[], required
    - `bucket_start` string, required
    - `all_available_nodes` number, required
    - `all_free_nodes` number, required
    - `all_busy_nodes` number, required
    - `all_unavailable_nodes` number, required
    - `production_queue_length` number, required
    - `completion_mean_minutes` number, required
    - `completion_stddev_minutes` number, required
    - `completed_jobs` integer, required
    - `wait_mean_minutes` number, required
    - `wait_stddev_minutes` number, required
    - `waited_jobs` integer, required
  - `completed_jobs` TcliCompletedJob[], required
    - `xid` string, required
    - `job_name` string, required
    - `user` string, nullable, required
    - `experiment` string, nullable, required
    - `mode` 'tcli' | 'tinker' | 'unknown', required
    - `started_at` string, nullable, required
    - `finished_at` string, required
    - `runtime_minutes` number, required
    - `node_names` string[], required
    - `status` string, required
  - `completion_events` TcliJobCompletionEvent[], required
    - `xid` string, required
    - `job_name` string, required
    - `finished_at` string, required
    - `runtime_minutes` number, required
  - `wait_events` TcliJobWaitEvent[], required
    - `xid` string, required
    - `job_name` string, nullable, required
    - `finished_at` string, required
    - `wait_minutes` number, required
  - `backend_completion_totals` TcliBackendCompletionTotalsPoint[], required
    - `time` string, required
    - `tcli_completed` integer, required
    - `tinker_completed` integer, required

## Changes

- **2026-09-24** `4087cc7a74aa` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/trajectory/apis/trajectory-api/changes/api/v1/tcli/clusters/:cluster_profile/get.md)

---

[API](https://skmtc.dev/trajectory/apis/trajectory-api.md) · [All operations](https://skmtc.dev/trajectory/apis/trajectory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trajectory/apis/trajectory-api/revisions/8c9311580b72?raw)