modl.gg

Toggle Option

Toggle punishment options such as alt-blocking or stat wipe.

POST /v1/minecraft/punishments/{punishmentId}/toggle

Toggle specific options on a punishment, such as alt-blocking (preventing alt accounts from joining) or stat wipe (resetting the player's statistics).

Authentication

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

Request

Headers

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

Path Parameters

ParameterTypeRequiredDescription
punishmentIdstringYesThe ID of the punishment to modify.

Body

FieldTypeRequiredDescription
issuerNamestringYesThe name of the staff member toggling the option.
optionstringYesThe option to toggle. Must be "ALT_BLOCKING" or "STAT_WIPE".
enabledbooleanYesWhether to enable or disable the option.
Example Request Body
{
  "issuerName": "StaffMember",
  "option": "ALT_BLOCKING",
  "enabled": true
}

Response

200 OK

Response
{
  "success": true
}
FieldTypeDescription
successbooleanWhether the option was toggled successfully.

Error Responses

Status CodeDescription
400Invalid option value. Must be "ALT_BLOCKING" or "STAT_WIPE".
401Missing or invalid API key.
404Punishment not found.

On this page