Issue an Infraction

Issues an infraction as issuedBy, who needs the Issue Infractions permission and must outrank the member.

POST

/api/v1/server/infractions

Request

curl -X POST "https://api.melonly.com/api/v1/server/infractions" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "guidelineId": "7375594080912281600",
  "issuedBy": "7264722635089514496",
  "memberId": "7308965405773533184",
  "reason": "afk on shift for 40 minutes. said he was making soup"
}'

Response

201

Created

{
  "data": {
    "dmDisabled": false,
    "editedBy": [],
    "expired": false,
    "guidelineId": "7375594080912281600",
    "id": "7527833441069436928",
    "issuedBy": "7264722635089514496",
    "memberId": "7308965405773533184",
    "points": 2,
    "proof": [],
    "serverId": "7294057520392310784",
    "term": false,
    "text": "afk on shift for 40 minutes. said he was making soup",
    "timestamp": 1794776859830,
    "voided": false
  }
}

Pass a guidelineId from your infraction settings to use that guideline's points, or set points yourself.

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 issuing it.
memberIdstringrequired
Member ID of the member receiving it.
reasonstringrequired
Reason, 4-1024 characters.
forceTermboolean
Terminate the member whatever their point total.
guidelineIdstring | null
Guideline to use, from your infraction settings.
pointsnumber | null
Points, from 0 to 1000. Defaults to the guideline's points. Required without a guideline.

Response

201 Created

editedBystring[]required
Member IDs of everyone who edited it.
expiredbooleanrequired
Whether it has expired.
idstringrequired
Unique ID.
issuedBystringrequired
Member ID of who issued it.
memberIdstringrequired
Member ID of the member who received it.
pointsintegerrequired
Points it carries.
proofstring[]required
Proof file keys.
serverIdstringrequired
Server ID.
textstringrequired
Reason.
timestampintegerrequired
When it was issued.
voidedbooleanrequired
Whether it has been voided.
dmDisabledbooleanrequired
Whether the member turned off infraction DMs.
expiredAtinteger | null
When it expired.
guidelineIdstring | null
Guideline it was issued under.
termboolean | null
Whether it terminated the member.
voidReasonstring | null
Why it was voided.
voidedBystring | null
Member ID of who voided it.
suspensionobject | null
Suspension started automatically because the member crossed a threshold.

Errors

StatusMeaning
400Invalid request. validation_failed lists each invalid field in details.fields.
401Missing, invalid or expired token
403Success
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