Reports
GET /v1/reports
Section titled “GET /v1/reports”The moderation queue: open reports, most severe and earliest due first; or resolved ones
- Scope:
moderation
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
state |
query | open | resolved |
open (default) or resolved. |
|
limit |
query | integer | Reports per page, 1..200 (default 50). | |
offset |
query | integer | Reports to skip (default 0). |
200 OK
object
Errors are problem documents with a code.
GET /v1/reports/{id}
Section titled “GET /v1/reports/{id}”A report, its evidence and the other reports on the same target
- Scope:
moderation
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
id |
path | string | yes | Report id |
200 OK
object
Errors are problem documents with a code.
POST /v1/reports/{id}:resolve
Section titled “POST /v1/reports/{id}:resolve”Decide every open report on the target (DSA art. 17 statement of reasons)
- Scope:
moderation - Idempotency: send
Idempotency-Key; a retry with the same key returns the first result.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
id |
path | string | yes | Report id |
Request body
| Field | Type | Required | Description |
|---|---|---|---|
action |
none | remove_content | suspend_user | ban_user |
yes | |
reason |
string | yes | Facts the decision is based on |
ground |
string | Legal or terms-of-service ground | |
automated |
boolean | ||
days |
integer |
200 OK
object
Errors are problem documents with a code.