APIs › Agent & Developer Utilities › JSON Schema Inference

JSON Schema Inference

Infers a JSON Schema (draft 2020-12) from one or more sample documents, merging types and marking fields optional when absent from any sample.

POST /v1/developer/json-schema-infer $0.01 per call

Specification

Endpoint

POST /v1/developer/json-schema-infer

Price

$0.01 per call · tier standard_data

Payment

x402 on X Layer (chain 196) · settled in USDG or USDT0 · scheme exact

Data source

Deterministic local computation on caller-supplied input

Timeout

15 seconds

Max request

2 MB

Version

1.0.0

Calling it

The first call returns a 402 with the payment challenge. Retry with a signed authorisation in the X-PAYMENT header — see the payment guide for the exact shape.

curl -i -X POST "https://api.dana-edu.pp.ua/v1/developer/json-schema-infer" \
  -H "content-type: application/json" \
  -d '{ ... }'

Response

Real output, captured by running this endpoint at build time — not written by hand. Volatile fields such as timestamps are elided. Captured 2026-07-30.

{
  "schema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "title": "Item",
    "type": "object",
    "properties": {
      "id": {
        "type": "integer"
      },
      "name": {
        "type": "string"
      },
      "tags": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "note": {
        "type": "string"
      }
    },
    "required": [
      "id",
      "name",
      "tags"
    ]
  },
  "samples_used": 2,
  "optional_fields": [
    "note"
  ]
}

Every response is wrapped in the same envelope: data plus warnings, sources, confidence, informational_only and a measured processing_ms. See the envelope reference.

Related endpoints