Admin reports

A report is one complaint against a message, an account or a guild, with the evidence Fluxer captured when it was filed. Use these routes to review reports, resolve them and delete them. People file reports through the public Reports resource, which defines the categories and reasons.

Admin report object

List reports returns this object. Get report returns the Admin report detail object, which extends it with message context. The guild, channel, webhook and message fields are copied when the report is filed. The account names are looked up when Fluxer builds the response. reporter_email, reporter_full_legal_name and reporter_country_of_residence are null unless you have report:view:reporter_pii as well as report:view.

Structure

Field	Type	Description
report_id	snowflake	The ID of the report
reporter_id1	?snowflake	The account that filed the report
reporter_tag1	?string	The reporter username and discriminator joined by #
reporter_username1	?string	The username of the reporter
reporter_global_name1	?string	The display name of the reporter
reporter_discriminator1	?string	The four-digit discriminator of the reporter
reporter_email	?string	The email address of the reporter
reporter_full_legal_name	?string	The legal name supplied with a Digital Services Act notice
reporter_country_of_residence	?string	The country of residence supplied with a Digital Services Act notice
reported_at	ISO8601 timestamp	When the report was filed
status	integer	The report status
report_type	integer	The report type
category	?string	The report category
reason?	?string	The report reason, or null when filed without a report flow
reason_label?	?string	The English label of the reason
reason_highest_priority?	?boolean	Whether moderators see this reason first
flow?	?report flow answers object	The answers the reporter gave in the report flow
reporter_good_faith_confirmed?	?boolean	Whether the reporter of a Digital Services Act notice confirmed good faith
additional_info	?string	The free-text detail the reporter supplied
reported_user_id2	?snowflake	The reported account
reported_user_tag2	?string	The reported username and discriminator joined by #
reported_user_username2	?string	The username of the reported account
reported_user_global_name2	?string	The display name of the reported account
reported_user_discriminator2	?string	The four-digit discriminator of the reported account
reported_user_avatar_hash2	?string	The avatar hash of the reported account
reported_user_bot?2	?boolean	Whether the reported account is a bot
reported_webhook_id?2	?snowflake	The webhook that sent the reported message
reported_webhook_name?2	?string	The name the reported message was sent under
reported_webhook_avatar_hash?2	?string	The avatar hash the reported message was sent with
reported_webhook_default_name?2	?string	The name set on the webhook itself
reported_webhook_default_avatar_hash?2	?string	The avatar hash set on the webhook itself
reported_webhook_type?2	?integer	The webhook type
reported_webhook_application_id?2	?snowflake	The application whose bot created the webhook
reported_webhook_channel_id?2	?snowflake	The channel the webhook belonged to
reported_webhook_guild_id?2	?snowflake	The guild the webhook belonged to
reported_webhook_created_at?2	?ISO8601 timestamp	When the webhook was created
reported_webhook_creator_id?2	?snowflake	The account that created the webhook
reported_webhook_creator_tag?2	?string	The creator username and discriminator joined by #
reported_webhook_creator_username?2	?string	The username of the creator
reported_webhook_creator_global_name?2	?string	The display name of the creator
reported_webhook_creator_discriminator?2	?string	The four-digit discriminator of the creator
reported_webhook_creator_avatar_hash?2	?string	The avatar hash of the creator
reported_guild_id	?snowflake	The reported guild
reported_guild_name	?string	The name of the reported guild
reported_guild_icon_hash	?string	The icon hash of the reported guild
reported_message_id	?snowflake	The reported message, or null for a user or guild report
reported_channel_id	?snowflake	The channel the reported content was sent in
reported_channel_name	?string	The channel name, or null for a direct message channel
reported_channel_nsfw	?boolean	Whether the reported channel was NSFW, or is now when the report captured no value
reported_guild_invite_code	?string	The invite code the reporter sent with a guild report
reported_guild_nsfw_level	?integer	The guild NSFW level, or the current level when the report captured no value
reported_guild_nsfw?	?boolean	Whether the reported guild was marked NSFW
reported_guild_content_warning_level?	?integer	The guild content warning level
reported_guild_content_warning_text?	?string	The guild content warning text (at most 200 characters)
reported_channel_nsfw_override?	?boolean	The NSFW override set on the channel itself
reported_channel_content_warning_level?	?integer	The content warning level set on the channel itself
reported_channel_content_warning_text?	?string	The content warning text set on the channel itself (at most 200 characters)
reported_channel_effective_nsfw?	?boolean	Whether the channel was NSFW after applying the guild setting
reported_channel_effective_content_warning_level?	?integer	The channel content warning level after applying the guild setting
reported_channel_effective_content_warning_text?	?string	The channel content warning text after applying the guild setting
resolved_at	?ISO8601 timestamp	When the report was resolved, or null while pending
resolved_by_admin_id	?snowflake	The admin who resolved the report, or null while pending
public_comment	?string	The comment shown to the reporter (at most 512 characters)

