Domains

Create, manage, and verify domains through the API.

List domains

GET /domains

Returns all domains for your account.

Create domain

POST /domains
FieldTypeRequiredDescription
domainstringYesThe domain name players connect with (e.g., play.example.com)
game_typestringYesminecraft_java, minecraft_bedrock, or minecraft_geyser

The response includes a cname_target field — this is the CNAME value you need to add at your DNS provider.

Get domain

GET /domains/:id

Returns domain details including CNAME target, DNS verification status, assigned edge nodes, and backend list.

Update domain

PUT /domains/:id

Delete domain

DELETE /domains/:id

Removes the domain and all associated backends, firewall rules, and DNS records.

Verify DNS

POST /domains/:id/verify-dns

Checks if the CNAME record is correctly configured and resolving to our network. Returns {verified: true/false, details: "..."}.

Confirm migration

POST /domains/:id/confirm-migration

For Bedrock/Geyser domains migrating from legacy A record setup to CNAME. Verifies the new CNAME is live and marks the domain as migrated.

On this page