post.rejected - letmepost.dev

Fires when the post will not be retried — preflight, platform rejection, or platform auth failure. Distinct from post.failed, which is a transient failure that the worker may retry.

Payload

post.rejected.json

{
  "id": "evt_...",
  "type": "post.rejected",
  "data": {
    "id": "post_...",
    "platform": "instagram",
    "accountId": "...",
    "profileId": "...",
    "error": {
      "code": "preflight_failed",
      "rule": "instagram.media.reachable",
      "message": "Instagram couldn't fetch the media URL.",
      "remediation": "Upload via POST /v1/media first..."
    },
    "rejectedAt": "2026-05-04T15:30:00Z"
  }
}

The error shape mirrors the API’s HTTP error body. code is one of preflight_failed, platform_auth_failed, or platform_rejected.

Use it for

Surface “rejected” state in the post log.
Page the user with the remediation when their action is required.
Capture metrics on rule frequency — the most-fired rules become candidates for tighter local validation.

Errors — the full error envelope.
post.failed — the transient cousin.