Webhooks
Webhook events
Every webhook event with an example payload — decision.created, subject.status_changed, reports.resolved, appeal.resolved, review.decided and test.ping.
Event format
Every event has id, type, createdAt (when the event was created) and app (id, slug), plus one payload member depending on the type. Timestamps are UTC RFC 3339 with up to 6 fractional digits. Ignore unknown fields.
type |
Payload member | When |
|---|---|---|
decision.created |
decision |
A moderator decided |
subject.status_changed |
subject |
A suspension ended, or a complaint ended a restriction |
reports.resolved |
reports |
After a decision on a case with reports of users |
appeal.resolved |
appeal |
A complaint was decided |
review.decided |
review |
A review request was decided |
test.ping |
none | Send test webhook in the dashboard |
The schemas are in the OpenAPI specification under x-webhooks and WebhookEvent. How to verify and answer the requests is on Receiving webhooks.
decision.created
A moderator decided (on a case, from a user file, on a review request or on a complaint). Example, a temporary suspension:
{
"id": "evt_01K6G5H1TR8W4QZ3M0XCB7NDEA",
"type": "decision.created",
"createdAt": "2026-10-01T10:00:00.123456Z",
"app": { "id": "01K6G5H1TR8W4QZ3M0XCB7NAPP", "slug": "photoapp" },
"decision": {
"id": "01K6G5H1TR8W4QZ3M0XCB7NDEC",
"action": "suspend_user",
"suspendUntil": "2026-10-08T08:00:00Z",
"content": { "externalContentId": "comment_5521" },
"subject": { "externalUserId": "u_112" },
"policies": [{ "code": "harassment_hate", "title": "Harassment and hate speech" }],
"statementOfReasons": {
"locale": "en",
"text": "Decision on your account\n\nMeasure: temporary suspension of the account until …",
"structured": {
"action": "suspend_user",
"endsAt": "2026-10-08T08:00:00Z",
"territorialScope": "app",
"facts": "Repeated insults in comments.",
"basedOnNotice": true,
"noticeSource": "notice",
"automatedDetection": false,
"automatedDecision": false,
"automation": "none",
"grounds": [{ "basis": "terms", "policyCode": "harassment_hate", "title": "Harassment and hate speech" }],
"redress": "…"
}
},
"decidedAt": "2026-10-01T10:00:00.123456Z"
}
}Field of decision |
Meaning |
|---|---|
id |
Decision ID (for complaints) |
action |
dismiss, remove_content, restrict_content, warn_user, suspend_user, ban_user, restore, reject_submission (see Applying actions) |
suspendUntil |
Only with suspend_user |
content.externalContentId |
Present if the case has content (independent of the action) |
subject.externalUserId |
Present if the case has a user. Decisions from the user file have only subject. |
policies[] |
code, title; may be empty for dismiss and restore |
statementOfReasons |
locale (de or en), text (ready-made), structured (see below) |
decidedAt |
Time of the decision; use it for ordering |
appealId, replacesDecisionId |
Only for a new decision after a complaint |
reviewId |
Only for decisions on a review request (also a new decision after a complaint against one) |
restoreScope |
Only with restore: content or account |
structured: action, endsAt (only with a temporary restriction), territorialScope (app), facts, basedOnNotice, noticeSource (notice, trusted_flagger, own_initiative), automatedDetection (the case has a report with source: system), automatedDecision (only with automation: full), automation (none; partial: a moderator confirmed an AI suggestion; full: automatic decision, not used yet), grounds[] (basis terms or law, policyCode, title, lawReference only with law), redress.
subject.status_changed
Currently sent when a temporary suspension ends (by an hourly job, so up to about an hour after suspendUntil, or together with a decision that takes over its end), and when a new decision on a complaint ends the ban or suspension it replaces. Other status changes come only as decision.created.
{
"id": "evt_01K6R2…",
"type": "subject.status_changed",
"createdAt": "2026-10-08T08:15:02.481233Z",
"app": { "id": "01K6G5H1TR8W4QZ3M0XCB7NAPP", "slug": "photoapp" },
"subject": { "externalUserId": "u_112", "status": "active" }
}subject: externalUserId, status (active, warned, suspended, banned), suspendedUntil (only with suspended). After a decision the status is the one after the decision, and createdAt equals its decidedAt. suspend_user, ban_user, restore, decisions on reviews and restore with restoreScope: content never trigger this event.
reports.resolved
Sent after decision.created when the case had reports of users (source: user), so you can inform the reporters (Art. 16(5) DSA). Limenia knows reporters only as hashes, so it returns your report IDs.
{
"id": "evt_01K6G5H2…",
"type": "reports.resolved",
"createdAt": "2026-10-01T10:00:00.234567Z",
"app": { "id": "01K6G5H1TR8W4QZ3M0XCB7NAPP", "slug": "photoapp" },
"reports": {
"decisionId": "01K6G5H1TR8W4QZ3M0XCB7NDEC",
"action": "suspend_user",
"policies": [{ "code": "harassment_hate", "title": "Harassment and hate speech" }],
"decidedAt": "2026-10-01T10:00:00.123456Z",
"appealDeadline": "2027-04-01T10:00:00.123456Z",
"items": [{ "reportId": "01K6G4…", "externalReportId": "rep_77" }, { "reportId": "01K6G4…" }]
}
}- At most 100 items per event; larger cases get several events with the same
decisionId(at most 100 events, i.e. 10 000 reports). Deduplicate by event ID, not bydecisionId. - System reports are not included. A later change after a complaint sends no new
reports.resolved. - Map
itemsviaexternalReportId(orreportIdfrom the 201 response) to your reports and users, tell them the outcome in short (e.g. “No violation found” fordismiss, “The content was removed” forremove_content) and that they can complain untilappealDeadline(POST /v1/appealswithappellant.type: "reporter"and thisdecisionId). You write these texts yourself.
appeal.resolved
A moderator decided on a complaint.
{
"id": "evt_01K6S1…",
"type": "appeal.resolved",
"createdAt": "2026-10-05T09:00:00.512345Z",
"app": { "id": "01K6G5H1TR8W4QZ3M0XCB7NAPP", "slug": "photoapp" },
"appeal": {
"id": "01K6S1…",
"externalAppealId": "appeal_17",
"decisionId": "01K6G5H1TR8W4QZ3M0XCB7NDEC",
"appellantType": "subject",
"outcome": "changed",
"statementText": "Decision on your complaint\n\n…",
"resolvedAt": "2026-10-05T09:00:00.498765Z",
"newDecisionId": "01K6S1…"
}
}externalAppealId only if you set it, newDecisionId only with outcome: "changed" (the new decision follows as its own decision.created). The complaint text is not sent back. Find the person via appeal.id or externalAppealId and show statementText as plain text (see Complaints).
review.decided
A moderator decided on a review request. Publish only now.
{
"id": "evt_01K6T3…",
"type": "review.decided",
"createdAt": "2026-10-03T09:12:00.123456Z",
"app": { "id": "01K6G5H1TR8W4QZ3M0XCB7NAPP", "slug": "photoapp" },
"review": {
"id": "01K6T2…",
"externalReviewId": "upload_881",
"type": "profile_photo",
"outcome": "rejected",
"decidedAt": "2026-10-03T09:12:00.098765Z",
"decisionId": "01K6T3…",
"content": { "externalContentId": "photo_881" }
}
}outcome |
What your app does |
|---|---|
approved |
Publish. No decision.created and no statement of reasons follow. |
restricted |
Publish with a restriction (e.g. adults only, blurred). The decision with restrict_content follows as decision.created; show its statement of reasons to the author. |
rejected |
Do not publish. The decision with reject_submission follows as decision.created; show its statement of reasons. The author can complain. |
decisionId only with restricted and rejected; decision.created may arrive first and carries decision.reviewId. The event contains neither content nor author; match it via review.id or externalReviewId. A complaint can later lead to a new decision (restore with restoreScope: "content": publish as submitted; or restrict_content after a rejection), which comes as appeal.resolved plus decision.created, never as a second review.decided.
test.ping
Sent only by Send test webhook in the dashboard. Acknowledge with 2xx within 5 seconds (the test waits less than the 10 seconds of real deliveries).
{ "id": "evt_01K6…", "type": "test.ping", "createdAt": "2026-10-01T10:00:00.123456Z", "app": { "id": "01K6…", "slug": "photoapp" } }