---
title: "Evaluate Schema Reuse"
method: POST
path: "/api/codex-schema/agent-evaluate"
tags: ["codex-schema"]
---

# Evaluate Schema Reuse

`POST /api/codex-schema/agent-evaluate`

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

## Query parameters

- `user_id` string, nullable
- `org_id` string, nullable

## Request body

- SchemaGuardRequest
  - `job_id` string, required — Background job identifier for the reference script.
  - `headers` string[] — Headers detected on the new CSV upload.
  - `sample_rows` object[], nullable — Preview rows from the new CSV (limited to ~50 for context).
  - `deterministic_warnings` string[] — Warnings already computed via deterministic fingerprint comparison.
  - `schema_signature` string, nullable — Client-computed signature for the new CSV headers (used for validation).
  - `schema_version` integer, nullable — Fingerprint spec version used by the client when computing the signature.

## Response `200`

Successful Response

- SchemaGuardResponse
  - `verdict` 'safe' | 'safe_with_warnings' | 'unsafe', required
  - `summary` string, required
  - `warnings` string[], required
  - `blocking_issues` string[], required
  - `suggested_follow_up` string[], nullable, required
  - `confidence` number, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/every/apis/every-api.md) · [All operations](https://skmtc.net/every/apis/every-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/every/every-api/versions/f8600f7a4ae3/schema)