¹ Null for an anonymous Digital Services Act notice, which is filed without an account

² A report on a webhook message has null reported_user_* fields and has the webhook fields set instead. On every other report, the webhook fields are null

Example

{
  "report_id": "1502771904419102720",
  "reporter_id": "1483920011884392448",
  "reporter_tag": "wren#0042",
  "reporter_email": null,
  "reported_at": "2026-03-04T18:22:10.441Z",
  "status": 0,
  "report_type": 0,
  "category": "harassment",
  "reason": "harassment",
  "reason_label": "Harassment or bullying",
  "reason_highest_priority": false,
  "flow": {
    "revision_hash": "6b1f0c9e2a7d4413",
    "surface": "in_app",
    "locale": "de",
    "steps": [
      {"screen_id": "root_message", "screen_title": "Report message", "option_id": "abuse", "option_label": "Abusive or harmful content", "items": []},
      {"screen_id": "abuse", "screen_title": "What does it involve?", "option_id": "harassment", "option_label": "Bullying, harassment or stalking", "items": []}
    ]
  },
  "reporter_good_faith_confirmed": null,
  "additional_info": null,
  "reported_user_id": "1490118377238528000",
  "reported_user_bot": false,
  "reported_guild_id": "1471002884199612416",
  "reported_message_id": "1502771119476146176",
  "reported_channel_id": "1471002884199612420",
  "reported_channel_nsfw": false,
  "reported_guild_nsfw_level": 0,
  "resolved_at": null,
  "resolved_by_admin_id": null,
  "public_comment": null
}

Report status

Value	Name	Description
0	PENDING	The report is waiting for review
1	RESOLVED	The report was reviewed and resolved

Report type

Value	Name	Description
0	MESSAGE	A message was reported
1	USER	A user was reported
2	GUILD	A guild was reported

Admin report detail object

The detail object extends the Admin report object with these fields, which only Get report returns.

Structure

Field	Type	Description
mutual_dm_channel_id	?snowflake	The DM channel the reporter and reported account share, on a USER report
message_context	array[report message context object]	The messages captured around the reported message
message_responses	array[message object]	The current state of the same messages, without deleted ones
reported_profile_snapshot?	?report profile snapshot object	The reported profile as it was when the report was filed
legal_hold_until?	?ISO8601 timestamp	When the legal hold ends, or null without one
legal_hold_reason?	?string	Why the report is held
notes?	array[report note object]	The internal notes on the report, oldest first

Report message context object

A copy of a message as it was when the report was filed. A message report captures the reported message and up to 25 messages before and after it. User and guild reports capture none. Attachment copies stay when the original is deleted.

Structure

Field	Type	Description
id	snowflake	The ID of the message
channel_id	snowflake	The channel the message was sent in
channel_nsfw	?boolean	The current NSFW state of the channel
channel_content_warning_level?	?integer	Always null
channel_content_warning_text?	?string	Always null
guild_id	?snowflake	The guild the report is about or was filed from
guild_nsfw_level	?integer	The current guild NSFW level
guild_nsfw?	?boolean	Always null
guild_content_warning_level?	?integer	Always null
guild_content_warning_text?	?string	Always null
content	string	The message content, empty when it had none
timestamp	ISO8601 timestamp	When the message was sent
attachments	array[report message attachment object]	The attachment copies
author_id	snowflake	The author, or the webhook ID for a webhook message
author_username	string	The author username, or the name a webhook message was sent under
author_global_name	?string	Always null
author_discriminator	string	The four-digit author discriminator, 0000 for a webhook message
author_avatar	?string	The author avatar hash
webhook_id?	?snowflake	The webhook that sent the message
author_bot?	?boolean	Whether the author account is a bot
missing_attachments?	array[report missing attachment object]	Attachments Fluxer could not copy

