Skip to main content
GET
Compare two releases

Authorizations

Authorization
string
header
required

A project token (apsio_pt_v0...), which reads exactly one project, or an OAuth access token issued for the API, which reads what its user can. Access tokens issued for Apsio's MCP server are accepted only from the MCP server itself.

Path Parameters

projectId
string
required
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"0192f3a4-0000-7000-8000-00000000a101"

Query Parameters

from
string<date-time>

Start of the time range, inclusive (RFC 3339). Defaults to the range end minus the default length.

Example:

"2026-10-01T00:00:00Z"

to
string<date-time>

End of the time range, exclusive (RFC 3339). Defaults to now.

Example:

"2026-10-08T00:00:00Z"

app_id
string
required

The app both releases belong to.

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
a
string
required

The baseline release.

Required string length: 1 - 128
Example:

"4.11.2"

b
string
required

The release to compare.

Required string length: 1 - 128
Example:

"4.12.0"

limit
integer
default:10

At most this many new issues, 1 to 50.

Required range: 1 <= x <= 50

Response

The comparison.

app_id
string
required
from
string
required

RFC 3339 time in UTC with up to nanosecond precision.

Example:

"2026-10-04T10:15:00.431000000Z"

to
string
required

RFC 3339 time in UTC with up to nanosecond precision.

Example:

"2026-10-04T10:15:00.431000000Z"

a
object
required
b
object
required
change
object
required
new_issues
object[]
required

Issues with occurrences in b and none in a, with their counts in b.