verifiers

Deploy a verifier (create or new version)

Create a caller-owned verifier or append a new version to one with the same name. First deploy must omit expected_version_token; subsequent deploys must include the latest token returned by deploy, list, or get. Token mismatch returns 409. Creating a new verifier whose name matches an active platform-managed (scope=system) verifier returns 409. Returns {verifier_id, name, current_version, version, version_token, status, input_contract, config_hash}.

post/verifiers

Request

  • Base URL: https://api.goodeye.dev/v1
  • URL: https://api.goodeye.dev/v1/verifiers
  • Auth: none declared

Request body

namestring required

Verifier name, unique per owner among non-revoked verifiers. Lowercase letters, digits, and hyphens; no spaces.

descriptionstring required

Short human-readable summary of what the verifier judges.

criterionstring required

The rubric prose the judge applies. Write it as a direct instruction to the judge (e.g. 'Return passed=true when ...').

input_contract'text' | 'text_image' | 'image' required

Shape of inputs the verifier judges.

text: text fields only (input_fields required, media_url rejected). text_image: text fields plus one image (both required at run time). image: a single image only (input_fields must be empty, media_url required).

input_fieldsstring[]

Names of the text inputs the judge sees. Required for text and text_image; must be empty for image. Names are deduplicated case-insensitively. run_verifier rejects callers whose inputs keys do not match this list exactly.

expected_version_tokenstring uuid nullable

Optimistic-concurrency token. Required when re-deploying an existing verifier to confirm you've seen the latest version (get it from deploy_verifier, list_verifiers, or get_verifier). Must be omitted on first deploy. Mismatch returns a Conflict with the current token.

Response

Successful Response

object required

Changes

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