Skip to content

docs: Add Themes API endpoint documentation (#471)#482

Open
khawarlatifkhan wants to merge 13 commits into
mautic:7.0from
Promptless:promptless/issue-471-themes-api-page
Open

docs: Add Themes API endpoint documentation (#471)#482
khawarlatifkhan wants to merge 13 commits into
mautic:7.0from
Promptless:promptless/issue-471-themes-api-page

Conversation

@khawarlatifkhan
Copy link
Copy Markdown

Migrates the Themes REST API documentation from legacy markdown to RST format. Content verified against Mautic 7.0 source code. Documents all endpoints (get, list, create, delete) with detailed response properties.

promptless Bot and others added 2 commits May 3, 2026 23:14
Migrate Themes REST API documentation from legacy markdown to RST format.
Content verified against Mautic 7.0 source code (ThemeApiController.php
and ThemeHelper.php). Documents all endpoints: get, list, create, delete.
Adds detailed response properties including theme config fields.
Co-authored-by: promptless[bot] <promptless[bot]@users.noreply.github.com>
@promptless-for-oss promptless-for-oss force-pushed the promptless/issue-471-themes-api-page branch from 614b540 to 749cc08 Compare May 3, 2026 23:30
@khawarlatifkhan khawarlatifkhan requested review from a team, adiati98 and favour-chibueze May 3, 2026 23:30
Comment thread docs/rest_api/themes.rst
@@ -1,14 +1,284 @@
Themes
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 endpoint documentation structure, PHP code examples, and JSON response examples from the legacy _api_endpoint_themes.md file.

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

Comment thread docs/rest_api/themes.rst
}

**Response Properties**

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 API endpoints and behavior against ThemeApiController.php in Mautic 7.0 source. Confirmed newAction, getAction, listAction, and deleteAction methods match documented endpoints.

Source: https://github.com/mautic/mautic/blob/7.x/app/bundles/CoreBundle/Controller/Api/ThemeApiController.php

Comment thread docs/rest_api/themes.rst

* - Name
- Type
- Description
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Added response properties (name, key, config, builder) and documented default theme deletion behavior based on ThemeHelper.php. The getInstalledThemes() method returns theme details with config; default themes are hidden rather than deleted.

Source: https://github.com/mautic/mautic/blob/7.x/app/bundles/CoreBundle/Helper/ThemeHelper.php

@adiati98
Copy link
Copy Markdown
Contributor

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

@adiati98 adiati98 requested a review from a team May 11, 2026 08:39
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 fine 👍

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