Skip to main content

Validate an OpenAPI specification

POST 

/api/v2/openapi/validate/

Check whether Biel.ai can fetch, parse, and validate an OpenAPI specification, including its $ref references. Returns 200 for a valid specification or 422 with validation errors.

Provide exactly one of url or content (JSON or YAML). Relative $ref references are resolved against the specification URL.

For CI, call this endpoint after publishing your specification and fail the pipeline on a non-2xx response.

Required permission: any valid API key. No specific permission is required.

Request​

Responses​

The specification passed validation.