lint_artifact
Lint API artifacts (OpenAPI, AsyncAPI, Arazzo) with Spotlight to identify governance issues. Returns findings with code, message, severity, and path.
Instructions
Lint an API artifact (OpenAPI, AsyncAPI, Arazzo, APIs.json, JSON Schema, …) with Spotlight and return governance findings (code, message, severity, path).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"content": "<content>"
},
"name": "lint_artifact"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| format | No | Artifact format; selects the default ruleset when none is given. | |
| content | Yes | The API artifact as a YAML or JSON string. | |
| ruleset | No | A ruleset alias ("spotlight:oas") or a ruleset definition object. Defaults to the built-in ruleset for the format. |