API v1
v1
View as Markdown

List what’s new

GET /api/v1/changelog-entries

List the changes published over the last 30 or 90 days, newest day first.

Within a day, features and improvements come before fixes, each newest first. A change scheduled for later is left out until it is published. Reading the list does not mark anything as seen.

This endpoint also answers QUERY, with the same parameters sent in the request body. How QUERY works.

Query parameters

Sent as JSON. Anything not listed here is ignored.

period integer Optional default: 30

How many days back to reach: 30 or 90. Any other value reads as 30.

page integer Optional default: 1

Which page to answer with.

per_page integer Optional default: 25

How many records one page holds, between 1 and 100. A number outside the range is brought back into it rather than refused.

Returns

A page of change objects, how many there are in all, and in meta what the period holds.

data array

The changes on this page. An empty list rather than an error when there are none.

data[] object

One change.

data[].type string

Always changelog_entry. It names the kind of record, so a caller holding several kinds can tell them apart without looking at where they came from.

data[].id string

The id of this record, as a string even when it reads as a number. It is what every endpoint naming this record takes.

data[].attributes object

Everything the record holds.

data[].attributes.entry_type string

feature, improvement or fix.

data[].attributes.area string

The part of the product the change touches, in your language, or null.

data[].attributes.title string

What changed, in one line, in your language.

data[].attributes.body string

The explanation, as Markdown, in your language.

data[].attributes.body_html string

The same explanation, turned into HTML.

data[].attributes.link string

The absolute address of the screen the change concerns, or null.

data[].attributes.day date

The day the change was published, as YYYY-MM-DD, in UTC.

data[].attributes.is_seen boolean

Whether you have seen it. A change published before you joined counts as seen.

data[].attributes.my_vote string

up or down when you voted on the change, or null.

data[].attributes.comment_count integer

How many comments everybody can read under the change. Private comments and comments hidden by an administrator are not counted.

data[].attributes.published_at timestamp

When the change was published, as a count of seconds since 1970.

meta object

Where you are in the collection.

meta.page integer

The page this is, counting from 1.

meta.per_page integer

How many one page holds, which is the size that was asked for once it has been brought into the allowed range.

meta.total integer

How many changes there are in all, not how many are on this page.

data[].links object

Where to find more about this change.

data[].links.comments string

The absolute address the comments of the change are read from.

data[].links.web string

The What’s new screen in the application, which opens for somebody signed in rather than for a key. It is the link to give a person.

meta.period integer

How many days back the list reaches: 30 or 90.

meta.unseen_count integer

How many published changes you have not seen yet, over the whole history rather than the period.

meta.days integer

On how many different days the changes of the period were published.

meta.features integer

How many changes of the period are features.

meta.improvements integer

How many changes of the period are improvements.

meta.fixes integer

How many changes of the period are fixes.

Rate limit

Sixty requests per minute, per user, shared by every key and device. Every answer carries the budget left in X-RateLimit-Remaining.

GET
curl https://my.monicahq.com/api/v1/changelog-entries \
-H "Authorization: Bearer $MONICA_TOKEN"
const response = await fetch('https://my.monicahq.com/api/v1/changelog-entries', {
headers: { Authorization: `Bearer ${token}` },
})
const data = await response.json()
$response = Http::withToken($token)->get('https://my.monicahq.com/api/v1/changelog-entries');
Response 200
{
"data": [
{
"type": "changelog_entry",
"id": "01M7NBFWK5XNH908RFDGEAJXKN",
"attributes": {
"entry_type": "feature",
"area": "Contacts",
"title": "Book the conference room from a contact",
"body": "Michael can now book the conference room **straight** from a contact page.",
"body_html": "<p>Michael can now book the conference room <strong>straight</strong> from a contact page.</p>",
"link": "https://my.monicahq.com/vaults",
"day": "2026-11-16",
"is_seen": false,
"my_vote": "up",
"comment_count": 2,
"published_at": 1794819600
},
"links": {
"comments": "https://my.monicahq.com/api/v1/changelog-entries/01M7NBFWK5XNH908RFDGEAJXKN/comments",
"web": "https://my.monicahq.com/changelog"
}
},
{
"type": "changelog_entry",
"id": "01M7NBFWK7BEESY8WABBMXF3E6",
"attributes": {
"entry_type": "fix",
"area": "Contacts",
"title": "The fax machine no longer eats long notes",
"body": "A note longer than 10,000 characters lost its last paragraph.",
"body_html": "<p>A note longer than 10,000 characters lost its last paragraph.</p>",
"link": null,
"day": "2026-11-16",
"is_seen": true,
"my_vote": null,
"comment_count": 0,
"published_at": 1794816000
},
"links": {
"comments": "https://my.monicahq.com/api/v1/changelog-entries/01M7NBFWK7BEESY8WABBMXF3E6/comments",
"web": "https://my.monicahq.com/changelog"
}
}
],
"meta": {
"page": 1,
"per_page": 25,
"total": 2,
"period": 30,
"unseen_count": 1,
"days": 1,
"features": 1,
"improvements": 0,
"fixes": 1
}
}

Keys act as you, with exactly the access you have. Make one per integration so you can revoke it alone.