Skip to content

docs: Add Stats API endpoint documentation (#463)#480

Open
tlfranko-star wants to merge 15 commits into
mautic:7.0from
Promptless:promptless/issue-463-stats-api-page
Open

docs: Add Stats API endpoint documentation (#463)#480
tlfranko-star wants to merge 15 commits into
mautic:7.0from
Promptless:promptless/issue-463-stats-api-page

Conversation

@tlfranko-star
Copy link
Copy Markdown
Contributor

Open this suggestion in Promptless to view citations and reasoning process

Migrated the Stats API documentation from legacy markdown to RST format, verified against Mautic 7.0 source code. Updated the table list to reflect the 29 stat tables available in 7.0. Added PHP/HTTP examples, query parameters, and categorized table reference. Fixed column widths on all Response properties tables to prevent text wrapping mid-word.

promptless Bot and others added 3 commits May 3, 2026 22:08
Migrate and update Stats API docs from legacy markdown to RST format.
Verified all table names and columns against Mautic 7.0 source code.
Add :widths: directive to list-table definitions to prevent narrow columns
that cause text to wrap mid-word in the rendered output.
Co-authored-by: promptless[bot] <promptless[bot]@users.noreply.github.com>
Comment thread docs/rest_api/stats.rst
@@ -1,14 +1,424 @@
Stats
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ported core API structure, code examples, and response formats from legacy documentation. Updated table list based on verification against Mautic 7.0 source.

Source: https://github.com/mautic/developer-documentation/blob/main/source/includes/_api_endpoint_stats.md

@tlfranko-star tlfranko-star requested a review from a team May 3, 2026 22:42
@promptless-for-oss promptless-for-oss force-pushed the promptless/issue-463-stats-api-page branch from 0d0be2d to c073c74 Compare May 3, 2026 22:42
Comment thread docs/rest_api/stats.rst

<?php

$where = [
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Verified StatsApiController.php handles /stats/{table} route with start, limit, order, and where query parameters. Confirmed default limit of 100 rows.

Source: https://github.com/mautic/mautic/blob/7.0/app/bundles/CoreBundle/Controller/Api/StatsApiController.php

promptless Bot added 2 commits May 3, 2026 23:54
Per Mautic style guide, capitalize product terms:
- Channel in table descriptions
- Dynamic Content in section header
@adiati98
Copy link
Copy Markdown
Contributor

@mautic/core-team can you please help review the content? TIA! ✨

@adiati98 adiati98 requested a review from a team May 11, 2026 08:35
Copy link
Copy Markdown
Member

@escopecz escopecz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great! 👍

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants