pub.chive.admin.listDLQEntries Documentation (EN)

main query

List entries from the firehose dead-letter queue

Parameters

limit integer Optional

Maximum number of entries

offset integer Optional

Number of entries to skip

Output

Encodingapplication/json

entries array Required

DLQ entries

total integer Required

Total entries in the DLQ

Errors

AuthenticationRequired

AdminRequired

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Service Endpoint Base URL for XRPC calls (e.g., https://api.bsky.social)

Parameters

limit Maximum number of entries

offset Number of entries to skip

View raw schema

{
  "description": "List entries from the firehose dead-letter queue",
  "errors": [
    {
      "name": "AuthenticationRequired"
    },
    {
      "name": "AdminRequired"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "entries": {
          "description": "DLQ entries",
          "items": {
            "ref": "#dlqEntry",
            "type": "ref"
          },
          "type": "array"
        },
        "total": {
          "description": "Total entries in the DLQ",
          "type": "integer"
        }
      },
      "required": [
        "entries",
        "total"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "limit": {
        "default": 50,
        "description": "Maximum number of entries",
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      },
      "offset": {
        "default": 0,
        "description": "Number of entries to skip",
        "minimum": 0,
        "type": "integer"
      }
    },
    "type": "params"
  },
  "type": "query"
}

dlqEntry object

Dead-letter queue entry

Properties

createdAt string datetime Required

When the entry was created

did string did Optional

DID of the event source

errorMessage string Optional

Error detail message

errorType string Required

Error classification

id string Required

Entry ID

lastRetryAt string datetime Optional

Last retry attempt timestamp

retryCount integer Required

Number of retry attempts

uri string at-uri Optional

AT URI of the failed event

View raw schema

{
  "description": "Dead-letter queue entry",
  "properties": {
    "createdAt": {
      "description": "When the entry was created",
      "format": "datetime",
      "type": "string"
    },
    "did": {
      "description": "DID of the event source",
      "format": "did",
      "type": "string"
    },
    "errorMessage": {
      "description": "Error detail message",
      "type": "string"
    },
    "errorType": {
      "description": "Error classification",
      "type": "string"
    },
    "id": {
      "description": "Entry ID",
      "type": "string"
    },
    "lastRetryAt": {
      "description": "Last retry attempt timestamp",
      "format": "datetime",
      "type": "string"
    },
    "retryCount": {
      "description": "Number of retry attempts",
      "type": "integer"
    },
    "uri": {
      "description": "AT URI of the failed event",
      "format": "at-uri",
      "type": "string"
    }
  },
  "required": [
    "id",
    "errorType",
    "createdAt",
    "retryCount"
  ],
  "type": "object"
}