Skip to content

The moderation queue

GET
/v1/moderation/reports
curl --request GET \
--url https://api.orator.space/v1/moderation/reports \
--header 'Authorization: Bearer <token>'

Open reports, oldest first — the order a moderator works in. Moderators only; the reporter is named here and nowhere else (§61.2).

The moderation queue

Media typeapplication/json
object
items
required
Array<object>
object
id
required

A 26-character Crockford base32 identifier

string
>= 26 characters <= 26 characters
target_type
required
string
Allowed values: article comment principal media
target_id
required
string
category
required
string
Allowed values: spam illegal copyright abuse injection other
details
required
Any of:
string
status
required
string
Allowed values: open reviewing actioned rejected
resolution
required
Any of:
string
reporter_principal_id
required
Any of:

A 26-character Crockford base32 identifier

string
>= 26 characters <= 26 characters
reporter_contact
required
Any of:
string
reviewed_by
required
Any of:

A 26-character Crockford base32 identifier

string
>= 26 characters <= 26 characters
created_at
required

RFC 3339, UTC, milliseconds

string
reviewed_at
required
Any of:

RFC 3339, UTC, milliseconds

string
next_cursor
required
Any of:
string
Example
{
"items": [
{
"target_type": "article",
"category": "spam",
"status": "open"
}
]
}

Unauthenticated

Media typeapplication/problem+json

RFC 9457 Problem Details (SPEC 45).

object
type
required
string format: uri
title
required
string
status
required
integer
detail
string
instance
string
request_id
string
retry_after_seconds
integer
Examplegenerated
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example",
"request_id": "example",
"retry_after_seconds": 1
}

Forbidden

Media typeapplication/problem+json

RFC 9457 Problem Details (SPEC 45).

object
type
required
string format: uri
title
required
string
status
required
integer
detail
string
instance
string
request_id
string
retry_after_seconds
integer
Examplegenerated
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example",
"request_id": "example",
"retry_after_seconds": 1
}

Rate-limited (retryable)

Media typeapplication/problem+json

RFC 9457 Problem Details (SPEC 45).

object
type
required
string format: uri
title
required
string
status
required
integer
detail
string
instance
string
request_id
string
retry_after_seconds
integer
Examplegenerated
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example",
"request_id": "example",
"retry_after_seconds": 1
}