Skip to content
Qualia Docs

Versions_ListSourceCommits

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

Lists the repository commits a tag pins, ordered by upload, so a version can be traced to the repositories its episodes came from. INVALID_ARGUMENT for head, which pins none.

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.

version
required
string

The version id.

Query Parameters

Section titled “Query Parameters ”
pageSize
integer format: int32

At most this many commits; 0 means 100, the maximum is 500.

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.ListSourceCommits.

object
sourceCommits

One page of commits.

Array<object>

One repository commit a tag pins: where the bytes of the episodes it took from one upload were published. A tag’s commits never change.

The {source_commit} id is <upload uuid>-<semantic commit uuid>.

object
name

Accounts/{account}/datasets/{dataset}/versions/{version}/sourceCommits/{source_commit}, under the tag’s own name (not stable or a digest prefix).

string
dataset

Accounts/{account}/datasets/{dataset}: the upload the commit published.

string
repoId

The upload’s Git repository, a UUID.

string
gitOid

The Git object id of the commit, lowercase hex.

string
gitHashAlgorithm

The hash the object id is in: “sha1” or “sha256”.

string
publicationGeneration

The publication of refs/heads/main that wrote the commit; counts up from 1 per repository.

string
semanticCommitId

The commit’s identity across hash algorithms, a UUID.

string
nextPageToken

Empty on the last page.

string
totalSize

Commits the tag pins, across every page.

integer format: int32
Example generated
{
  "sourceCommits": [
    {
      "name": "example"
    }
  ],
  "nextPageToken": "example",
  "totalSize": 1
}

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": [
    {}
  ]
}