OpenAPI Linting Guide
Our platform automatically lints OpenAPI specifications during upload and will reject any with errors unless explicitly overridden.
Run the linter
sideko api lint --spec path/to/spec.json
Linting Levels
- Errors: Block upload completely
- Warnings: Don't block upload but should be addressed
- Info: Suggestions for improvement
Override Process
To bypass error checking during upload, use the allow_lint_errors flag in your API call, --allow-lint-errors in the sideko CLI, or "Allow Lint Errors" in the UI.