Server Implementation

Manage server implementations tied to a server or server variant within an instance.

Server Implementation object

Attributes

object

Object

id

String

status

Enum

name

String

description

String

metadata

Object

get_launch_params

String

server_variant

Object

server

Object

created_at

Date

updated_at

Date
{
  "object": "server.server_implementation",
  "id": "example_id",
  "status": "active",
  "name": "example_name",
  "description": "example_description",
  "metadata": {},
  "get_launch_params": "example_get_launch_params",
  "server_variant": {
    "object": "server.server_variant#preview",
    "id": "example_id",
    "identifier": "example_identifier",
    "server_id": "example_server_id",
    "source": {
      "type": "docker",
      "docker": {}
    },
    "created_at": "2025-07-20T12:25:38.848Z"
  },
  "server": {
    "object": "server#preview",
    "id": "example_id",
    "name": "example_name",
    "description": "example_description",
    "type": "public",
    "created_at": "2025-07-20T12:25:38.848Z",
    "updated_at": "2025-07-20T12:25:38.848Z"
  },
  "created_at": "2025-07-20T12:25:38.848Z",
  "updated_at": "2025-07-20T12:25:38.848Z"
}

List server implementations

Retrieve all server implementations in the instance. Supports filtering by status, server, or variant.

GEThttp://api.metorial.com/server-implementations
curl -X GET "https://api.metorial.com/server-implementations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..."

Get server implementation

Fetch detailed information about a specific server implementation.

URL Parameters

serverImplementationId

String

The unique identifier for the serverImplementation

GEThttp://api.metorial.com/server-implementations/:serverImplementationId
curl -X GET "https://api.metorial.com/server-implementations/ser_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..."

Create server implementation

Create a new server implementation for a specific server or server variant.

POSThttp://api.metorial.com/server-implementations
curl -X POST "https://api.metorial.com/server-implementations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..."

Update server implementation

Update metadata, launch parameters, or other fields of a server implementation.

URL Parameters

serverImplementationId

String

The unique identifier for the serverImplementation

Request Body

name

StringOptional

description

StringOptional

metadata

ObjectOptional

get_launch_params

StringOptional
PATCHhttp://api.metorial.com/server-implementations/:serverImplementationId
curl -X PATCH "https://api.metorial.com/server-implementations/ser_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "metadata": {},
  "get_launch_params": "example_get_launch_params"
}'

Delete server implementation

Delete a specific server implementation from the instance.

URL Parameters

serverImplementationId

String

The unique identifier for the serverImplementation

DELETEhttp://api.metorial.com/server-implementations/:serverImplementationId
curl -X DELETE "https://api.metorial.com/server-implementations/ser_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..."