/api/qmail/db/tells/list-pending

GET

List rows in the local pending tells queue — outbound notifications that QMail intends to deliver to recipients via the beacon. Filterable by status.

http://localhost:8081/api/qmail/db/tells/list-pending

Description

"Tells" are the small notification records the beacon delivers — they let a recipient know that a new email is available to download from the QMail-7 storage servers. This endpoint is the inspection view for that retry queue.

Parameters

ParamTypeRequiredDescription
statusstringNoFilter to one of pending, sent, or failed. Omit to list all.

Response

{
  "command": "tells-list-pending",
  "success": true,
  "count": 1,
  "pending_tells": [
    {
      "tell_id": 42,
      "file_guid": "0c4f8e2a91b34d57a76e1d2c3b4a5968",
      "recipient_sn": 9001,
      "recipient_denomination": 1,
      "beacon_raida": 11,
      "status": "failed",
      "retry_count": 3,
      "last_error": "timeout",
      "created_at": 1714083000,
      "last_attempt": 1714083600
    }
  ]
}

last_error is omitted when empty.

Errors

HTTPMessage
500Failed to query pending tells

Example

curl "http://localhost:8081/api/qmail/db/tells/list-pending?status=failed"

Related