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

items

Object
{
  "items": {
    "0": {
      "object": "server.server_version",
      "source": {
        "type": "docker",
        "docker": {}
      },
      "schema": {},
      "server": {
        "object": "server#preview",
        "type": "public"
      }
    },
    "object": "example_object",
    "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": "example_type",
      "docker": {
        "image": "example_image",
        "tag": "example_tag"
      }
    },
    "schema": "example_schema",
    "server": {
      "object": "example_object",
      "id": "example_id",
      "name": "example_name",
      "description": "example_description",
      "type": "",
      "created_at": "2025-10-15T16:41:26.716Z",
      "updated_at": "2025-10-15T16:41:26.716Z"
    },
    "created_at": "2025-10-15T16:41:26.716Z"
  },
  "pagination": {
    "has_more_before": false,
    "has_more_after": false
  }
}

List server versions

Retrieve all versions 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

variant_id

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

Get server version

Retrieve details for a specific server version

URL Parameters

server_id

String

The unique identifier for the server

server_version_id

String

The unique identifier for the server_version

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