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:

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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 by decisionId.
  • System reports are not included. A later change after a complaint sends no new reports.resolved.
  • Map items via externalReportId (or reportId from the 201 response) to your reports and users, tell them the outcome in short (e.g. “No violation found” for dismiss, “The content was removed” for remove_content) and that they can complain until appealDeadline (POST /v1/appeals with appellant.type: "reporter" and this decisionId). You write these texts yourself.

appeal.resolved

A moderator decided on a complaint.

JSON
{
  "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.

JSON
{
  "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).

JSON
{ "id": "evt_01K6…", "type": "test.ping", "createdAt": "2026-10-01T10:00:00.123456Z", "app": { "id": "01K6…", "slug": "photoapp" } }