Skip to main content
POST
/
v1
/
admin
/
dlq
/
{failure_id}
/
retry
Retry a dead-letter failure
curl --request POST \
  --url https://api.withsplendor.com/v1/admin/dlq/{failure_id}/retry \
  --header 'Authorization: Bearer <token>' \
  --header 'x-splendor-tenant-id: <x-splendor-tenant-id>'
{
  "failure": {
    "committed_batch_count": 0,
    "committed_document_count": 0,
    "dataset_id": "app-logs",
    "error_message": "Failed to parse record at line 10",
    "error_type": "ParseError",
    "failed_at": "2026-01-15T09:30:00Z",
    "failed_document_count": 1,
    "failed_document_offset": 10,
    "failure_id": 1,
    "format": "jsonl",
    "last_retry_at": null,
    "repair_kind": null,
    "repair_started_at": null,
    "retry_count": 0,
    "retryable": true,
    "s3_bucket": "acme-logs",
    "s3_etag": "\"5d41402a\"",
    "s3_key": "2026/01/15/app-bad.jsonl.gz",
    "source": "app-logs",
    "source_id": 12,
    "status": "failed",
    "tenant_id": "acme"
  },
  "message_id": "msg_1"
}

Authorizations

Authorization
string
header
required

API token issued from the Splendor console.

Headers

x-splendor-tenant-id
string
required

Selects the tenant (workspace) the request acts within.

Path Parameters

failure_id
integer
required

Query Parameters

tenant_id
string
required
Minimum string length: 1

Response

Successful Response

failure
IngestFailureItem · object
required
Example:
{
"committed_batch_count": 0,
"committed_document_count": 0,
"dataset_id": "app-logs",
"error_message": "Failed to parse record at line 10",
"error_type": "ParseError",
"failed_at": "2026-01-15T09:30:00Z",
"failed_document_count": 1,
"failed_document_offset": 10,
"failure_id": 1,
"format": "jsonl",
"last_retry_at": null,
"repair_kind": null,
"repair_started_at": null,
"retry_count": 0,
"retryable": true,
"s3_bucket": "acme-logs",
"s3_etag": "\"5d41402a\"",
"s3_key": "2026/01/15/app-bad.jsonl.gz",
"source": "app-logs",
"source_id": 12,
"status": "failed",
"tenant_id": "acme"
}
message_id
string | null
required