Codewerk
swagger2 to openapi3
Converts Swagger 2.0 to OpenAPI 3.0.0 with swagger2openapi 7.0.8 (servers from schemes/host/basePath, body/formData parameters to requestBody, definitions to components, securityDefinitions to securitySchemes). For target 3.1 it applies the upgrade steps of the OpenAPI Initiative migration guide and lists each change with its JSON pointer. Input and output are validated against the official OpenAPI JSON Schemas. External $refs are rejected, nothing is fetched.
POST https://code.halowerk.com/v1/swagger2-to-openapi3Inputs
| Field | Type | Required | Description |
|---|---|---|---|
| spec | See schema | Yes | The API description as a JSON object or as a JSON/YAML string (max. 2 MB). External $ref values are rejected. |
| target | string | No | Target version: 3.1 (3.1.0) or 3.0 (3.0.0 as produced by swagger2openapi). |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"required": [
"spec"
],
"properties": {
"spec": {
"description": "The API description as a JSON object or as a JSON/YAML string (max. 2 MB). External $ref values are rejected.",
"anyOf": [
{
"type": "object"
},
{
"type": "string",
"minLength": 2,
"maxLength": 2000000
}
]
},
"target": {
"type": "string",
"enum": [
"3.1",
"3.0"
],
"default": "3.1",
"description": "Target version: 3.1 (3.1.0) or 3.0 (3.0.0 as produced by swagger2openapi)."
}
}
}Published input example
{
"target": "3.1",
"spec": {
"swagger": "2.0",
"info": {
"title": "Pets",
"version": "1.0"
},
"host": "halowerk.com",
"basePath": "/v1",
"schemes": [
"https"
],
"paths": {
"/pets": {
"get": {
"produces": [
"application/json"
],
"responses": {
"200": {
"description": "ok",
"schema": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}
}
}
}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