Skip to content
Qualia Docs

Versions_GetMergeHistory

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

Reads the merge and revert events for one dataset, newest first. A merge is final: the reverts recorded before then are history, and no entry can be reverted now.

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.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

OK

Media type application/json

The merge and revert history of a dataset.

object
name

Accounts/{account}/datasets/{dataset}/mergeHistory

string
entries

Merge and revert events, newest first.

Array<object>

The merge or revert event in the dataset event stream.

object
event

The merge or revert event in the dataset event stream.

string
kind

DATASETS_MERGED or EVENT_REVERTED.

string
actor

User, agent or system identity that made the change.

object
kind

What kind of actor it is.

string format: enum
Allowed values: KIND_UNSPECIFIED PERSON VALIDATION RULE MODEL OPERATOR SYSTEM
user

The person’s user id when kind is PERSON; empty otherwise.

string
displayName

The person’s display name at the time, for rendering without a lookup.

string
agent

The rule code, or for a MODEL the Qualia model tier (e.g. “qualia-vlm”; “qualia” for any other model), when not a person.

string
run

The run a model or rule finding came from, when it has one.

string
apiKey

The API key’s id when a person acted through one; empty for a session. Never the key itself.

string
attribution

Signed identity evidence recorded with the change, kept apart from the principal above. Unset on older records and wherever none was signed.

object
authentication

How the principal authenticated.

string format: enum
Allowed values: AUTHENTICATION_UNSPECIFIED SESSION API_KEY SERVICE
initiator

The user id of a person verified as starting the work: the person of a session, or the person a trusted service’s signed job record names. Empty when nobody was verified.

string
initiatorDisplayName

The initiator’s display name at the time, never their email.

string
credentialCreator

The user id of the key’s creator at the time. Not who used the key.

string
credentialOwner

Who owned the key at the time.

string format: enum
Allowed values: CREDENTIAL_OWNER_UNSPECIFIED PERSON SPACE
credentialOwnerSpace

The owning space’s id (a workspace or the organization) when credential_owner is SPACE.

string
createTime

RFC 3339 event time.

string format: date-time
datasets

Uploads joined by this merge, or released by its revert.

Array<string>
revertedEvent

For EVENT_REVERTED, the DATASETS_MERGED event it reverses.

string
reverted

For DATASETS_MERGED, true after a revert event was recorded.

boolean
canRevert

For DATASETS_MERGED, whether RevertMerge can reverse this entry: always false since merges are final.

boolean
appended

True when the merge appended to an existing merged dataset.

boolean
Example 
{
  "entries": [
    {
      "actor": {
        "kind": "KIND_UNSPECIFIED",
        "attribution": {
          "authentication": "AUTHENTICATION_UNSPECIFIED",
          "credentialOwner": "CREDENTIAL_OWNER_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": [
    {}
  ]
}