LedgeKitDocs
API referenceHTTP API
Developer documentation

Upload an evaluation

Store the original JSON report from Apple's Evaluations framework.

Save the native evaluation result to evaluation.json, then upload that file unchanged:

curl --fail-with-body -i https://api.ledgekit.com/v1/evaluations \
  -H "Authorization: Bearer $LEDGE_WRITE_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @evaluation.json

The report includes resultID, evaluationID, startTime, endTime, and results, plus the native framework's other fields. Limits are 4 MiB and 1,000 result rows. See reporting from Swift to persist files before attempting delivery.

Receipt and identity

A new result returns 201:

{ "id": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb", "inserted": true }

Uploading the exact same file again returns 200 with the same id and inserted: false. The native report's resultID identifies the upload.

Different file bytes for an existing result ID return 409 evaluation_conflict, including changes in formatting. Retry the original saved bytes. Dataset provenance belongs in the native report's evaluation metadata and sample values; see dataset evaluations.

Loading API schema…

On this page