Importing References

To upload a new reference or to override an existing reference, you may either do it using our API or through the editor as such:

• Open References from the sidebar.
• Select Import OpenAPI 2/3 Reference
• Choose a valid OpenAPI 2/3 (Swagger) JSON or YAML file.
• Wait until validation and parsing is complete.

On parsing completion, you will be notified that the reference has been created. If parsing or validation failed, an error will appear.

Best Practices for API References

Ensure that every operation has a unique operation ID. Operation IDs are used in %product% for linking to endpoints.

Validation Fail

We will notify you of detailed validation errors if any do exist. To interactively fix the validation error, you can use our API Editor.

Limitations

Maximum upload size allowed is 8MB.