replay_limit_reached

{
  "error": {
    "code": "replay_limit_reached",
    "message": "Delivery del_xyz789 has been replayed 3 times in the last hour.",
    "fix": "Wait until next_replay_allowed_at, then replay again. If the same delivery keeps failing, fix the receiving endpoint first — replaying will not change the result.",
    "docs_url": "https://repull.dev/docs/errors/replay_limit_reached",
    "request_id": "req_01J5X7Y8Z9ABCDEF12345678",
    "replays_made": 3,
    "replay_limit": 3,
    "next_replay_allowed_at": "2026-06-15T15:30:00Z"
  }
}

# The 4th replay inside the window
curl -X POST https://api.repull.dev/v1/webhooks/wh_abc123/deliveries/del_xyz789/replay \
  -H "Authorization: Bearer sk_live_YOUR_KEY"
# HTTP/1.1 409 Conflict
# Retry-After: 2280
# { "error": { "code": "replay_limit_reached", "next_replay_allowed_at": "2026-06-15T15:30:00Z", ... } }

# What did the endpoint actually return on the failures?
curl "https://api.repull.dev/v1/webhooks/wh_abc123/deliveries?status=failed" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

# Confirm the endpoint is healthy again — test events do not use replay budget
curl -X POST https://api.repull.dev/v1/webhooks/wh_abc123/test/reservation.created \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

# After the window clears, replay once more
curl -X POST https://api.repull.dev/v1/webhooks/wh_abc123/deliveries/del_xyz789/replay \
  -H "Authorization: Bearer sk_live_YOUR_KEY"
# HTTP/1.1 200 OK
# { "id": "del_new456", "replayNumber": 1, "replaysRemaining": 2, "nextWindowResetAt": "..." }

const API = 'https://api.repull.dev'
const headers = {
  Authorization: `Bearer ${process.env.REPULL_API_KEY}`,
  'Content-Type': 'application/json',
}

async function replayDelivery(webhookId: string, deliveryId: string) {
  const res = await fetch(
    `${API}/v1/webhooks/${webhookId}/deliveries/${deliveryId}/replay`,
    { method: 'POST', headers },
  )

  if (res.status === 409) {
    const { error } = await res.json()
    if (error.code === 'replay_limit_reached') {
      // Scoped to this delivery only — keep replaying other deliveries.
      // Do not chain onto the delivery a previous replay produced: same budget.
      const retryAfter = Number(res.headers.get('Retry-After') ?? 60)
      throw new ReplayBlocked(deliveryId, retryAfter, error.next_replay_allowed_at)
    }
  }

  const delivery = await res.json()
  if (delivery.replaysRemaining === 0) {
    console.warn(`No replays left for ${deliveryId} until ${delivery.nextWindowResetAt}`)
  }
  return delivery
}

class ReplayBlocked extends Error {
  constructor(
    readonly deliveryId: string,
    readonly retryAfterSeconds: number,
    readonly nextAllowedAt: string,
  ) {
    super(`Replay budget spent for ${deliveryId}; next attempt at ${nextAllowedAt}`)
  }
}