Distribution

Read a pack's distribution

What servers bound to this pack hand their players: which Minecraft versions are built, the live release, and the newest one, with each version's build. Poll it after POST /packs/{pack}/publish until latest.status leaves building.

url is the pack's stable download address, the one a server's server.properties can name.

GET/packs/{pack}/distribution

Path parameters

packstringrequired

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

Response · 200

The pack's distribution.

packstringrequired

The pack.

enabledbooleanrequired

Whether bound servers are serving it at all.

versionsarray of stringrequired

The versions a release is built for.

defaultVersionstringrequired

The version the stable url serves.

urlstringrequired

The stable download address.

liveobjectrequired

The release players get now, or null before the first.

idstringrequired

The release's id.

statusstringrequired

Where the build is.

Options: building, ready, failed

errorstring

Why it failed. Absent otherwise.

createdAtstringrequired

ISO 8601.

readyAtstringrequired

ISO 8601, once built.

artifactsarray of objectrequired

One per version, plus bedrock when the pack has anything that crosses over.

versionstringrequired

A Minecraft version, or bedrock.

statusstringrequired

Where this build is.

Options: building, ready, failed

errorstring

Why it failed. Absent otherwise.

bytesintegerrequired

Its size, once built.

latestobjectrequired

The newest release, live or not, or null before the first.

idstringrequired

The release's id.

statusstringrequired

Where the build is.

Options: building, ready, failed

errorstring

Why it failed. Absent otherwise.

createdAtstringrequired

ISO 8601.

readyAtstringrequired

ISO 8601, once built.

artifactsarray of objectrequired

One per version, plus bedrock when the pack has anything that crosses over.

versionstringrequired

A Minecraft version, or bedrock.

statusstringrequired

Where this build is.

Options: building, ready, failed

errorstring

Why it failed. Absent otherwise.

bytesintegerrequired

Its size, once built.

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 is on Starter. The API needs a paid plan.

not_found404

No such pack, asset or job.