Appearance
Get spool stats
GET /spools/{spool}/stats
The spool-level rollup: queue count and message counts summed across every queue, with total being the cap-enforced count. Counts are a snapshot, not a live read.
Sample
sh
curl -X GET "$SPOOLER_API/spools/<spool>/stats" \
-H "Authorization: Bearer $SPOOLER_KEY"Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
spool | path | IdentName, 1–64 chars, ^[A-Za-z0-9_:-]+$ | yes | The spool name. |
Responses
| Status | Description |
|---|---|
200 | The spool's rollup. |
400 | The request is malformed; the kind names the problem. |
401 | The API key is missing or not recognized. |
402 | The account is suspended. |
403 | A plan limit refuses the operation; the kind names it. |
404 | The spool or queue does not exist; the kind says which. |
429 | The per-account request rate cap is exceeded; retry after the Retry-After delay. |
503 | The spool is momentarily unavailable. |
429 headers
| Header | Description |
|---|---|
Retry-After | Seconds until the next request is admitted. |