Skip to content
Qualia Docs

Mixtures_GetSource

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

Gets one source.

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.

source
required
string

The source id.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

OK

Media type application/json

One thing a mixture reads: an upload or another mixture by name, or every upload carrying one label value, now and later. Each is followed on a channel or pinned to a tag. An upload or label source arrives raw (what the upload kept); a mixture source arrives curated (what it yields, its own rejects already out, and inherited). A mixture cannot read itself, however far round. There are no weights.

Served by qds-api. Only a MIXTURE dataset has sources.

object
name

Accounts/{account}/datasets/{dataset}/sources/{source}

string
dataset

Accounts/{account}/datasets/{dataset}: an upload, a mixture or a merged dataset by name. Not an upload a merge took: name its merged dataset; a pin of one of its own tags, left from before, stays.

string
label

Every upload and merged dataset with this label value, present and future: a merged dataset by its own labels (a method by its own method tags, the union of its uploads’, and then all of it), and no upload a merge took.

object
field
required

The label.

string format: enum
Allowed values: FIELD_UNSPECIFIED TASK ROBOT OPERATOR METHOD SCENE
value
required

The value it must equal, exactly.

string
linkedTask

Accounts/{account}/tasks/{task}: every episode linked to this task, present and future: its own Episode.linked_task, else its upload’s or merged dataset’s (Dataset.linked_task). An upload linked to another task brings in only its episodes linked to this one; no upload a merge took. A task of the mixture’s account; NOT_FOUND otherwise. Deleting the task is not refused: the source stays, reads nothing and says so in state (TASK_DELETED).

string
follow

How it is followed; unset means stable. A pin names a tag of dataset; a label or task source can only follow a channel.

object
channel

Move with a channel.

string format: enum
Allowed values: CHANNEL_UNSPECIFIED STABLE HEAD
pin

Stay on this version tag of the source dataset, e.g. “1.0”.

string
resolutions

What it resolves to now, one row per dataset (one for a dataset source, every matching upload and merged dataset for a label source).

Array<object>

One dataset the source resolved to, and where it is read.

object
dataset

Accounts/{account}/datasets/{dataset}

string
kind

Upload, merged dataset or mixture.

string format: enum
Allowed values: KIND_UNSPECIFIED UPLOAD MIXTURE MERGED
version

The tag it is read at; empty at head.

string
digest

The digest it is read at.

string
episodeCount

Episodes it brings in, before this mixture’s rejects.

string
rejectedCount

Episodes this mixture rejected among them.

string
empty

Nothing to read: the followed channel has no tag yet (stable on a dataset still in review).

boolean
reviewedCount

Upload or merged dataset (over the uploads it holds) only: ruled / total, for the sources panel’s progress.

string
totalCount

Upload or merged dataset (over the uploads it holds) only: total episodes.

string
episodeCount

Episodes it brings into head, after this mixture’s rejects.

string
inheritedRejectCount

Mixture source only: episodes the source mixture had rejected itself, inherited unseen.

string
update

Pinned source only: set when a newer stable tag exists.

object
version

The newer tag.

string
addedCount

Episodes it would add.

string
removedCount

Episodes it would remove.

string
changedCount

Episodes in both at another revision.

string
creator

Who added it.

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

When it was added.

string format: date-time
updateTime

When its follow last changed.

string format: date-time
etag

Sent back on UpdateSource.

string
position

Its place in the sources panel, from 0; the first source that brings an episode in is the one it counts under. A new source goes last; setting it moves the others along.

integer format: int32
state

Whether it can still read what it names; TASK_DELETED once its linked_task is gone.

string format: enum
Allowed values: STATE_UNSPECIFIED ACTIVE TASK_DELETED
Example 
{
  "label": {
    "field": "FIELD_UNSPECIFIED"
  },
  "follow": {
    "channel": "CHANNEL_UNSPECIFIED"
  },
  "resolutions": [
    {
      "kind": "KIND_UNSPECIFIED"
    }
  ],
  "creator": {
    "kind": "KIND_UNSPECIFIED",
    "attribution": {
      "authentication": "AUTHENTICATION_UNSPECIFIED",
      "credentialOwner": "CREDENTIAL_OWNER_UNSPECIFIED"
    }
  },
  "state": "STATE_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": [
    {}
  ]
}