Void a Suspension

Voids a suspension so its points no longer count.

POST

/api/v1/server/suspensions/{suspensionId}/void

Request

curl -X POST "https://api.melonly.com/api/v1/server/suspensions/{suspensionId}/void" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "performedBy": "7264722635089514496",
  "reason": "wrong builderman"
}'

Response

200

Success

{
  "data": {
    "endAt": 1795381659830,
    "expired": false,
    "id": "7527700000000000000",
    "memberId": "7308965405773533184",
    "points": 0,
    "reason": "said \"trust me bro\" during a 10-80",
    "serverId": "7294057520392310784",
    "startedAt": 1794776859830,
    "startedBy": "7264722635089514496",
    "voided": false
  }
}

Authorization

Authorizationstringrequired
Your API token as Bearer YOUR_TOKEN. Create one in your server's dashboard settings.

Path parameters

suspensionIdstringrequired

Body

performedBystringrequired
Member ID of the staff member doing this.
reasonstringrequired
Reason, 4-1024 characters.

Response

200 Success

expiredbooleanrequired
Whether it has expired.
idstringrequired
Unique ID.
memberIdstringrequired
Member ID of the suspended member.
pointsintegerrequired
Points it carries.
reasonstringrequired
Why they were suspended.
serverIdstringrequired
Server ID.
startedAtintegerrequired
When it started.
startedBystringrequired
Member ID of who suspended them.
voidedbooleanrequired
Whether it has been voided.
endAtinteger | null
When it's scheduled to end. Missing for indefinite suspensions.
endedAtinteger | null
When it ended early.
endedBystring | null
Member ID of who ended it early.
endedReasonstring | null
Why it ended early.
expiredAtinteger | null
When it expired.
voidReasonstring | null
Why it was voided.
voidedBystring | null
Member ID of who voided it.

Errors

StatusMeaning
400Invalid request. validation_failed lists each invalid field in details.fields.
401Missing, invalid or expired token
403Success
404Not found
409Already voided
429Rate limited. See Retry-After and details.
500Internal server error
502next did not confirm the write. Check whether it applied before retrying.
503Write endpoints are not configured on this deployment