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

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

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

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