Is this product on the category's current schema version?

GET 
/api/v1/products/:id/schema-compatibility

Required scope: dpp:read. Reports the product's authored schema version vs the category's active version, and mustMigrate — true ONLY when a removed/changed field is actually present in the product's own data (a version bump that doesn't touch the product's fields is benign). When the versions differ and the historical schema is retained, a field-level diff is included. Cross-tenant / unknown id → 404.

Request

Responses

200

Compatibility report

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).