Skip to content

AdminAccountAction

A moderation action on an account.

object
id
required

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

string format: uuid
account_id
required

The account the action is on.

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
reason_category
required

The kind of reason for an action.

string
Allowed values: spam legal violation other
public_reason

The reason shown to the account; omitted when there is none.

string
private_note

The moderators’ note; omitted when there is none.

string
report_id

The report the action follows from; omitted when there is none.

string format: uuid
issuer
required

moderator: a moderator or the CLI.

string
Allowed values: moderator
issued_by_account_id

The account of the moderator who took the action; omitted for the CLI and the system.

string format: uuid
notify_target
required

Whether the account is told of the action.

boolean
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 for one that lasts until lifted.

string format: date-time
lifted_at

When the action was lifted; omitted until it is.

string format: date-time
lift_reason

Why the action was lifted; omitted until it is or when no reason was given.

string
status_ids

The posts of the account that delete_statuses or mark_statuses_sensitive acts on, in ID order; omitted for the other kinds.

Array<string>

Example generated

{
"id": "01890a5d-ac96-774b-bcce-b302099a8057",
"account_id": "01890a5d-ac96-774b-bcce-b302099a8057",
"kind": "warn",
"reason_category": "spam",
"public_reason": "example",
"private_note": "example",
"report_id": "01890a5d-ac96-774b-bcce-b302099a8057",
"issuer": "moderator",
"issued_by_account_id": "01890a5d-ac96-774b-bcce-b302099a8057",
"notify_target": true,
"state": "active",
"issued_at": "2026-04-15T12:00:00Z",
"expires_at": "2026-04-15T12:00:00Z",
"lifted_at": "2026-04-15T12:00:00Z",
"lift_reason": "example",
"status_ids": [
"01890a5d-ac96-774b-bcce-b302099a8057"
]
}

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

Analytics on this site