Skip to content
PayloadPuffin.
Join the waitlist

Rerun an unbuilt event

POST/v1/events/{eventId}/rerunpreview

Build an unbuilt event again from the request its source stored, with the source’s transform as published now. A request stored after failing the source’s signature verification is checked again first, against the signature settings as they are now and with the timestamp tolerance measured from when it was received. Answers 202 at once; the event stays unbuilt until the build finishes. Refused with 409 when the event is already built, past its app’s retention, or still fails signature verification, which becomes its new reason.

Path parameters

  • eventId string Required

    An event ID, starting with evt_.

Returns

202

Queued: the event is built again shortly. It stays unbuilt until then.

  • data object Required

    Receipt: the event is queued to be built again. It stays unbuilt until the build succeeds, or gets a new reason if it fails again.

    • eventId string Required

      An event ID, starting with evt_.

Example

Request
curl -X POST "https://api.payloadpuffin.com/v1/events/$EVENTID/rerun" \
  -H "Authorization: Bearer $PAYLOADPUFFIN_API_KEY"
Response 202
{
  "data": {
    "eventId": "eventId"
  }
}

Errors

Errors use application/problem+json. The code member is stable; branch on it rather than on title or detail.

  • 4XX application/problem+json

    The request was rejected.