---
title: "Schema and structure check, no solve"
method: POST
path: "/v1/designs/validate"
tags: ["Solve"]
---

# Schema and structure check, no solve

`POST /v1/designs/validate`

## Request

- Base URL: `https://electronics-architect.com`
- URL: `https://electronics-architect.com/v1/designs/validate`
- Auth: HTTP bearer

Scope: `read`. Always 200; read `valid` and `errors`. Checks the JSON Schema and that every connection names a node on its sheet.

## Request body

- object: The design to check. A bare design document (with `sheets`) is also accepted.
  - `design` Design, required (unresolved $ref)
  - `options` object

## Response `200`

Validation result.

- ValidationResult
  - `valid` boolean
  - `schemaVersion` integer
  - `schema` string
  - `errors` ValidationError[]
    - `path` string
    - `message` string
  - `counts` object
    - `sheets` integer
    - `nodes` integer
    - `connections` integer

## Other responses

- `401`: No key, a browser token instead of a key, an unknown key, or a revoked key (code KEY_REVOKED).
- `403`: The key lacks a required scope (INSUFFICIENT_SCOPE), or the call needs a plan the account does not have (PLAN_REQUIRED): on the Free plan, compare, exports, Monte Carlo jobs, AI synthesis, a design with more than one sheet, or a save, share or key past the Free limits; or a team key whose team is no longer paid for.
- `429`: RATE_LIMITED: the key's per-minute allowance is used up (or, before any key is recognised, too many requests from one address presented an unknown or revoked key). On the routes that solve inside the request (solve, verify, derating, compare, exports, ai/review, ai/synthesize) it can also be SOLVE_IN_PROGRESS: this account already has 3 calls of that kind running on the server that took the request (solves, AI reviews and syntheses are each counted separately). `Retry-After` is set either way; for SOLVE_IN_PROGRESS it is 2 s for solves and 30 s for AI reviews and syntheses.

---

[API](https://skmtc.dev/electronics-architect/apis/electronics-architect-api.md) · [All operations](https://skmtc.dev/electronics-architect/apis/electronics-architect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/electronics-architect/apis/electronics-architect-api/revisions/98066184ba67?raw)