Poor Notifications API documentation

I’m trying to write an API wrapper for the Swift Forums, which is a Discourse instance. I’m looking at the Discourse API documentation, and it only lists one endpoint under Notifications.

For one, why doesn’t it have any parameters listed? Is there no “limit” argument? Digging around the internet seems to suggest there is, and it’s just not documented.

Secondly, surely there are missing endpoints here. Is there not an endpoint for marking notification(s) as read? Or even marking them all read?


Have you looked at How to reverse engineer the Discourse API ? This should be your very first port of call.


I already have, but why isn’t it documented?

If you’d like to submit a pull request to add to the documentation, feel free to do so.


Will do! Didn’t know that was how it works here :sweat_smile:

1 Like