Skip to main content
POST
/
v1
/
admin
/
punishments
/
{entity_type}
/
{entity_id}
/
warn
curl -X POST https://hapi.7331.org/v1/admin/punishments/user/123456789012345678/warn \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{"reason": "Excessive API usage"}'

{
  "user_discord_id": "123456789012345678",
  "punishment_type": "WARNING",
  "reason": "Excessive API usage",
  "issued_by_discord_id": "999888777666555444",
  "expires_at": null,
  "created_at": "2026-03-05T12:00:00Z",
  "updated_at": "2026-03-05T12:00:00Z"
}
Requires an active session cookie with moderator or higher permissions. Hierarchy enforced against the target.
​
entity_type
string
required
Entity type. One of: user, guild.
​
entity_id
integer
required
Discord snowflake ID of the entity.
​
reason
string
required
Reason for the warning.

​
Response

Returns the created punishment record.
​
user_discord_id
string
required
Discord ID of the punished user.
​
punishment_type
string
required
Always WARNING.
​
reason
string
required
Reason for the warning.
​
issued_by_discord_id
string
required
Discord ID of who issued the warning.
curl -X POST https://hapi.7331.org/v1/admin/punishments/user/123456789012345678/warn \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{"reason": "Excessive API usage"}'

{
  "user_discord_id": "123456789012345678",
  "punishment_type": "WARNING",
  "reason": "Excessive API usage",
  "issued_by_discord_id": "999888777666555444",
  "expires_at": null,
  "created_at": "2026-03-05T12:00:00Z",
  "updated_at": "2026-03-05T12:00:00Z"
}