APIXX.flow logo
Back to app
Operations

Error Inbox

A single place to review every integration error, the offending payload, and the upstream system that rejected it.

What it covers

The Error Inbox at /errors consolidates every failure across your account into one triage view. Each row shows the failing flow, the source system, the error code & message, and a sample of the payload that caused the failure.

Error sources

SourceTagWhat's captured
FlowenterpriseRun-level failures and per-record rejections from the flow error bucket.
ConnectorlambdaErrors logged by the connector Lambda when the destination API rejects a record.
Ingestion APIingestEvents posted to /api/public/data/ingest that the normalizer rejected (422).

How errors are collected

A scheduled error-sweep-tick job runs every few minutes. It scans recently errored runs from the flow cache, reads the error files written to S3, extracts the payload + error message from each rejected record, and writes them to the data_run_error table along with any ingestion-API rejections.

Live payload
The full payload stays in S3. The inbox stores a 4 KB excerpt for fast browsing plus the S3 reference so you can pull the original record from the run detail page.

Deduplication & counts

Errors are deduplicated by a content hash of (source, run, code, message, payload fingerprint). Repeated occurrences increment the occurrence count and update last seenrather than creating duplicate rows.

Acknowledging errors

Open the detail page and choose Acknowledge once an error has been reviewed or fixed. Filtering by Open hides acknowledged rows so triage stays focused. Acknowledgement is reversible.

Retention

The sweep job looks back 24 hours. Stored errors persist indefinitely until manually cleared — recurring failures will refresh the last seen timestamp on the existing row.