observability

Export Eval Runs

Pull this workspace's graded eval runs as flat rows for analysis elsewhere. Use when you need many runs at once rather than one verdict: filter by eval, version, date range, status and verdict, and read back a row per run carrying the score alongside the fields that qualify it. Pass count_only to learn how many runs match — and how many instrument versions they span — before pulling them.

post/api/platform/v1/evals/export

Request

  • Base URL: https://docs.amdahl.ai
  • URL: https://docs.amdahl.ai/api/platform/v1/evals/export
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Request body

evalstring

Eval slug or id. Default 'prompt-and-message-eval'. Required in effect — columns and versions are per-eval, so one export covers one eval.

eval_versionsstring[]

Restrict to these eval_version values. Omit for every version, but read the version spread on the count first: scores from different versions are produced by different instruments and are not comparable.

fromstring

ISO-8601 lower bound on created_at (inclusive).

tostring

ISO-8601 upper bound on created_at (exclusive).

statusesstring[]

Restrict to these run statuses. Omit for every status.

verdictsstring[]

Restrict to these verdict buckets. Omit for every bucket. ungraded is a pseudo-bucket for runs carrying no verdict at all - the ones whose overall_score cell is empty - so you can isolate or exclude them; it is not a value any run stores.

count_onlyboolean

Return only the count block (total, cap, version spread, date range) without the rows. Cheap enough to call on every filter change.

redact_quotesboolean

Blank the verbatim customer quotes in the exported verdict. Affects the raw JSONL download only; the flat rows never carry quote text.

allow_truncationboolean

Proceed when more than 5000 runs match, taking the most recent 5000. Without it an over-cap response is refused rather than silently cut. The .csv / .jsonl file downloads stream and have no cap, so they never need this.

limitnumber

Take at most this many runs, most recent first (max 5000 here). A deliberate top-N, not a truncation: it satisfies the cap on its own, so a limited call is never refused for matching a larger set.

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.