Skip to main content
POST
/
v1
/
admin
/
punishments
/
{entity_type}
/
{entity_id}
/
timeout
curl -X POST https://hapi.7331.org/v1/admin/punishments/user/123456789012345678/timeout \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{"reason": "Cooldown period", "expires_at": "2026-03-06T12:00:00Z"}'

{
  "user_discord_id": "123456789012345678",
  "punishment_type": "TIMEOUT",
  "reason": "Cooldown period",
  "issued_by_discord_id": "999888777666555444",
  "expires_at": "2026-03-06T12:00:00Z",
  "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. Users only.
​
entity_type
string
required
Entity type. Must be user for timeouts.
​
entity_id
integer
required
Discord snowflake ID of the user.
​
reason
string
required
Reason for the timeout.
​
expires_at
string
required
When the timeout expires (UTC, ISO 8601). Required for timeouts.

​
Response

Returns the created punishment record.
​
user_discord_id
string
required
Discord ID of the punished user.
​
punishment_type
string
required
Always TIMEOUT.
​
reason
string
required
Reason for the timeout.
​
expires_at
string
required
When the timeout expires (ISO 8601).
curl -X POST https://hapi.7331.org/v1/admin/punishments/user/123456789012345678/timeout \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{"reason": "Cooldown period", "expires_at": "2026-03-06T12:00:00Z"}'

{
  "user_discord_id": "123456789012345678",
  "punishment_type": "TIMEOUT",
  "reason": "Cooldown period",
  "issued_by_discord_id": "999888777666555444",
  "expires_at": "2026-03-06T12:00:00Z",
  "created_at": "2026-03-05T12:00:00Z",
  "updated_at": "2026-03-05T12:00:00Z"
}