GuidesWebhooksPayload & Retries

Each webhook payload includes metadata to trace runs end-to-end.

{
  "id": "evt_8Y2hP",
  "type": "processor.run.completed",
  "created_at": "2025-09-26T08:34:12Z",
  "data": {
    "processor_id": "invoice-extractor",
    "run_id": "run_42mLQ",
    "status": "succeeded",
    "output_uri": "https://api.algorythmos.fr/files/run_42mLQ.json"
  }
}

Retry policy

  • We retry up to 9 times over 24 hours using exponential backoff.
  • Retries stop once your endpoint returns any 2xx response.
  • After the final failure, we email workspace admins and mark the delivery dead.

Best practices

  • Acknowledge quickly with 202 Accepted and process data asynchronously.
  • Log the id field to deduplicate retries.
  • Rotate endpoint secrets regularly from Console → Settings → Webhooks.

You can re-send payloads manually from the console or via POST /webhooks/deliveries/{delivery_id}/retry.