---
title: "Deploy Cluster"
method: POST
path: "/api/v1/slurm-clusters/{team_id}/deploy"
tags: ["slurm-clusters"]
---

# Deploy Cluster

`POST /api/v1/slurm-clusters/{team_id}/deploy`

## Request

- Base URL: `https://api.primeintellect.ai`
- URL: `https://api.primeintellect.ai/api/v1/slurm-clusters/{team_id}/deploy`
- Auth: HTTP bearer

Deploy a Slurm cluster onto one of the team's dedicated clusters.

Team-admin gated like resize and add/remove member. The cluster must
belong to `team_id` and have self-service enabled (checked by the
service, which also pins the new cluster to this team). Node planning
and claiming run before this returns, so "not enough nodes" or a port
conflict is an immediate error; the Helm install continues in the
background and the returned cluster starts out PENDING.

## Path parameters

- `team_id` string, required

## Request body

- DeployClusterRequest: Deploy a Slurm cluster onto one of the team's dedicated clusters. The customer-facing subset of the admin deploy payload (`SlurmClusterSpec`). Unknown fields, including the admin-only knobs, are rejected rather than ignored.
  - `primeClusterId` string, required
  - `slurmClusterName` string, required
  - `numNodes` integer, required
  - `members` DeployClusterMemberRequest[], required
    - `username` string, required
    - `sshAuthorizedKeys` string[], required
    - `sudo` boolean
    - `linkedUserId` string, nullable
  - `gpusPerNode` integer, nullable
  - `homeSize` string, nullable
  - `tailscaleAuthKey` string, nullable
  - `tailscaleCredentialId` string, nullable
  - `containersEnabled` boolean

## Response `201`

Successful Response

- DeployClusterResponse
  - `id` string, required
  - `primeClusterId` string, required
  - `status` 'PENDING' | 'DEPLOYING' | 'RUNNING' | 'TERMINATING' | 'COMPLETED' | 'FAILED' | 'STOPPED' | 'UNKNOWN' | 'TOMBSTONED', required
  - `createdAt` string, date-time, required

## Other responses

- `401`: Authorization failed
- `422`: Invalid request data

## Changes

> 49 revisions in range; 1 not diffed.

- **2026-10-30** `f14057c40c69`: 1 info
  - added the new optional request property `tailscaleCredentialId`
- **2026-10-23** `499e1b37ffa3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/primeintellect/apis/pi-api/changes/api/v1/slurm-clusters/:team_id/deploy/post.md)

---

[API](https://skmtc.dev/primeintellect/apis/pi-api.md) - [All operations](https://skmtc.dev/primeintellect/apis/pi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/primeintellect/apis/pi-api/revisions/7f032a9306b0?raw)