Server Version

Servers in Metorial are version controlled. Metorial automatically updates servers to the latest version when available. These endpoints help you keep track of server versions in the Metorial catalog.

Server Version object

Attributes

object

Object

id

String

The unique identifier of the server version

identifier

String

A unique string identifier for the server version

server_id

String

The ID of the associated server

server_variant_id

String

The ID of the associated server variant

get_launch_params

String

Parameters used to launch this server version

source

Object

The source configuration for this server version

schema

Object

Schema details associated with the server version

server

Object

created_at

Date

Timestamp when the server version was created

{
  "object": "server.server_version",
  "id": "example_id",
  "identifier": "example_identifier",
  "server_id": "example_server_id",
  "server_variant_id": "example_server_variant_id",
  "get_launch_params": "example_get_launch_params",
  "source": {
    "type": "docker",
    "docker": {}
  },
  "schema": {
    "id": "example_id",
    "fingerprint": "example_fingerprint",
    "schema": {},
    "server_id": "example_server_id",
    "server_variant_id": "example_server_variant_id",
    "server_version_id": "example_server_version_id",
    "created_at": "2025-08-12T09:45:15.737Z"
  },
  "server": {
    "object": "server#preview",
    "id": "example_id",
    "name": "example_name",
    "description": "example_description",
    "type": "public",
    "created_at": "2025-08-12T09:45:15.737Z",
    "updated_at": "2025-08-12T09:45:15.737Z"
  },
  "created_at": "2025-08-12T09:45:15.737Z"
}

List server versions

Retrieve all versions for a given server

URL Parameters

serverId

String

The unique identifier for the server

GEThttp://api.metorial.com/servers/:serverId/versions
curl -X GET "https://api.metorial.com/servers/ser_Rm4Mnheq2bfEPhBhP7SY/versions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..."

Get server version

Retrieve details for a specific server version

URL Parameters

serverId

String

The unique identifier for the server

serverVersionId

String

The unique identifier for the serverVersion

GEThttp://api.metorial.com/servers/:serverId/versions/:serverVersionId
curl -X GET "https://api.metorial.com/servers/ser_Rm4Mnheq2bfEPhBhP7SY/versions/ser_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..."