Skip to content

ModerationActionPage

A page of the actions on the user’s own account, newest first.

object
next_cursor

An opaque pagination cursor. Clients pass it back unchanged and never parse it.

string
>= 1 characters <= 256 characters
items
required
Array<object>

A moderation action on the authenticated user’s own account, as the user sees it. It never carries the moderators’ private note, the report the action follows from, or who filed the report or issued the action.

object
id
required

The ID of a resource, a UUIDv7 in its canonical string form.

string format: uuid
kind
required

warn: a notice only. mark_statuses_sensitive and delete_statuses: actions on posts. force_sensitive: every attachment is shown as sensitive. limit: every post is followers-only and stays off the public timelines. restrict_posting: no posting. restrict_interaction: no following, favouriting, boosting, or replying. disable_login: no logging in. suspend: all of these, and the profile and posts are hidden. ban: a suspension that never ends, with the deletion of the account.

string
Allowed values: warn mark_statuses_sensitive delete_statuses force_sensitive limit restrict_posting restrict_interaction disable_login suspend ban
kind_label
required

What the action does, in the user’s language.

string
reason_category
required

The kind of reason for an action.

string
Allowed values: spam legal violation other
reason_category_label
required

The reason category, in the user’s language.

string
public_reason

The moderators’ explanation to the user, as plain text; omitted when there is none.

string
status_ids
required

The posts that an action on posts acted on; empty for an action on the whole account.

Array<string>
state
required

active: in effect now. expired: it ended at expires_at. lifted: a moderator lifted it.

string
Allowed values: active expired lifted
issued_at
required
string format: date-time
expires_at

When the action ends by itself; omitted when it lasts until it is lifted.

string format: date-time
lifted_at

When a moderator lifted the action; omitted unless it is lifted.

string format: date-time
appealable
required

Whether the user can appeal the action now (POST /moderation/actions/{id}/appeal): it has no appeal yet, appeal_deadline has not passed, and for a ban the account is not deleted.

boolean
appeal_deadline

The last moment the action can be appealed: the instance’s appeal window from the action, and for a ban no later than the deletion of the account.

string format: date-time
appeal

The user’s appeal of the action; omitted when there is none.

Schema: ModerationAppeal

object

Example generated

{
"next_cursor": "example",
"items": [
{
"id": "01890a5d-ac96-774b-bcce-b302099a8057",
"kind": "warn",
"kind_label": "example",
"reason_category": "spam",
"reason_category_label": "example",
"public_reason": "example",
"status_ids": [
"01890a5d-ac96-774b-bcce-b302099a8057"
],
"state": "active",
"issued_at": "2026-04-15T12:00:00Z",
"expires_at": "2026-04-15T12:00:00Z",
"lifted_at": "2026-04-15T12:00:00Z",
"appealable": true,
"appeal_deadline": "2026-04-15T12:00:00Z",
"appeal": {}
}
]
}

For LLMs and coding agents:llms.txt,llms-full.txt, llms-small.txt

Analytics on this site