When the author's account was already deleted, the copy has the username DeletedUser and the discriminator 0000.

Report message attachment object

Structure

Field	Type	Description
id	snowflake	The ID of the attachment
filename	string	The file name
url	string	The download URL for the copy, valid for five minutes
nsfw	?boolean	Whether the attachment was marked NSFW
content_type	?string	The MIME type
width	?integer	The width in pixels, or null for a non-image
height	?integer	The height in pixels, or null for a non-image
size?	?integer	The size in bytes

Report missing attachment object

An attachment Fluxer could not copy into the report. It has no download URL.

Structure

Field	Type	Description
id	snowflake	The ID of the attachment
filename	string	The file name
nsfw	?boolean	Whether the attachment was marked NSFW
content_type	?string	The MIME type
width	?integer	The width in pixels, or null for a non-image
height	?integer	The height in pixels, or null for a non-image
size	?integer	The size in bytes

Report profile snapshot object

The reported profile as it was when the report was filed, with copies of its images.

Structure

Field	Type	Description
captured_at	ISO8601 timestamp	When the snapshot was taken
user	?snapshot user object	The reported account, or null on a guild report
member	?snapshot member object	The guild profile of the reported account, when the report is about a guild
guild	?snapshot guild object	The reported guild, on a guild report only

Snapshot user object

Structure

Field	Type	Description
id	snowflake	The ID of the account
username	?string	The username
discriminator	?string	The four-digit discriminator
global_name	?string	The display name
bio	?string	The profile bio
pronouns	?string	The pronouns
avatar	?snapshot asset object	The avatar
banner	?snapshot asset object	The profile banner

Snapshot member object

Structure

Field	Type	Description
guild_id	snowflake	The guild the profile belongs to
nick	?string	The guild nickname
bio	?string	The guild profile bio
pronouns	?string	The guild profile pronouns
joined_at	?ISO8601 timestamp	When the account joined the guild
avatar	?snapshot asset object	The guild avatar
banner	?snapshot asset object	The guild profile banner

Snapshot guild object

Structure

Field	Type	Description
id	snowflake	The ID of the guild
name	?string	The guild name
vanity_url_code	?string	The vanity invite code
icon	?snapshot asset object	The icon
banner	?snapshot asset object	The banner
splash	?snapshot asset object	The invite splash

Snapshot asset object

Structure

Field	Type	Description
hash	string	The asset hash when the report was filed
url	?string	The download URL for the copy, valid for five minutes, or null when the copy failed

Report flow answers object

The answers a reporter gave in a report flow, with English labels from the current catalog.

Structure

Field	Type	Description
revision_hash	string	The revision hash the reporter's client sent
surface	string	The report flow surface, in_app or dsa
locale	?string	The locale the reporter saw the flow in
steps	array[report flow answer step object]	The answered screens in order

Report flow answer step object

Structure

Field	Type	Description
screen_id	string	The ID of the screen
screen_title	string	The English title of the screen
option_id	?string	The ID of the chosen option, or null on a checklist or info screen
option_label	?string	The English label of the chosen option
items	array[report flow answer item object]	The checked checklist items

Report flow answer item object

Structure

Field	Type	Description
id	string	The ID of the item
label	string	The English label of the item

Report reason object

An entry in the report reason catalog, as List report reasons returns it.

Structure

Field	Type	Description
key	string	The reason key stored on a report
label	string	The English label
highest_priority	boolean	Whether moderators see reports with this reason first
legacy_category_message	string	The category a message report stores
legacy_category_user	string	The category a user report stores
legacy_category_guild	string	The category a guild report stores

Report resolution object

Update report returns this object.

Structure

Field	Type	Description
report_id	snowflake	The ID of the report
status	integer	The report status, always RESOLVED
resolved_at	?ISO8601 timestamp	When the report was resolved
public_comment	?string	The comment shown to the reporter, or null when notify_reporter was false

Report legal hold object

Set report legal hold returns this object.

Structure

