Lint OpenAPI spec
lint_specValidate OpenAPI 3 or Swagger 2 documents against built-in rules and return counts and findings for issues like missing operation IDs, error responses, security schemes, and broken $refs.
Instructions
Check an OpenAPI 3 or Swagger 2 document against Gostman's built-in rules: missing operation ids or descriptions, undeclared path parameters, missing error responses, undefined security schemes, broken $refs and similar. Returns the counts and findings.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "lint_spec"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Fetch the document from this address instead. Only hosts this session may call are reached. | |
| content | No | The OpenAPI 3 or Swagger 2 document as JSON or YAML text. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| counts | No | ||
| omitted | No | ||
| findings | No |