Client API: Container Apps: Software

Part of Container Apps.

GET /api/v1/client/servers/{uuid}/software

List installed software records for a server.

Authentication: an access token, sent as Authorization: Bearer <token>.

GET /api/v1/client/servers/{uuid}/software/addons

Every addon in the folders the server loads from, tracked or hand-uploaded.

Authentication: an access token, sent as Authorization: Bearer <token>.

DELETE /api/v1/client/servers/{uuid}/software/addons/records/{record_uuid}

Drop a tracking record whose files are gone, without touching the disk.

Authentication: an access token, sent as Authorization: Bearer <token>.

POST /api/v1/client/servers/{uuid}/software/addons/remove

Delete one addon from disk, through the tracked uninstall when it has a record.

Authentication: an access token, sent as Authorization: Bearer <token>.

application/json (required)

Type: Body.

POST /api/v1/client/servers/{uuid}/software/addons/toggle

Switch one addon file on or off (Foo.jar <-> Foo.jar.disabled).

Authentication: an access token, sent as Authorization: Bearer <token>.

application/json (required)

Type: Body.

POST /api/v1/client/servers/{uuid}/software/bedrock

Turn Bedrock crossplay on or off for a Java server.

Authentication: an access token, sent as Authorization: Bearer <token>.

application/json (required)

Type: Body.

GET /api/v1/client/servers/{uuid}/software/bedrock/packs

Behavior and resource packs on disk, which are active in the world, and importable uploads.

Authentication: an access token, sent as Authorization: Bearer <token>.

POST /api/v1/client/servers/{uuid}/software/bedrock/packs/disable-all

Empty the world's activation lists so it boots on vanilla content; folders stay.

Authentication: an access token, sent as Authorization: Bearer <token>.

POST /api/v1/client/servers/{uuid}/software/bedrock/packs/import

Queue an import of an uploaded .mcaddon / .mcpack / .zip already on the server.

Authentication: an access token, sent as Authorization: Bearer <token>.

application/json (required)

Type: Body.

POST /api/v1/client/servers/{uuid}/software/bedrock/packs/{pack_uuid}/active

Add a pack to, or drop it from, the world's activation list.

Authentication: an access token, sent as Authorization: Bearer <token>.

application/json (required)

Type: Body.

POST /api/v1/client/servers/{uuid}/software/bedrock/packs/{pack_uuid}/remove

Deactivate a pack, delete its folder, and drop its tracking row.

Authentication: an access token, sent as Authorization: Bearer <token>.

PUT /api/v1/client/servers/{uuid}/software/bedrock/texturepack-required

texturepack-required: players must accept the resource packs to join.

Authentication: an access token, sent as Authorization: Bearer <token>.

application/json (required)

Type: Body.

GET /api/v1/client/servers/{uuid}/software/catalog

Server software the machine can be switched to, grouped for display.

Authentication: an access token, sent as Authorization: Bearer <token>.

GET /api/v1/client/servers/{uuid}/software/catalog/{key}/versions

Installable versions for one catalog entry, with runtime recommendations.

Authentication: an access token, sent as Authorization: Bearer <token>.

GET /api/v1/client/servers/{uuid}/software/catalog/{key}/versions/{version}/builds

Publisher builds of one game version: the loader versions for Fabric/Forge.

Authentication: an access token, sent as Authorization: Bearer <token>.

POST /api/v1/client/servers/{uuid}/software/change

Switch the server to different software, or a different version of it.

Authentication: an access token, sent as Authorization: Bearer <token>.

application/json (required)

Type: Body.

GET /api/v1/client/servers/{uuid}/software/context

Return loader/game-version context for marketplace tab gating.

Authentication: an access token, sent as Authorization: Bearer <token>.

GET /api/v1/client/servers/{uuid}/software/dependencies/{source_uuid}/{identifier}

What a version requires, named, with what is already installed marked.

Authentication: an access token, sent as Authorization: Bearer <token>.

POST /api/v1/client/servers/{uuid}/software/install

Queue a software install job.

Authentication: an access token, sent as Authorization: Bearer <token>.

application/json

Type: object or null.

GET /api/v1/client/servers/{uuid}/software/installs

List recent software install jobs for a server.

Authentication: an access token, sent as Authorization: Bearer <token>.

GET /api/v1/client/servers/{uuid}/software/installs/{install_uuid}

Get a single software install job.

Authentication: an access token, sent as Authorization: Bearer <token>.

POST /api/v1/client/servers/{uuid}/software/installs/{install_uuid}/cancel

Cancel a queued software install.

Authentication: an access token, sent as Authorization: Bearer <token>.

POST /api/v1/client/servers/{uuid}/software/installs/{install_uuid}/retry

Queue a fresh install job with the same parameters as a failed one.

Authentication: an access token, sent as Authorization: Bearer <token>.

GET /api/v1/client/servers/{uuid}/software/jvm

The heap slider and the allowlisted startup flags, as the panel shows them.

Authentication: an access token, sent as Authorization: Bearer <token>.

PATCH /api/v1/client/servers/{uuid}/software/jvm

Move the heap, pick startup flags from the catalog, or reset both. Applies on restart.

Authentication: an access token, sent as Authorization: Bearer <token>.

application/json (required)

Type: Body.

GET /api/v1/client/servers/{uuid}/software/resource-pack

The server resource pack as server.properties declares it.

Authentication: an access token, sent as Authorization: Bearer <token>.

PUT /api/v1/client/servers/{uuid}/software/resource-pack

Point players at a pack, from a URL or a marketplace resource pack version.

Authentication: an access token, sent as Authorization: Bearer <token>.

application/json (required)

Type: Body.

DELETE /api/v1/client/servers/{uuid}/software/resource-pack

Stop offering a server resource pack.

Authentication: an access token, sent as Authorization: Bearer <token>.

POST /api/v1/client/servers/{uuid}/software/safe-mode

Arm a one-shot --safeMode start (vanilla datapack only), optionally starting now.

Authentication: an access token, sent as Authorization: Bearer <token>.

application/json (required)

Type: Body.

POST /api/v1/client/servers/{uuid}/software/search

Search available software (JSON body preferred; query params kept for back-compat).

Authentication: an access token, sent as Authorization: Bearer <token>.

application/json

Type: object or null.

GET /api/v1/client/servers/{uuid}/software/sources

List enabled software sources for a kind.

Authentication: an access token, sent as Authorization: Bearer <token>.

GET /api/v1/client/servers/{uuid}/software/updates

Newer compatible builds for the addons the marketplace installed.

Authentication: an access token, sent as Authorization: Bearer <token>.

GET /api/v1/client/servers/{uuid}/software/versions/{source_uuid}/{identifier}

Get available versions for software.

Plugin and mod lookups default to builds that fit this server's loader and game version; each row carries compatible and incompatible_reason.

Authentication: an access token, sent as Authorization: Bearer <token>.

DELETE /api/v1/client/servers/{uuid}/software/{record_uuid}

Uninstall a tracked software artifact.

Authentication: an access token, sent as Authorization: Bearer <token>.

POST /api/v1/client/servers/{uuid}/software/{record_uuid}/update

Queue an in-place update: the old file is removed, the new build installed.

Authentication: an access token, sent as Authorization: Bearer <token>.

application/json

Type: object or null.