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
- 200
- 400
- 403
- 422
The specification passed validation.
Validation error. Field-level errors keyed by field name.
Access denied. Check the API key, permissions, project access, and allowed domains.
The specification failed to fetch, parse, or validate.