Skip to content
LionrapidLionrapid Docs

Get Dead Letter Queue

GET
/api/integrations/sync/dead-letter-queue
curl --request GET \
  --url https://app.lionrapid.com/api/integrations/sync/dead-letter-queue

Get all jobs in the dead letter queue.

Jobs end up in the DLQ after:

  • Exhausting all retry attempts (default: 3)
  • Encountering non-retriable errors (validation, permission, etc.)

Returns: List of dead-lettered jobs with error details

Example: GET /sync/dead-letter-queue

→ Returns: {
    "jobs": [
        {
            "job_id": "...",
            "status": "failed",
            "dead_letter_reason": "Max retries (3) exceeded",
            "retry_errors": ["Database locked", "Connection timeout", ...]
        }
    ],
    "total": 1
}

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
surface
Any of:
string

Header Parameters

Section titled “Header Parameters”
x-api-key
Any of:
string
x-lr-surface
Any of:
string

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

Media typeapplication/json
Examplegenerated
example

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}