Field	Type	Description
report_id	snowflake	The ID of the report
legal_hold_until	?ISO8601 timestamp	When the hold ends, or null when the report has no hold
legal_hold_reason	?string	Why the report is held, or null when the report has no hold

Report note object

A note is for admins only, and Fluxer never shows it to the reporter or the reported account. A note can't be edited, and it's deleted with its report.

Structure

Field	Type	Description
note_id	snowflake	The ID of the note
author_id	snowflake	The admin who wrote it
body	string	The note
created_at	ISO8601 timestamp	When it was written

Report retention

A pending report is kept until it is resolved. A resolved report is deleted with its notes and evidence copies 365 days after resolved_at, and you can change the number of days with FLUXER_REPORT_RETENTION_DAYS on worker, which runs retention once a day. Three kinds of report are kept longer.

• A child_safety report is kept at least 365 days after it was resolved, even when FLUXER_REPORT_RETENTION_DAYS is lower.
• A report linked from an enforcement decision is kept at least 365 days after the newest such decision.
• A report with a legal hold is kept until the hold ends.

Every report, pending or resolved, loses its message context, profile snapshot, additional info and evidence copies 365 days after it was filed, unless it has a legal hold. The record and its notes stay.

When a report is resolved as no_violation and isn't one of the reports above, its message context, profile snapshot, additional info and evidence copies are deleted 184 days after it was resolved, and the rest of the record is deleted when the retention period ends.

Deleted evidence can't be restored

To see what retention would delete before it deletes anything, set FLUXER_REPORT_RETENTION_DRY_RUN to true on worker. It then logs each report it would delete and deletes nothing.

List reports

GET/v1/admin/reportsAudit reason

Returns a page of Admin report objects. You need report:view.

Query parameters

Field	Type	Description
q?1	string	Free-text query (1-1024 characters)
status?	pending | resolved	Filter by report status
report_type?	message | user | guild	Filter by report type
category?	string	Filter by category (1-128 characters)
reason?	string	Filter by report reason key (1-64 characters)
reporter_id?	snowflake	Filter by reporter
reported_user_id?	snowflake	Filter by reported account
reported_webhook_id?	snowflake	Filter by the webhook that sent the reported message
reported_guild_id?	snowflake	Filter by reported guild
reported_channel_id?	snowflake	Filter by reported channel
guild_context_id?	snowflake	Filter by the guild the report was filed from
resolved_by_admin_id?	snowflake	Filter by the admin who resolved the report
sort_by?2	created_at | reported_at | resolved_at	Sort field (default reported_at)
sort_order?2	asc | desc	Sort direction (default desc)
limit?	integer	Maximum reports to return (1-200, default 50)
offset?	integer	Reports to skip (0-10000, default 0)

¹ Matches category, additional_info, reported_guild_name and reported_channel_name

² Ignored when status is the only filter, and those results are always newest first by reported_at

Response body

Field	Type	Description
reports	array[Admin report object]	The reports in this page
total	integer	The number of matching reports
offset	integer	The offset of this page
limit	integer	The limit of this page

Response

Status	Body	Condition
200	response body	The page was returned
403	error response	FEATURE_TEMPORARILY_DISABLED when the instance has no search backend

The rate limit is 200 requests per minute, on the admin:lookup bucket.

List report reasons

GET/v1/admin/report-reasonsAudit reason

Returns every report reason with the category it stores for each report type. You need report:view.

Response body

Field	Type	Description
reasons	array[report reason object]	Every reason, in catalog order

Response

Status	Body	Condition
200	response body	The catalog was returned

The rate limit is 200 requests per minute, on the admin:lookup bucket.

Get report

GET/v1/admin/reports/{report_id}Audit reason

Returns an Admin report detail object. You need report:view.

Response

Status	Body	Condition
200	Admin report detail object	The report was returned
404	error response	UNKNOWN_REPORT when the report doesn't exist

The rate limit is 200 requests per minute, on the admin:lookup bucket.

Update report

PATCH/v1/admin/reports/{report_id}Audit reason

Resolves a pending report and returns a report resolution object. You need report:resolve.

JSON body

