verifiers

Run a verifier to check whether an output meets its criterion.

Runs the judge against inputs (and optional media_url). Path verifier_id is a Verifier UUID, or system:<name> for platform-managed verifiers. Anonymous callers may run a Verifier UUID iff it appears in some live template_versions.verifier_snapshots (publicly-runnable gate); spend is gated by the credit ledger. Caller-shape errors return 400 with no row written; runtime errors return 201 with status="error" and an error_code of runtime_error, verifier_unavailable, or timeout. Returns {verifier_run_id, anonymous_verifier_run_id, verifier_id, version, status, passed, reasoning, duration_ms, created_at} (one of verifier_run_id or anonymous_verifier_run_id populated). A successful run attributed to a skill you own also echoes that skill's skill_id.

post/verifiers/{verifier_id}/runs

Request

  • Base URL: https://api.goodeye.dev/v1
  • URL: https://api.goodeye.dev/v1/verifiers/{verifier_id}/runs
  • Auth: none declared

Path parameters

verifier_idstring required

Request body

versioninteger nullable

Pin to a specific verifier version; defaults to the current version.

inputsobject

Map keyed by the version's input_fields. Keys must match the deployed list exactly; values must be non-empty strings.

media_urlstring nullable

Public HTTPS image URL. Required for text_image and image contracts, rejected for text.

skill_idstring nullable

Optional skill UUID for provenance. Access-checked: a skill the caller cannot see surfaces as 404.

skill_versioninteger nullable

Skill version invoking this run, paired with skill_id.

skill_refstring nullable

Free-form skill label (slug, name) for human-readable provenance.

run_idstring nullable

Optional caller-supplied correlation ID stamped onto the run row.

Response

Successful Response

object required

Changes

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