# Tasks_GetTaskReference `GET /v1/accounts/{account}/tasks/{task}/references/{reference}` Gets one reference. - Base URL: `https://junction-api.qualiastudios.dev` - Authentication: an API key in the `X-API-Key` header ## Parameters - `account` (path, string, required): The account id. - `task` (path, string, required): The task id. - `reference` (path, string, required): The reference id. ## Responses - `200` OK: `application/json` `qualia.v1.TaskReference` - `default` Default error response: `application/json` `google.rpc.Status` ## Schemas ```yaml qualia.v1.TaskReference: required: - role - episode type: object properties: name: type: string description: accounts/{account}/tasks/{task}/references/{reference} role: enum: - ROLE_UNSPECIFIED - SUCCESS - FAILURE - RECOVERY type: string description: What it shows. format: enum mode: type: string description: |- FAILURE and RECOVERY: the mode's short name, e.g. "drops the box", which groups the references that show it. 1 to 80 characters; a mode has one role. Empty for SUCCESS. episode: type: string description: |- The episode: accounts/{account}/datasets/{dataset}/episodes/{episode}, in the task's account; immutable. Named by the upload it was recorded in (Episode.upload), or by the merged dataset that holds that upload; it is kept and returned as its upload names it, and lives as long as that upload does. startSeconds: type: number description: |- The part of the episode it shows, in seconds from its start. Both unset means the whole episode; when set, 0 <= start_seconds < end_seconds. format: double endSeconds: type: number description: See start_seconds. format: double creator: readOnly: true allOf: - $ref: "#/components/schemas/qualia.v1.Actor" description: Who picked it. createTime: readOnly: true type: string description: When it was picked. format: date-time proposedBy: readOnly: true allOf: - $ref: "#/components/schemas/qualia.v1.Actor" description: Who proposed it. A person's own pick is confirmed immediately. confirmedBy: readOnly: true allOf: - $ref: "#/components/schemas/qualia.v1.Actor" description: The first person to confirm it; unset while unconfirmed. description: |- An episode proposed to show the task: done (SUCCESS), or going wrong in a named way (a FAILURE or RECOVERY mode). A reference points at the episode and copies no media, so it lives while its task and its dataset do: deleting the task deletes it, and deleting the dataset removes it (the task and everything written from the reference stay). Nothing is confirmed for a person: a model's proposal needs a person's confirmation. A task holds 1 to 3 SUCCESS references and any number of modes, each 1 to 2 references. Picking one needs read access to the episode's dataset. qualia.v1.Actor: type: object properties: kind: readOnly: true enum: - KIND_UNSPECIFIED - PERSON - VALIDATION - RULE - MODEL - OPERATOR - SYSTEM type: string description: What kind of actor it is. format: enum user: readOnly: true type: string description: The person's user id when `kind` is PERSON; empty otherwise. displayName: readOnly: true type: string description: The person's display name at the time, for rendering without a lookup. agent: readOnly: true type: string description: |- The rule code, or for a MODEL the Qualia model tier (e.g. "qualia-vlm"; "qualia" for any other model), when not a person. run: readOnly: true type: string description: The run a model or rule finding came from, when it has one. apiKey: readOnly: true type: string description: |- The API key's id when a person acted through one; empty for a session. Never the key itself. attribution: readOnly: true allOf: - $ref: "#/components/schemas/qualia.v1.Attribution" description: |- Signed identity evidence recorded with the change, kept apart from the principal above. Unset on older records and wherever none was signed. description: Who did something. Every decision, issue and reply names one. qualia.v1.Attribution: type: object properties: authentication: readOnly: true enum: - AUTHENTICATION_UNSPECIFIED - SESSION - API_KEY - SERVICE type: string description: How the principal authenticated. format: enum initiator: readOnly: true type: string description: |- 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. initiatorDisplayName: readOnly: true type: string description: The initiator's display name at the time, never their email. credentialCreator: readOnly: true type: string description: The user id of the key's creator at the time. Not who used the key. credentialOwner: readOnly: true enum: - CREDENTIAL_OWNER_UNSPECIFIED - PERSON - SPACE type: string description: Who owned the key at the time. format: enum credentialOwnerSpace: readOnly: true type: string description: |- The owning space's id (a workspace or the organization) when `credential_owner` is SPACE. description: |- How a change was authenticated and who verifiably started it. Only the trusted mesh signs it. It never authorizes anything, and a key's creator or owner is never the person who used the key. google.rpc.Status: oneOf: - $ref: "#/components/schemas/ApiError" - $ref: "#/components/schemas/GatewayError" description: "The body of a failed call: one of the two shapes below." ApiError: title: API error type: object required: - code - message - retryable - details properties: code: type: string description: The gRPC code name in upper case, e.g. `NOT_FOUND`. message: type: string retryable: type: boolean description: Whether the same call may succeed if retried. details: type: array items: type: object description: "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." description: A refusal from the API itself. GatewayError: title: Gateway error type: object required: - detail properties: detail: type: string description: What went wrong. description: A refusal from the gateway before the call reaches the API, for example `401` bad or missing API key, `403` key lacks the scope or environment closed, `413` body too large. ```