[wstrinz]

Part of: https://dripcom.atlassian.net/browse/GG-2099

Documents changes here:

• https://github.com/DripEmail/drip/pull/31971

Documents the limit argument on fetching email metrics (default 100, 1 to 1,000), the new emails_total and emails_truncated response fields, and that emails is ordered by sends, highest first.

🤖 Generated with Claude Code

[Copilot]

🔵 Needs a closer look

The linked implementation PR returned 404, leaving the documented limit validation, tie-breaking order, and response semantics unverified until a reviewer with access can check them.

No open issues 🎉

What changed in this PR

Updates the REST API documentation to describe result limits and response metadata for fetching email metrics.

Changes:

• Documents limit with a default of 100 and an allowed range of 1–1,000, without affecting summary totals.
• Adds emails_total and emails_truncated to response examples and explains truncation.
• Clarifies ordering by sends descending, then email_id ascending, and the lack of pagination.

File	Description
source/​includes/​rest/​_metrics.md	Documents email metric limits, response metadata, ordering, and retrieval constraints.

_{Review effort: Balanced}