Create a ban | FluxStore Docs

POST/api/v1/bans

Create a new ban. Provide EITHER playerUsername OR ipAddress, not both.

Requires the Bans:Edit permission.

Body

playerUsernamestring

Required if banning by username.

playerUuidstring· uuid

Minecraft UUID. Optional, only relevant when banning by username.

ipAddressstring

Required if banning by IP address.

reasonstringrequired

Reason for the ban (shown in the dashboard).

expiresAtstring· date-time

Optional expiry. null or absent for a permanent ban.

POST/api/v1/bans


# Ban by username
curl -X POST \
  -H "X-Api-Key: flx_XXXX_XXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "playerUsername": "griefer123",
    "reason": "Chargeback fraud",
    "expiresAt": null
  }' \
  https://api.fluxstore.net/api/v1/bans

POST/api/v1/bans


# Ban by IP
curl -X POST \
  -H "X-Api-Key: flx_XXXX_XXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "ipAddress": "192.168.1.100",
    "reason": "Abuse"
  }' \
  https://api.fluxstore.net/api/v1/bans

200OK


{
  "success": true,
  "data": {
    "id": "ban_a1b2c3...",
    "playerUsername": "griefer123",
    "reason": "Chargeback fraud",
    "isActive": true,
    "expiresAt": null,
    "createdAt": "2026-03-15T10:00:00Z"
  }
}