Changelogs

The Changelog API allows you to fetch the changelogs that you have created in Mantle, so you can display them on your own external website. The changelog API allows you to request your changelog in both JSON or RSS formats.

You can create new changelogs in the Mantle admin, by going to your app, clicking on the Changelog tab, and then clicking on the Add entry button to create a new entry. Once you have created a changelog entry, you can fetch it using the API using the links at the bottom of the page.

Fetching JSON changelogs

https://app.heymantle.com/api/apps/[YOUR_APP_ID]/changelog?format=json

{
  entries: [
    {
      id: "CHANGELOG_ENTRY_ID",
      appId: "YOUR_APP_ID",
      organizationId: "YOUR_ORG_ID",
      date: "2024-05-07T11:36:35.000Z",
      title: "Added changelog API to Mantle",
      description: "You can now fetch your changelogs from Mantle using the Mantle API!",
      tags: [
        "Reporting",
        "changelog"
      ],
      createdAt: "2024-05-07T11:41:41.850Z",
      updatedAt: "2024-05-07T11:41:41.850Z"
    },
    ...
  ]
}

Fetching RSS changelogs

https://app.heymantle.com/api/apps/[YOUR_APP_ID]/changelog

<?xml version="1.0" encoding="UTF-8"?>
<rss>
  <channel>
    <title><![CDATA[Changelog for Your App]]></title>
    <description><![CDATA[Changelog for Your App]]></description>
    <link>app.heymantle.com</link>
    <generator>RSS for Node</generator>
    <lastBuildDate>Tue, 07 May 2024 15:18:29 GMT</lastBuildDate>
    <atom:link href="app.heymantle.com/api/[YOUR_APP_ID]/changelog" rel="self" type="application/rss+xml"/>
    <pubDate>Tue, 07 May 2024 15:18:29 GMT</pubDate>
    <language><![CDATA[en]]></language>
    <ttl>60</ttl>
    <item>
        <title><![CDATA[Added changelog API to Mantle]]></title>
        <description><![CDATA[You can now fetch your changelogs from Mantle using the Mantle API!]]></description>
        <guid isPermaLink="false">Added changelog API to Mantle</guid>
        <pubDate>Tue, 07 May 2024 11:36:35 GMT</pubDate>
    </item>
  </channel>
</rss>