Skip to main content
The SchemaGen API is a set of HTTP endpoints that power schema delivery, generation, and validation. You can call these endpoints directly to build custom integrations, server-side pipelines, or CMS plugins without relying on the SchemaGen JavaScript SDK.

​
Base URL

All API requests use the following base URL:

​
Available endpoints

​
Error format

All error responses return JSON with an error field and an optional details object.
The details field appears on validation errors and contains a structured breakdown of what failed. It is omitted on rate limit, auth, and server errors.

​
HTTP status codes

​
Rate limiting

SchemaGen applies rate limits at the endpoint level to ensure fair use.
  • Authenticated users are rate-limited per user account and receive higher request allowances.
  • Unauthenticated users are rate-limited per IP address and have lower allowances.
When you exceed the rate limit, the API returns a 429 response:
The /api/validate endpoint has its own independent rate limit separate from the generation endpoints.
Rate limits are applied on a fail-open basis: if the rate limit service is temporarily unavailable, requests are allowed through rather than blocked.

​
Usage limits

Authenticated users on paid plans have a monthly usage quota that applies to schema generation and AI extraction. When you reach your plan’s limit, the API returns a 403 with error code limit_reached:
Guest (unauthenticated) users can call /api/generate without a usage limit, but are subject to IP-based rate limits.