Skip to content

Failure Reporting & Outbound Queue

Failure Reporting Endpoints

POST /api/v1/failures

Report a sync failure. Triggers webhook notifications to the opposite system.

{
  "entity_type": "product",
  "external_id": "PROD-001",
  "middleware_id": 1,
  "source": "webshop",
  "error_message": "Validation failed: price is required",
  "error_details": [{ "field": "price", "message": "Required" }],
  "raw_data": { "..." : "..." }
}

GET /api/v1/failures

List failures with optional filters: entity_type, status (open/resolved), source (odoo/webshop).

GET /api/v1/failures/{id}

Full failure details including raw_data.

POST /api/v1/failures/{id}/resolve

Manually resolve a failure.

Outbound Queue Endpoints

GET /api/v1/outbound-queue/stats

Queue status counts (pending, processing, completed, failed).

GET /api/v1/outbound-queue

List queue items with optional status filter.

POST /api/v1/outbound-queue/{id}/retry

Retry a single failed item.

POST /api/v1/outbound-queue/retry-failed

Retry all failed items (optionally limited by maxAttempts).