modl.gg
Developer API

Player Disconnect

Report a player disconnection from the server.

POST /v1/minecraft/players/disconnect

Report that a player has disconnected from your Minecraft server. This updates the player's online status and records their last logout time.

Authentication

Requires the X-API-Key header with your server's API key.

X-API-Key: your-api-key-here

Request

Headers

HeaderTypeRequiredDescription
X-API-KeystringYesYour server's API key.
Content-TypestringYesMust be application/json.

Body

FieldTypeRequiredDescription
minecraftUuidstringYesThe player's Minecraft UUID.
sessionDurationMslongYesThe duration of the player's session in milliseconds (min: 0).
{
  "minecraftUuid": "550e8400-e29b-41d4-a716-446655440000",
  "sessionDurationMs": 3600000
}

Response

200 OK

{
  "status": 200,
  "success": true
}

Error Responses

Status CodeDescription
400Invalid request body or missing required fields.
401Missing or invalid API key.
429Rate limit exceeded.
500Internal server error.

On this page