---
title: "Match Schema"
method: POST
path: "/api/codex-schema/match"
tags: ["codex-schema"]
---

# Match Schema

`POST /api/codex-schema/match`

Return previously successful Codex imports whose schema matches the uploaded CSV.

## Query parameters

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

## Request body

- SchemaMatchRequest
  - `signature` string, required — SHA256 fingerprint of normalized headers.
  - `headers` string[] — Raw column headers from the CSV.
  - `sample_rows` object[], nullable — Optional preview rows from the CSV for compatibility checks.
  - `schema_version` integer, nullable — Fingerprint specification version.
  - `limit` integer, nullable — Maximum number of matches to return.

## Response `200`

Successful Response

- SchemaMatchResponse
  - `matches` SchemaMatchResult[], required
    - `job_id` string, required
    - `thread_id` string, nullable, required
    - `completed_at` string, nullable, required
    - `job_type` string, nullable, required
    - `nickname` string, nullable, required
    - `schema_signature` string, required
    - `schema_version` integer, nullable, required
    - `reused_from_job_id` string, nullable, required
    - `summary` string, nullable, required
    - `script_hash` string, nullable, required
    - `compatibility` object, nullable, 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)