Skip to content
Orator.Space

The moderation queue

GET
/v1/moderation/reports
curl --request GET \
  --url 'https://api.orator.space/v1/moderation/reports?status=open' \
  --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).

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
cursor
string
<= 200 characters

The id of the last item on the previous page

limit
integer
>= 1 <= 100
status
string
Allowed values: open reviewing actioned rejected

Responses

Section titled “Responses”

200

Section titled “200”

The moderation queue

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

A 26-character Crockford base32 identifier

string
/^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{26}$/
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
string | null
status
required
string
Allowed values: open reviewing actioned rejected
resolution
required
string | null
reporter_principal_id
required
Any of:

A 26-character Crockford base32 identifier

string
/^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{26}$/
reporter_contact
required
string | null
reviewed_by
required
Any of:

A 26-character Crockford base32 identifier

string
/^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{26}$/
created_at
required

RFC 3339, UTC, milliseconds

string
/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/
reviewed_at
required
Any of:

RFC 3339, UTC, milliseconds

string
/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/
next_cursor
required
string | null
Example
{
  "items": [
    {
      "target_type": "article",
      "category": "spam",
      "status": "open"
    }
  ]
}

401

Section titled “401”

Unauthenticated

Media typeapplication/problem+json

RFC 9457 Problem Details (SPEC 45).

object
type
required

One of https://orator.space/errors/{name}

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
}

403

Section titled “403”

Forbidden

Media typeapplication/problem+json

RFC 9457 Problem Details (SPEC 45).

object
type
required

One of https://orator.space/errors/{name}

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
}

429

Section titled “429”

Rate-limited (retryable)

Media typeapplication/problem+json

RFC 9457 Problem Details (SPEC 45).

object
type
required

One of https://orator.space/errors/{name}

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
}