REST API · dlq

GET /dlq

Paginated DLQ entries for this project, newest first. Mirrors `list_dlq` MCP tool. Query: `limit`, `offset`.

get_api_dlq_list

Authentication

• Bearer

Responses

200

Paginated dead-letter entries.

application/json

{
    "properties": {
        "rows": {
            "type": "array",
            "items": {
                "properties": {
                    "configVersion": {
                        "description": "Published config that authorised the delivery; 0 means unstamped.",
                        "type": "integer",
                        "minimum": 0
                    },
                    "failureCode": {
                        "description": "Stable machine-readable cause of the failure. `unclassified` for an entry written before codes existed.",
                        "type": "string",
                        "enum": [
                            "target_rejected",
                            "invalid_target_url",
                            "signing_failed",
                            "egress_refused",
                            "retries_exhausted",
                            "credential_destination_mismatch",
                            "credential_project_mismatch",
                            "credential_service_unavailable",
                            "credential_unavailable",
                            "contract_version_unsupported",
                            "undecodable_entry",
                            "internal",
                            "unclassified"
                        ]
                    }
                },
                "type": "object"
            }
        }
    },
    "type": "object"
}

{
    "total": 4,
    "limit": 50,
    "offset": 0,
    "rows": [
        {
            "id": "1768464000123-0",
            "requestId": "a1b2c3d4-5e6f-4a1b-8c2d-9e0f1a2b3c4d",
            "targetId": "b2c3d4e5-6f7a-4b2c-8d3e-0f1a2b3c4d5e",
            "configVersion": 7,
            "failureReason": "maxRetriesExhausted: http503",
            "failureCode": "retries_exhausted",
            "failedAttempts": "3",
            "failedAt": "1768464300000",
            "payload": "{\"event\":\"lifecycle.updated\"}"
        }
    ],
    "evictedCount": 0
}