Field	Type	Description
status	resolved	The new status
public_comment?	string	The comment shown to the reporter (0-512 characters)
notify_reporter?1	boolean	Whether the notice to the reporter includes public_comment (default true)
resolution	string	actioned, no_violation or duplicate
outcome?	string	removed, warned, restricted, action_taken or no_violation
duplicate_of?	snowflake	The report this one repeats

¹ The reporter gets a notice either way. False leaves the comment out of the notice and off the report, and Fluxer keeps it only in the audit entry as internal_comment

The resolution decides which of the other fields you send.

resolution	outcome	duplicate_of
actioned	Required, any value except no_violation	Not allowed
no_violation	Optional, only no_violation	Not allowed
duplicate	Not allowed, copied from the duplicate_of report	Required, and not this report

The outcome is one of these values.

Outcome	Description
removed	The reported content, profile field or guild was removed
warned	The account responsible was warned, and the reporter is told action was taken
restricted	The reported account was restricted
action_taken	Fluxer acted another way and doesn't tell the reporter how
no_violation	The reported content breaks no rule

Schedule user deletion with deletion reason 3, 4, 5, 6, 8, 11, 17, 18, 20, 21 or 22 also resolves the pending reports against that account with the outcome restricted and no comment, except reports in the child_safety, underage_user and self_harm categories. An enforcement decision resolves the pending reports it links.

Response

Status	Body	Condition
200	report resolution object	The report was resolved
400	error response	REPORT_ALREADY_RESOLVED when the report is already resolved
400	error response	INVALID_FORM_BODY with REPORT_OUTCOME_INVALID when outcome or duplicate_of doesn't fit resolution
404	error response	UNKNOWN_REPORT when the report or the duplicate_of report doesn't exist

Side effects

The reporter gets a system DM with the outcome, which sends Channel Create and Message Create, and an email when the account has an email address. A Digital Services Act notice and an instance with direct messages turned off get the email only. Fluxer sends nothing when the reporter's account is deleted, when it was barred from reporting at the time of the report, or when the report is a duplicate of one with no outcome yet.

The rate limit is 200 requests per minute, on the admin:lookup bucket.

List report notes

GET/v1/admin/reports/{report_id}/notesAudit reason

Returns the notes on a report, oldest first. You need report:view.

Response body

Field	Type	Description
notes	array[report note object]	The notes on the report, oldest first

Response

Status	Body	Condition
200	response body	The notes were returned
404	error response	UNKNOWN_REPORT when the report doesn't exist

The rate limit is 200 requests per minute, on the admin:lookup bucket.

Add a note to a report

POST/v1/admin/reports/{report_id}/notesAudit reason

Adds a note to a report, pending or resolved, and returns it. You need report:resolve.

JSON body

Field	Type	Description
body	string	The note (1-2000 characters)

Response

Status	Body	Condition
200	report note object	The note was added
400	error response	INVALID_FORM_BODY when body is empty or over 2000 characters
404	error response	UNKNOWN_REPORT when the report doesn't exist

The rate limit is 100 requests per minute, on the admin:user:modify bucket.

Set report legal hold

POST/v1/admin/reports/{report_id}/legal-holdAudit reason

Places or clears a legal hold and returns a report legal hold object. You need report:resolve. Retention doesn't delete a held report until the hold ends, and a new hold replaces the old one.

JSON body

Field	Type	Description
legal_hold_until	?ISO8601 timestamp	When the hold ends (in the future), or null to clear the hold
legal_hold_reason?	?string	Why the report is held (1-512 characters), required to place a hold

Response

Status	Body	Condition
200	report legal hold object	The hold was placed or cleared
400	error response	INVALID_FORM_BODY when legal_hold_until isn't in the future or a hold has no reason
404	error response	UNKNOWN_REPORT when the report doesn't exist

The rate limit is 200 requests per minute, on the admin:lookup bucket.

Delete report

DELETE/v1/admin/reports/{report_id}Audit reason

Deletes a report with its notes and evidence copies right away, without telling the reporter. You need report:delete.

Response

Status	Body	Condition
204	empty	The report was deleted
404	error response	UNKNOWN_REPORT when the report doesn't exist
409	error response	REPORT_UNDER_LEGAL_HOLD when the report has a legal hold that hasn't ended

The rate limit is 200 requests per minute, on the admin:lookup bucket.