Content

List changelog entries

Lists a site's published changelog entries in one language, newest first. Entries some readers cannot see are left out, and only the 1,000 newest can be listed.

GET
/sites/{site_id}/changelog
cURL
curl --request GET \
  --url 'https://api.notiondesk.so/sites/{site_id}/changelog' \
  --header 'Authorization: Bearer <token>'

Authorizations

  • Authorizationstringheader

    api_key · http · bearer

    read
  • Authorizationstringheader

    oauth · oauth2

    read

Path parameters

  • site_idstringrequired

    The id of a site from List sites.

Query parameters

  • page_sizeinteger

    How many items a page holds. You may change it between pages; the next page starts where the previous one ended.

  • cursorstring

    The next_cursor of the previous page, passed back unchanged. The cursor is opaque; do not parse it or build one yourself.

  • localestring

    A language the site serves, from supported_locales in Get a site. Defaults to the site's default_locale; an empty value reads the default.

Headers

  • nd-versionstring

    The contract version your integration was written against. Without it, the request uses the current version. An unknown value answers 400 invalid_version.

Responses

A page of changelog entries in the requested language.

Headers

  • nd-versionstring

    The contract version that answered the request.

  • X-RateLimit-Limitinteger

    Requests allowed per minute: 120 for GET, 20 for writes, per key or OAuth grant.

  • X-RateLimit-Remaininginteger

    Requests left in the current window.

  • Retry-Afterinteger

    Seconds until the next request is accepted; 0 while requests remain.

  • objectstringrequired
  • datarequired
  • has_morebooleanrequired
  • next_cursorstring | nullrequired

    Pass it back as cursor to read the next page; null on the last page.