Suspend a Member

Suspends a member as issuedBy. Leave out endAt for a suspension with no end date.

POST

/api/v1/server/suspensions

Request

curl -X POST "https://api.melonly.com/api/v1/server/suspensions" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "endAt": 1795381659830,
  "issuedBy": "7264722635089514496",
  "memberId": "7308965405773533184",
  "reason": "said \"trust me bro\" during a 10-80"
}'

Response

201

Created

{
  "data": {
    "dmDisabled": false,
    "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.

Body

issuedBystringrequired
Member ID of the staff member suspending them.
memberIdstringrequired
Member ID of the member being suspended.
reasonstringrequired
Reason, 4-1024 characters.
endAtinteger | null
When it ends, at least a day away. Leave it out for no end date.
pointsnumber
Points, from 0 to 1000. Defaults to 0.

Response

201 Created

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.
dmDisabledbooleanrequired
Whether the member turned off infraction DMs.
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
409The member is already suspended
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