List Outbox Failures

GET 
/api/ledger/outbox/failures

Paginated terminally-failed ledger_outbox rows for the dashboard failures drill-down, newest failure first (processed_at carries the failure timestamp for failed rows).

Authorization

Any valid API token can call this endpoint — no specific scope required. Manage tokens.

Authentication: Requires Bearer token.

Pagination: per_page (default 10, clamped to 100), page. Standard Laravel pagination envelope.

Each row:

• source — the source-document cross-link resolved from source_type/source_id (NOT hydrated — failed rows often point at since-deleted documents, so label/link_route may be null; link_type_label always renders).
• event — the failed source event (created | updated | deleted) with a headline label.
• attempts — how many drain attempts were exhausted before the row terminated.
• last_error — the preserved error text (capped at 60 KB).
• failed_at / available_at / created_at — ISO-8601 timestamps.

Request

Responses

200

OK

Response Headers

Content-Type

401

Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.

403

Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.

429

Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.