Server Variant

Server variants define different instances of a server, each with its own configuration and capabilities. By default, Metorial picks the best variant automatically, but you can specify a variant if needed.

Server Variant object

Attributes

object

String

id

String

The unique identifier for this server variant

status

Enum

The current status of the server variant

identifier

String

A unique string identifier for the server variant

server

Object

current_version

ObjectNullable

source

Object

The source type and configuration for this server variant

created_at

Date

Timestamp when the server variant was created

{
  "object": "server.server_variant",
  "status": "active",
  "server": {
    "object": "server#preview",
    "type": "public"
  },
  "current_version": {
    "object": "server.server_version",
    "oauth": {
      "status": "disabled"
    },
    "source": {
      "type": "docker",
      "docker": {}
    },
    "schema": {},
    "server": {
      "object": "server#preview",
      "type": "public"
    }
  },
  "source": {
    "type": "docker",
    "docker": {}
  }
}

List server variants

Retrieve all variants for a given server

URL Parameters

server_id

String

The unique identifier for the server

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional
GEThttp://api.metorial.com/servers/:server_id/variants
curl -X GET "https://api.metorial.com/servers/ser_Rm4Mnheq2bfEPhBhP7SY/variants" \
  -H "Authorization: Bearer metorial_sk_..."

Get server variant

Retrieve details for a specific server variant

URL Parameters

server_id

String

The unique identifier for the server

server_variant_id

String

The unique identifier for the server_variant

GEThttp://api.metorial.com/servers/:server_id/variants/:server_variant_id
curl -X GET "https://api.metorial.com/servers/ser_Rm4Mnheq2bfEPhBhP7SY/variants/ser_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."