modl.gg

Claim Ticket

Link an unlinked ticket to a player account.

POST /v1/minecraft/tickets/{id}/claim

Link an unlinked or unclaimed ticket to a player account. This is used when a ticket was created externally (e.g., via the web panel) and needs to be associated with a Minecraft player who logs in.

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.

Path Parameters

ParameterTypeRequiredDescription
idstringYesThe unique identifier of the ticket to claim.

Body

FieldTypeRequiredDescription
playerUuidstringYesThe Minecraft UUID of the player claiming the ticket.
playerNamestringYesThe current username of the player claiming the ticket.
{
  "playerUuid": "550e8400-e29b-41d4-a716-446655440000",
  "playerName": "Notch"
}

Response

200 OK

{
  "success": true,
  "message": "Ticket claimed successfully."
}

Error Responses

Status CodeDescription
400Invalid request body. Missing required fields or malformed UUID.
401Missing or invalid API key.
404Ticket not found.
409Ticket has already been claimed by another player.
429Rate limit exceeded.
500Internal server error.

On this page