Codewerk
openapi style lint
Lints an OpenAPI document with @stoplight/spectral-core 1.24.0 and the built-in spectral:oas ruleset of @stoplight/spectral-rulesets 1.23.0. Findings carry rule, severity (error, warn, info, hint), JSON path and line/column. Rules can be switched off by name and findings filtered by minimum severity. External $refs are rejected before linting, so nothing is fetched; no custom rulesets are loaded.
POST https://code.halowerk.com/v1/openapi-style-lintInputs
| Field | Type | Required | Description |
|---|---|---|---|
| spec | See schema | Yes | The OpenAPI document as a JSON object or JSON/YAML string (max. 2 MB). External $ref values are rejected. |
| disable_rules | array | No | Rule names to ignore, e.g. ["info-contact"]. |
| min_severity | string | No | Report findings of this severity or higher. |
| max_findings | integer | No |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"required": [
"spec"
],
"properties": {
"spec": {
"description": "The OpenAPI document as a JSON object or JSON/YAML string (max. 2 MB). External $ref values are rejected.",
"anyOf": [
{
"type": "object"
},
{
"type": "string",
"minLength": 2,
"maxLength": 2000000
}
]
},
"disable_rules": {
"type": "array",
"maxItems": 60,
"uniqueItems": true,
"items": {
"type": "string",
"maxLength": 80
},
"description": "Rule names to ignore, e.g. [\"info-contact\"]."
},
"min_severity": {
"type": "string",
"enum": [
"error",
"warn",
"info",
"hint"
],
"default": "hint",
"description": "Report findings of this severity or higher."
},
"max_findings": {
"type": "integer",
"minimum": 1,
"maximum": 1000,
"default": 300
}
}
}Published input example
{
"spec": "openapi: 3.0.3\ninfo: {title: Pets, version: \"1.0\"}\npaths:\n /pets/:\n get:\n responses:\n \"200\": {description: ok}\n",
"min_severity": "warn"
}Result & documentation
Machine-readable documentation of this hub
Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.
More endpoints in this hub
- Codewerk0.003 USDC
action sha pin
POSThttps://code.halowerk.com/v1/action-sha-pinFinds every "uses: owner/repo[/path]@ref" in a GitHub Actions workflow, resolves tags (including annotated tags) and branches to the commit SHA with git ls-remote against github.com, and rewrites the line to "uses: owner/repo[/path]@<sha> #
- Codewerk0.003 USDC
actionlint
POSThttps://code.halowerk.com/v1/actionlintRuns the official statically linked actionlint 1.7.12 release binary (MIT, SHA-256 checked against the published checksums) in an isolated child process without network, with the bundled ShellCheck 0.11.0 for run: scripts (pyflakes is not a
- Codewerk0.004 USDC
api changelog
POSThttps://code.halowerk.com/v1/api-changelogCompares operations, parameters, request bodies, response codes and media types, component schemas (one property level), servers and security schemes of two documents (Swagger 2.0 is converted with swagger2openapi first; 3.0 and 3.1 are rea