IBM Support

webMethods Knowlegebase : Schema errors in generated Swagger files (1794915)

Troubleshooting


Problem

In API Gateway 10.1 Fix 13, a REST API has been defined.

The API has been published to API Portal 10.3 Fix 1. On the API details page, the Swagger file has been generated ("Export API as"), resulting on a file for which the Swagger Editor (http://editor.swagger.io) reports the following errors for this swagger file:

Schema error at paths['/issues.json'].post.parameters[0]

should NOT have additional properties

additionalProperty: schema, in, name, description, required

Jump to line 179

Schema error at paths['/issues.json'].post.parameters[0].in

should be equal to one of the allowed values

allowedValues: header, formData, query, path

Jump to line 179

Schema error at paths['/issues.json'].post.parameters[0].required

should be equal to one of the allowed values

allowedValues: true

Jump to line 179

Schema error at paths['/issues.json'].post.parameters[0].schema

should NOT have additional properties

additionalProperty: allowEmptyValue

Jump to line 183

Schema error at paths['/issues/{id}.json'].put.parameters[1]

should NOT have additional properties

additionalProperty: schema, in, name, description, required

Jump to line 307

Schema error at paths['/issues/{id}.json'].put.parameters[1].in

should be equal to one of the allowed values

allowedValues: header, formData, query, path

Jump to line 307

Schema error at paths['/issues/{id}.json'].put.parameters[1].required

should be equal to one of the allowed values

allowedValues: true

Jump to line 307

Schema error at paths['/issues/{id}.json'].put.parameters[1].schema

should NOT have additional properties

additionalProperty: allowEmptyValue

Jump to line 311

Document Location

Worldwide

[{"Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSQKXP","label":"IBM webMethods API Management"},"ARM Category":[{"code":"a8mKe00000000AQIAY","label":"webMethods API Portal (YAP)"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Windows Server 2012"}],"Version":"10.3"}]

Log InLog in to view more of this document

This document has the abstract of a technical article that is available to authorized users once you have logged on. Please use Log in button above to access the full document. After log in, if you do not have the right authorization for this document, there will be instructions on what to do next.

Document Information

Modified date:
20 March 2025

UID

ibm17195271