Skip to content

AdminHookDecision

What a decision hook answered about one subject. It holds no text of a post.

object
id
required

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

string format: uuid
hook
required

A decision hook, where the server asks an external review before it accepts something: inbound.status (posts from other servers), inbound.follow (follows from other servers), signup.check (sign-ups), media.check (uploaded media), local.status (local posts), inbound.actor (profiles of accounts on other servers), local.profile (local profiles).

string
Allowed values: inbound.status inbound.follow signup.check media.check local.status inbound.actor local.profile
subject_key
required

What identifies the subject for the hook, such as the URI of a received activity.

string
account_id

The account the subject belongs to; absent when there is none.

string format: uuid
mode
required

The mode of the hook when it made the decision.

string
Allowed values: observe enforce
outcome
required

What a decision records: a verdict (allow, drop, flag, mark_sensitive, require_approval, reject), or a kind of failure, which is not a verdict: timeout, error, invalid (the answer is outside the hook’s vocabulary), breaker_open (the server skipped the plugin after repeated failures).

string
Allowed values: allow drop flag mark_sensitive require_approval reject timeout error invalid breaker_open
reason

The coded reason of a verdict.

string
Allowed values: spam harassment sexual violence illegal malware other
note

The plugin’s short plain-text note for the moderators; absent when there is none.

string
latency_ms
required

How long the call took, in milliseconds.

integer format: int64
decided_at
required
string format: date-time
overridden_at

When a moderator cancelled the decision; absent while it stands.

string format: date-time
restorable_until

For a drop of inbound.status or inbound.follow: until about when cancelling it processes the activity again, which needs the document as it was received. After that, cancelling records the cancellation and brings nothing back. Absent for any other decision: cancelling a drop of inbound.actor fetches the account again from its server, which stores its present profile.

string format: date-time
overridable
required

Whether a moderator can cancel it here: a verdict in force that stopped or changed something. A reject of local.status goes through its appeal instead.

boolean

Example generated

{
"id": "01890a5d-ac96-774b-bcce-b302099a8057",
"hook": "inbound.status",
"subject_key": "example",
"account_id": "01890a5d-ac96-774b-bcce-b302099a8057",
"mode": "observe",
"outcome": "allow",
"reason": "spam",
"note": "example",
"latency_ms": 1,
"decided_at": "2026-04-15T12:00:00Z",
"overridden_at": "2026-04-15T12:00:00Z",
"restorable_until": "2026-04-15T12:00:00Z",
"overridable": true
}

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

Analytics on this site