Suggest canonical field_ids for ERP columns (deterministic, no AI)

POST 
/api/v1/mappings/lint

Required scope: mapping:read. For each ERP column, returns the best canonical field_id from the category's schema by Jaro-Winkler similarity (deterministic, NO AI / zero tokens). 404 if the category is unknown or out-of-scope — returned BEFORE any scoring, so 404 timing is never proportional to catalog size. The response echoes the algorithm + threshold.

Request

Responses

200

Per-column suggestions.

400

VALIDATION_ERROR — bad body (missing categoryCode/columns, >500 columns, ...).

401

401 — INVALID_SIGNATURE or SIGNING_NOT_CONFIGURED (or bearer auth failure).

403

403 — missing scope (FORBIDDEN_SCOPE) or module (FORBIDDEN_MODULE).

404

404 — not found OR owned by another tenant (NOT_FOUND; IDOR-safe).

429

429 — RATE_LIMITED (per-key limit, reads and writes alike; fails closed, so a limiter outage also returns 429). A limiter-down 429 is deliberately indistinguishable from a quota 429. Carries Retry-After (seconds).

Response Headers

Retry-After

Seconds to wait before retrying (429 only).

RateLimit-Limit

Per-minute request ceiling for this key's tier.

RateLimit-Remaining

Requests left in the current window (floored at 0).

RateLimit-Reset

Seconds until the window resets.

503

503 — the API is not enabled on this environment (FEATURE_DISABLED).