Skip to content
Developers
Get an API token

List releases and what changed

Releases, newest first, as the app's changelog lists them; since=0.13 gives what changed after v0.13.

List releases and what changed

GET/changelog

Releases, newest first, as the app's changelog lists them; since=0.13 gives what changed after v0.13. It changes only with a deploy, so it carries an ETag.

Send a Novi API token as a bearer token on every request. Authentication
The answer

This build's version and api_version; unreleased, what is merged and deployed but not released (the same on every page); then each release's version, git tag, date and entries. An entry has its tag (New, Change, Fix or Remove), its text and prs, the pull requests its trailing (#N) names, which text leaves out.

Parameters

Query parameters

  • sincestringOptional

    pattern ^v?(0|[1-9][0-9]*)\.(0|0[1-9]|[1-9][0-9])$

    Only releases newer than this version, as 0.13 or v0.13.

  • limitintegerOptional

    Default 20≥ 1, ≤ 100

    Releases per page.

  • cursorstringOptional

    Page to read: next_cursor from the previous page.

Responses

200 OK

Releases, newest first.

  • versionstringRequired

    This build's version (VERSION, MAJOR.NN), as 0.15: the newest release.

  • api_versionstringRequired

    API version, as GET /health reports it.

  • unreleasedarray of objectsRequired

    Merged and deployed with this build but not released yet, in the order the next release will list them; the same on every page.

    ShowHide 3 child fields in each item
    • tagstringRequired

      Kind of change.

      "New""Change""Fix""Remove"
    • textstringRequired

      The entry as written, without its trailing pull request reference.

    • prsarray of integersRequired

      Pull requests the entry names at its end, as (#19) or (#14, #15); empty when it names none.

  • releasesarray of objectsRequired

    This page of releases (newer than since, when given), newest first.

    ShowHide 4 child fields in each item
    • versionstringRequired

      Version, MAJOR.NN, as 0.15.

    • tagstringRequired

      Its git tag, as v0.15.

    • datestringRequired

      Format date

      Release date (UTC).

    • entriesarray of objectsRequired

      at least 1 items

      What the release changed, in changelog order.

      Same fields as ChangelogEntry.

  • next_cursorstring or nullRequired

    Cursor for the next page, null on the last.

Conditional requests 304 Unchanged since the ETag in If-None-Match.

Errors

StatusWhen
503

This build is missing VERSION or CHANGELOG.md.

Shared errors400401403500What they mean