v1

latestOpenAPI 3.1.02026-07-24121425.6 KB

Get snapshot comparison

Returns snapshot comparison data between two builds (head and base), including added, removed, changed, and unchanged snapshots. Can also return data for a single build if no base is specified.

get/v2/snapshots/diff

Query parameters

headUploadIdstring required

The Emerge ID of the head (current) build to compare

baseUploadIdstring

The Emerge ID of the base build to compare against. If not provided and head upload has a base_sha, it will be automatically determined.

noDiff'true' | 'false'

Set to 'true' to skip comparison and return only head build snapshots

pageinteger

Page number for pagination (0-indexed)

tab'added' | 'removed' | 'changed' | 'unchanged' | 'errors'

Filter snapshots by change type

searchstring

Search query to filter snapshots by name

Response

Success - returns snapshot comparison data with status (SUCCESS, PROCESSING, or ERROR)

status'SUCCESS' | 'PROCESSING' | 'ERROR'

The status of the snapshot comparison

headUploadMetadataobject

Metadata about the head build

baseUploadMetadataobject

Metadata about the base build (null if single-build view)

messagestring

Message with additional context (present when status is PROCESSING or ERROR)