Skip to content
OpenRelay is in early access, and the /v1 API is stable. New capabilities ship in the changelog.
Clusters

Create a cluster

POST
/v1/orgs/{orgId}/clusters/create
AuthorizationBearer <token>

OpenRelay API key. Send it as Authorization: Bearer vl_….

In: header

Path Parameters

orgId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/orgs/string/clusters/create" \  -H "Content-Type: application/json" \  -d '{    "name": "vllm-serving",    "replicaCount": 2,    "gpuModelId": "rtx-4090",    "gpusPerReplica": 1,    "imageUrl": "vllm/vllm-openai:latest",    "containerPort": 8000,    "healthCheckPath": "/health"  }'
{
  "id": "string",
  "organizationId": "string",
  "name": "string",
  "status": "string",
  "gpuModelId": "string",
  "replicaCount": 0,
  "activeReplicas": 0,
  "endpointUrl": "string",
  "createdAt": "string"
}
{
  "error": "string",
  "code": "string"
}
{
  "error": "string",
  "code": "string"
}
{
  "error": "string",
  "code": "string"
}
{
  "error": "string",
  "code": "string"
}

Command line

The orl CLI wraps this endpoint:

orl clusters create --name <name>