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
Objectid
StringThe unique identifier of the server version
identifier
StringA unique string identifier for the server version
server_id
StringThe ID of the associated server
server_variant_id
StringThe ID of the associated server variant
get_launch_params
StringParameters used to launch this server version
source
ObjectThe source configuration for this server version
schema
ObjectSchema details associated with the server version
server
Objectcreated_at
DateTimestamp 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
StringThe unique identifier for the server
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
StringThe unique identifier for the server
serverVersionId
StringThe unique identifier for the serverVersion
curl -X GET "https://api.metorial.com/servers/ser_Rm4Mnheq2bfEPhBhP7SY/versions/ser_Rm4Mnheq2bfEPhBhP7SY" \-H "Content-Type: application/json" \-H "Authorization: Bearer metorial_sk_..."