POST
/api/v1/server/infractions
Request
Response
201
Created
Pass a guidelineId from your infraction settings to use that guideline's points, or set
points yourself.
Authorization
AuthorizationstringrequiredYour API token as
Bearer YOUR_TOKEN. Create one in your server's dashboard settings.Body
issuedBystringrequiredMember ID of the staff member issuing it.
memberIdstringrequiredMember ID of the member receiving it.
reasonstringrequiredReason, 4-1024 characters.
forceTermbooleanTerminate the member whatever their point total.
guidelineIdstring | nullGuideline to use, from your infraction settings.
pointsnumber | nullPoints, from 0 to 1000. Defaults to the guideline's points. Required without a guideline.
Response
201 Created
editedBystring[]requiredMember IDs of everyone who edited it.
expiredbooleanrequiredWhether it has expired.
idstringrequiredUnique ID.
issuedBystringrequiredMember ID of who issued it.
memberIdstringrequiredMember ID of the member who received it.
pointsintegerrequiredPoints it carries.
proofstring[]requiredProof file keys.
serverIdstringrequiredServer ID.
textstringrequiredReason.
timestampintegerrequiredWhen it was issued.
voidedbooleanrequiredWhether it has been voided.
dmDisabledbooleanrequiredWhether the member turned off infraction DMs.
expiredAtinteger | nullWhen it expired.
guidelineIdstring | nullGuideline it was issued under.
termboolean | nullWhether it terminated the member.
voidReasonstring | nullWhy it was voided.
voidedBystring | nullMember ID of who voided it.
suspensionobject | nullSuspension started automatically because the member crossed a threshold.
Errors
| Status | Meaning |
|---|---|
400 | Invalid request. validation_failed lists each invalid field in details.fields. |
401 | Missing, invalid or expired token |
403 | Success |
429 | Rate limited. See Retry-After and details. |
500 | Internal server error |
502 | next did not confirm the write. Check whether it applied before retrying. |
503 | Write endpoints are not configured on this deployment |