Measure retained observations against explicit current references

POST/v1/evaluations/{evaluationId}/measurements

Diagnostic retained evidence only. Requires current parent Evaluation run-view permission and case-management permission. No target execution, inference, reference authority upgrade, holdout exposure, or release approval. Imported systemLabel is caller declared, not verified execution provenance. Unknown references are not negatives. Explicit record IDs are idempotency identities; changed requests or stale review heads return 409.

How to call this endpoint

Every ACP API request uses bearer authentication. The examples here show the actual request path, auth header, and body shape that the platform expects.

Path, query, and header parameters

These parameters control which ACP object the endpoint acts on and how the request is processed.

Path parameters

Name	Location	Type	Required	Description
evaluationId	path	string	Yes	—

Query parameters

None.

Body schema

Content type: application/json · Required

Field	Type	Required	Description
id	string	Yes	Unique identifier.
observationRunId	string	Yes	—
checks	object[]	Yes	—
checks[].id	string	Yes	Unique identifier.
checks[].label	string	Yes	—
checks[].path	string	Yes	RFC 6901 JSON Pointer.
reviewIds	string[]	Yes	—

What the API returns

Each response code below includes the documented payload shape for the ACP API.

200Retained diagnostic evidence; not a release decisionapplication/json

Field	Type	Required	Description
measurement	object	Yes	—
measurement.id	string	Yes	Unique identifier.
measurement.observationRunId	string	Yes	—
measurement.checks	object[]	Yes	—
measurement.checks[].id	string	Yes	Unique identifier.
measurement.checks[].label	string	Yes	—
measurement.checks[].path	string	Yes	RFC 6901 JSON Pointer.
measurement.reviewIds	string[]	Yes	—
measurement.schemaVersion	computer_agents_measurement_run_v1	Yes	—
measurement.evaluationId	string	Yes	—
measurement.versionId	string	Yes	—
measurement.observationFingerprint	string	Yes	—
measurement.referenceFingerprints	string[]	Yes	—
measurement.graderId	reviewed_exact_json_v1	Yes	—
measurement.createdByUserId	string	Yes	—
measurement.createdAt	string	Yes	ISO 8601 timestamp.
measurement.purpose	diagnostic	Yes	—
measurement.decisionState	not_assessed	Yes	—
measurement.trustLevel	imported	Yes	—
measurement.populationCount	integer	Yes	—
measurement.metrics	object[]	Yes	—
measurement.metrics[].id	string	Yes	Unique identifier.
measurement.metrics[].label	string	Yes	—
measurement.metrics[].description	string	Yes	Human-readable description.
measurement.metrics[].numeratorLabel	string	Yes	—
measurement.metrics[].denominatorLabel	string	Yes	—
measurement.metrics[].unit	percent	Yes	—
measurement.metrics[].aggregation	micro	Yes	—
measurement.metrics[].direction	higher_is_better \| lower_is_better \| informational	Yes	—
measurement.metrics[].state	measured \| partial \| unmeasured \| invalid	Yes	—
measurement.metrics[].value	number	Yes	A percentage
measurement.metrics[].numerator	integer	Yes	—
measurement.metrics[].denominator	integer	Yes	—
measurement.metrics[].populationCount	integer	Yes	—
measurement.metrics[].includedCount	integer	Yes	—
measurement.metrics[].excludedCounts	object	Yes	—
measurement.metrics[].excludedCounts.unmeasured	integer	No	—
measurement.metrics[].excludedCounts.missing_reference	integer	No	—
measurement.metrics[].excludedCounts.source_changed	integer	No	—
measurement.metrics[].excludedCounts.not_applicable	integer	No	—
measurement.metrics[].excludedCounts.error	integer	No	—
measurement.metrics[].excludedCounts.skipped	integer	No	—
measurement.metrics[].excludedCounts.missing_output	integer	No	—
measurement.metrics[].excludedCounts.invalid	integer	No	—
measurement.metrics[].uncertainty	object	Yes	—
measurement.metrics[].uncertainty.kind	not_estimated	Yes	—
measurement.metrics[].uncertainty.reason	string	Yes	—
measurement.fingerprint	string	Yes	—

400Invalid body, query or source dataapplication/json

Field	Type	Required	Description
error	string	Yes	—
message	string	No	Message text.

401Authentication requiredapplication/json

Field	Type	Required	Description
error	string	Yes	—
message	string	No	Message text.

402Evaluation entitlement requiredapplication/json

Field	Type	Required	Description
error	string	Yes	—
message	string	No	Message text.

403Active organization, permission or annotation actor requiredapplication/json

Field	Type	Required	Description
error	string	Yes	—
message	string	No	Message text.

404Parent Evaluation or evidence missing or inaccessibleapplication/json

Field	Type	Required	Description
error	string	Yes	—
message	string	No	Message text.

409Identity conflict, stale reference, held-out input or corrupted evidenceapplication/json

Field	Type	Required	Description
error	string	Yes	—
message	string	No	Message text.

413Bounded input limit exceededapplication/json

Field	Type	Required	Description
error	string	Yes	—
message	string	No	Message text.

500Retained evidence unavailableapplication/json

Field	Type	Required	Description
error	string	Yes	—
message	string	No	Message text.

501PostgreSQL-backed API requiredapplication/json

Field	Type	Required	Description
error	string	Yes	—
message	string	No	Message text.

Measure retained observations against explicit current references

Response 200

See the ACP quickstart and SDK flow