Skip to content
Qualia Docs

Checks_ConfirmReferenceRange

POST
/v1/accounts/{account}/checks/{check}/referenceRanges/{referenceRange}:confirm
 
curl --request POST \
  --url https://dev-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 (QUA-2233): 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 (QUA-2933). 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. (— api-linter: core::0140::prepositions=disabled aip.dev/not-precedent: matches the stored confirmation contract. —)

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 the model id (e.g. “gemini-robotics-er”), 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. (— api-linter: core::0142::time-field-names=disabled aip.dev/not-precedent: matches the stored confirmation contract. —) (— api-linter: core::0140::prepositions=disabled aip.dev/not-precedent: matches the stored confirmation contract. —)

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

The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC. Each Status message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the API Design Guide.

object
code

The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].

integer format: int32
message

A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.

string
details

A list of messages that carry the error details. There is a common set of message types for APIs to use.

Array<object>

Contains an arbitrary serialized message along with a @type that describes the type of the serialized message.

object
@type

The type of the serialized message.

string
key
additional properties
any
Example generated
{
  "code": 1,
  "message": "example",
  "details": [
    {
      "@type": "example"
    }
  ]
}