Skip to content
Qualia Docs

Checks_ConfirmReferenceRange

POST
/v1/accounts/{account}/checks/{check}/referenceRanges/{referenceRange}:confirm
 
curl --request POST \
  --url https://junction-api.qualiastudios.dev/v1/accounts/example/checks/example/referenceRanges/example:confirm \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <X-API-Key>' \
  --data '{ "name": "example", "confirmedLow": 1, "confirmedHigh": 1, "clear": true }'

Replaces a reference range’s confirmed bounds, or clears the confirmation.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
account
required
string

The account id.

check
required
string

The check id.

referenceRange
required
string

The referenceRange id.

Request Body required

Section titled “Request Body required ”
Media type application/json

Request for Checks.ConfirmReferenceRange.

object
name
required

Accounts/{account}/checks/{check}/referenceRanges/{reference_range}

string
confirmedLow

Bounds to confirm. Omitted sides are unset; at least one is required unless clear is true. Values must be finite and low must not exceed high.

number format: double
confirmedHigh

Upper bound; absent means unset.

number format: double
clear

Clears both bounds, actor and timestamp. Cannot be combined with bounds.

boolean
Example generated
{
  "name": "example",
  "confirmedLow": 1,
  "confirmedHigh": 1,
  "clear": true
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

OK

Media type application/json

A robot’s reference range for one metric: the quantiles of its own episodes, so each episode is checked against its own robot’s takes and checks stay meaningful across mixed rigs. The population is every KEPT or UNREVIEWED episode of the workspace on the same robot interface, and a workspace lists and reads only its own ranges. The episode rules’ configuration: only checks/episode-rules has them.

Served by qds-api.

object
name

Accounts/{account}/checks/{check}/referenceRanges/{reference_range}

string
interfaceHash

The robot interface hash b3:<hex> the population shares.

string
robot

Accounts/{account}/robots/{robot} when the population is narrowed to one fleet robot; empty for the whole interface.

string
metric

The metric, as an Episode.Metrics field name.

string
quantiles

P05, p10, p25, p50, p75, p90, p95, p99.

Array<number>
mad

Median absolute deviation.

number format: double
fenceLow

The lower fence the checks use.

number format: double
fenceHigh

The upper fence the checks use.

number format: double
sampleCount

Episodes in the population.

string
computeTime

When it was computed.

string format: date-time
confirmedLow

Human-confirmed bounds. Each side is independent; calibration preserves them.

number format: double
confirmedHigh

Independently confirmed upper bound.

number format: double
confirmedBy

Who confirmed the bounds and when. Absent after clearing them.

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
confirmedAt

When the bounds were confirmed.

string format: date-time
Example 
{
  "confirmedBy": {
    "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": [
    {}
  ]
}