---
title: "Check a cell spec is ready for a model builder"
method: POST
path: "/model_builders/{model_builder_id}/check"
tags: ["Model builders"]
---

# Check a cell spec is ready for a model builder

`POST /model_builders/{model_builder_id}/check`

## Request

- Base URL: `https://api.ionworks.com`
- URL: `https://api.ionworks.com/model_builders/{model_builder_id}/check`
- Auth: none declared

List everything a cell spec lacks for this builder, without building.

## Path parameters

- `model_builder_id` string, uuid, required

## Request body

- CheckRequest: Body for the readiness check.
  - `cell_spec_id` string, required

## Response `200`

Successful Response

- ReadinessReport: Result of checking whether a cell spec has everything a builder needs.
  - `ready` boolean, required: True when there are no error issues.
  - `issues` ReadinessIssueModel[], required
    - `severity` 'error' | 'warning', required
    - `code` 'missing' | 'unit_mismatch' | 'wrong_shape' | 'ambiguous' | 'unsatisfied_input', required
    - `message` string, required
    - `parameter` string, nullable: Model parameter the issue affects.
    - `path` string, nullable: Dotted path in the cell spec, as in a mapping.
    - `element` string, nullable: Recipe element name.
  - `resolved` integer, required: Mapped cell-spec values that read.
  - `total` integer, required: Mapped cell-spec values in the builder.

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-22** `39d84bb8875e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ionworks/apis/ionworks-api/changes/model_builders/:model_builder_id/check/post.md)

---

[API](https://skmtc.dev/ionworks/apis/ionworks-api.md) - [All operations](https://skmtc.dev/ionworks/apis/ionworks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ionworks/apis/ionworks-api/revisions/abebbbc5f60a?raw)