# mail_queue

> Show the mail queue for a customer's server — messages waiting to send and why.

- Tier: R
- Required scope: read:email
- Annotations: readOnlyHint, idempotentHint, openWorldHint
- Docs: https://api.inleed.com/tools/mail-queue

## Description

Show the mail queue for a customer's server — messages waiting to send and why. Returns queued messages (`id`, `age`, `size`, `sender`, `recipients`, `frozen`, `reason`) with `total` and `frozen` counts; pass a domain or email as `input` to narrow it. This is the server-wide backlog — to trace one message's delivery verdict use `trace_email`, and for raw log lines use `read_logs` with `kind=email`. Read over SSH on the hosting node: on a box without shell access it returns `degraded:true` with a note rather than failing.

## Input schema

- `input` — string (required). The domain, email or account whose server queue to read — a domain, email, URL or Inleed service id. A domain or email narrows the queue to messages to or from it; the resolved target is echoed back.
- `limit` — integer. Max queued messages to return (default 50). Range 1–200.

## Example call

```json
{
  "name": "mail_queue",
  "arguments": {
    "input": "example.se"
  }
}
```