modl.gg
Developer API

Acknowledge Stat Wipe

Acknowledge that a stat wipe has been executed on a server.

POST /v1/minecraft/punishments/{punishmentId}/stat-wipe-acknowledge

Acknowledge that a stat wipe associated with a punishment has been executed on a game server. This marks the stat wipe as completed.

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
punishmentIdstringYesThe unique ID of the punishment.

Body

FieldTypeRequiredDescription
punishmentIdstringYesThe punishment ID (must match the path parameter).
serverNamestringNoThe name of the server that executed the stat wipe.
successbooleanYesWhether the stat wipe was executed successfully.
{
  "punishmentId": "abc123",
  "serverName": "survival-1",
  "success": true
}

Response

200 OK

{
  "status": 200,
  "success": true,
  "message": "Stat wipe acknowledged"
}

Error Responses

Status CodeDescription
400Invalid request or stat wipe not applicable.
401Missing or invalid API key.
404Punishment not found for the given ID.
429Rate limit exceeded.
500Internal server error.

On this page