Create Ray and Spark clusters with explicit workspace ownership, cluster shape strings, and optional image or snapshot overrides. Cluster APIs are exposed under /clusters.

Supported Create Operations

  • POST /clusters/ray
  • POST /clusters/spark
Both creation DTOs inherit the same base fields:
  • workspaceId
  • shape
  • name
  • allowCidr
  • image
  • snapshotId
The shape field is validated in one of these formats:
  • <workers>x<gpusPerWorker>x<gpuType> such as 4x2xH100
  • <gpusOnHead>x<gpuType> such as 2xH100

Read And Stop Operations

  • GET /clusters
  • GET /clusters/{id}
  • PUT /clusters/{id}/stop

API Pages