Distribution

List bound servers

Every Minecraft server bound to the pack, newest first, with what it last reported about itself, plus any claim code still waiting to be typed. A server is bound by typing its code with RP Engine installed, and from then on hands its players the live release.

GET/packs/{pack}/distribution/servers

Path parameters

packstringrequired

The pack's slug, as returned by the packs endpoints.

Response · 200

The servers.

packstringrequired

The pack.

serversarray of objectrequired

Newest first.

idstringrequired

The server's id, for renaming or unbinding it.

namestringrequired

What the Studio calls it.

statusstringrequired

waiting until somebody types the code on the server, bound after.

Options: waiting, bound

claimCodestringrequired

The code to type, while waiting. Null once bound.

commandstringrequired

The whole command to type in the server's console or chat, while waiting. Null once bound.

claimedAtstringrequired

ISO 8601, when it was bound.

pluginVersionstringrequired

The RP Engine version it runs, from its last check-in.

serverVersionstringrequired

Its Minecraft version, from its last check-in.

viaVersionbooleanrequired

Whether it runs ViaVersion, so players on other versions can join.

geyserbooleanrequired

Whether it runs Geyser, so Bedrock players can join.

lastSeenAtstringrequired

ISO 8601, its last check-in: the plugin is alive.

lastServeAtstringrequired

ISO 8601, the last time it handed the pack to somebody.

createdAtstringrequired

ISO 8601.

Error codes

Branch on error.code, never on the message.

invalid_api_key401

The key isn't one of ours, or it has been revoked.

missing_api_key401

No Authorization: Bearer header was sent.

wrong_key_kind401

An MCP key sent to the REST API, or an API key sent to the MCP server. Each only opens its own.

account_suspended403

The account is suspended, so its keys open nothing. message says until when, if the suspension has an end date.

plan_required403

The key is valid, but its account's plan does not include the API.

not_found404

No such pack, asset or job.