v4

latestOpenAPI 3.1.02026-08-03427198448.4 KB

codex-schema

Evaluate Schema Reuse

Use the schema safety agent to assess whether a prior script fits the new CSV.

post/api/codex-schema/agent-evaluate

user_idstring nullable

org_idstring nullable

job_idstring required

Background job identifier for the reference script.

headersstring[]

Headers detected on the new CSV upload.

sample_rowsobject[] nullable

Preview rows from the new CSV (limited to ~50 for context).

deterministic_warningsstring[]

Warnings already computed via deterministic fingerprint comparison.

schema_signaturestring nullable

Client-computed signature for the new CSV headers (used for validation).

schema_versioninteger nullable

Fingerprint spec version used by the client when computing the signature.

Successful Response

verdict'safe' | 'safe_with_warnings' | 'unsafe' required

summarystring required

warningsstring[] required

blocking_issuesstring[] required

suggested_follow_upstring[] nullable required

confidencenumber required