Developer API
Update Server
Update a player's current server.
POST /v1/minecraft/players/update-server
Update the server a player is currently connected to. This is used to track which server a player is on for cross-server features.
Authentication
Requires the X-API-Key header with your server's API key.
X-API-Key: your-api-key-hereRequest
Headers
| Header | Type | Required | Description |
|---|---|---|---|
X-API-Key | string | Yes | Your server's API key. |
Content-Type | string | Yes | Must be application/json. |
Body
| Field | Type | Required | Description |
|---|---|---|---|
minecraftUuid | string | Yes | The player's Minecraft UUID. |
serverName | string | Yes | The name of the server the player is now on. Must not be blank. |
{
"minecraftUuid": "550e8400-e29b-41d4-a716-446655440000",
"serverName": "survival-2"
}Response
200 OK
{
"status": 200,
"success": true
}Error Responses
| Status Code | Description |
|---|---|
400 | Invalid request body or missing required fields. |
401 | Missing or invalid API key. |
404 | Player not found for the given UUID. |
429 | Rate limit exceeded. |
500 | Internal server error. |