---
title: "ADE Build Extract Schema"
method: POST
path: "/v1/ade/extract/build-schema"
tags: ["Tools"]
---

# ADE Build Extract Schema

`POST /v1/ade/extract/build-schema`

Generate a JSON schema from Markdown using AI.

This endpoint analyzes Markdown
    content and generates a JSON schema suitable for use with the extract endpoint.
    It can also refine an existing schema based on new documents or iterate on a schema
    based on prompt instructions.

For EU users, use this endpoint:


    `https://api.va.eu-west-1.landing.ai/v1/ade/extract/build-schema`.

## Response `200`

Successful Response

- BuildSchemaResponse
  - `extraction_schema` string, required — The generated JSON schema as a string.
  - `metadata` BuildSchemaMetadata, required
    - `filename` string, nullable
    - `org_id` string, nullable
    - `duration_ms` integer
    - `credit_usage` number
    - `job_id` string
    - `version` string, nullable
    - `warnings` ExtractWarning[] — Structured warnings from the extraction process. Each warning is an instance of ExtractWarning with 'code' (e.g. 'nonconformant_schema') and 'msg' (human-readable description). Present only for extract versions from extract-20260314 and above that support structured warnings.
      - `code` 'nonconformant_schema' | 'nonconformant_output', required
      - `msg` string, required — Human-readable description of the warning with more details

## Other responses

- `422` — Validation Error

## Changes

- **2026-04-03** `ceccbcbbf7a6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/landing-ai/apis/ade-api/changes/v1/ade/extract/build-schema/post.md)

---

[API](https://skmtc.dev/landing-ai/apis/ade-api.md) · [All operations](https://skmtc.dev/landing-ai/apis/ade-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/landing-ai/ade-api/revisions/027fb87ba705/schema)