Skip to content
Qualia Docs

Versions_CompareVersions

GET
/v1/accounts/{account}/datasets/{dataset}/versions:compare
 
curl --request GET \
  --url https://junction-api.qualiastudios.dev/v1/accounts/example/datasets/example/versions:compare \
  --header 'X-API-Key: <X-API-Key>'

What came in, went out or changed revision between two refs of one dataset, and why. Paged over the changed episodes.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
account
required
string

The account id.

dataset
required
string

The dataset id.

Query Parameters

Section titled “Query Parameters ”
base
string

The ref measured from: a tag, stable or a digest prefix. Empty means the newest tag (everything is new when there is none).

target
string

The ref measured to; empty means head.

pageSize
integer format: int32

At most this many changed episodes; 0 means 100, the maximum is 1000.

pageToken
string

From a previous response’s next_page_token.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

OK

Media type application/json

Response for Versions.CompareVersions.

object
changes

One page of changed episodes.

Array<object>

One episode that came in or went out.

object
episode

Accounts/{account}/datasets/{dataset}/episodes/{episode}, in this dataset’s scope.

string
direction

Added or removed.

string format: enum
Allowed values: DIRECTION_UNSPECIFIED ADDED REMOVED CHANGED
reason

Why.

string format: enum
Allowed values: REASON_UNSPECIFIED RULING UPSTREAM_RULING SOURCE_CHANGED SOURCE_MOVED ARRIVED SPLIT EDITED
source

The source it came through (mixtures).

string
cut

Present on immutable cut pieces. Identifies their original take and their order within its cut, so replacements can be paired across this flat direction/episode-ordered list (and across pages). The take uses this comparison’s dataset scope, just as episode does.

object
take

Accounts/{account}/datasets/{dataset}/episodes/{episode}: the take it was cut from.

string
takeIndex

The take’s index in its upload (Episode.index of the take).

integer format: int32
piece

Its place among the take’s pieces, from 1.

integer format: int32
pieceCount

How many pieces the take was cut into.

integer format: int32
startSeconds

Where it starts, in seconds of the take’s recording.

number format: double
endSeconds

Where it ends, in seconds of the take’s recording.

number format: double
nextPageToken

Empty on the last page.

string
baseVersion

The resolved base (“1.0”, or empty when there was none).

string
baseDigest

Digest of the base.

string
targetDigest

Digest of the target.

string
addedCount

Episodes added, across every page.

string
removedCount

Episodes removed, across every page.

string
changedCount

Episodes in both at a different revision, across every page.

string
reasonCounts

Added, removed and changed counted per reason, “RULING” -> n, for the dialog’s summary.

object
key
additional properties
string
draftNote

A note drafted from the diff, for the tag dialog to pre-fill.

string
suggestedVersion

The tag name the dialog offers: the next minor (“1.0” first). Majors are a person’s call.

string
Example 
{
  "changes": [
    {
      "direction": "DIRECTION_UNSPECIFIED",
      "reason": "REASON_UNSPECIFIED"
    }
  ]
}

default

Section titled “default ”

Default error response

Media type application/json
One of:
API error

A refusal from the API itself.

object
code
required

The gRPC code name in upper case, e.g. NOT_FOUND.

string
message
required
string
retryable
required

Whether the same call may succeed if retried.

boolean
details
required

Empty, except when a dataset copy or move is refused: then one google.rpc.ErrorInfo with the refusal’s reason code, its domain and, in metadata, the datasets it names.

Array<object>
object
Example generated
{
  "code": "example",
  "message": "example",
  "retryable": true,
  "details": [
    {}
  ]
}