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

---

[API](https://skmtc.net/landing-ai/apis/landingai-agentic-document-extraction-ade-api-v2-parse-and-e.md) · [All operations](https://skmtc.net/landing-ai/apis/landingai-agentic-document-extraction-ade-api-v2-parse-and-e/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/landing-ai/landingai-agentic-document-extraction-ade-api-v2-parse-and-e/versions/b07477df91eb/schema)