polaris_measurement_submissions
Submit measurements to be evaluated against the active fitness-function version. Supports single or batch submissions up to 100 items, with per-item status reporting.
Instructions
Push measurements for evaluation against the ACTIVE fitness-function version.
These are the ingest endpoints: they authenticate with the X-API-Key configured as POLARIS_INGEST_API_KEY (no Google login involved).
Actions and required parameters:
submit: fitness_function_id + submission — evaluates synchronously and returns the recorded evaluation (with
replayed: truewhen a duplicate producerId+externalRunId delivery returned the original evaluation). Submissions against a non-active version yield 409.submit_batch: items — up to 100 independent submissions, each {fitnessFunctionId, submission}; the 207 response carries per-item status (201 success, or 404/409/422/500 with an error message); per-item failures do not abort the batch.
submission is a JSON object with camelCase keys:
required: fitnessFunctionVersion (the active version number); producerId (the producer
declared by the active definition); externalRunId (producer-scoped run id, the idempotency
natural key); observedAt (RFC 3339 UTC, not in the future, within the definition's maximum
observation age); measurements (array of {criterionKey, value, unit, observedAt?}, one per
criterion, duplicates rejected);
optional: evaluationRequestId (request this submission fulfills), evidence (array of
arbitrary evidence documents).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | No | ||
| action | Yes | ||
| submission | No | ||
| fitness_function_id | No |