# Working with OpenAPI contract in multiple files

DevFeed: [Working with OpenAPI contract in multiple files](<https://devfeed.tech/articles/working-with-openapi-contract-in-multiple-files-27327.md>)

Original publisher: [Read original article](<https://blog.pchudzik.com/202004/open-api-and-external-ref/>)

Published: 2020-04-23T00:00:00Z

Content type: tutorial

Language: en

Sources: [Paweł Chudzik](<https://devfeed.tech/sources/pawe-chudzik.md>)

Topics: [OpenAPI Specification](<https://devfeed.tech/topics/openapi.md>), [Swagger](<https://devfeed.tech/topics/swagger.md>), [API](<https://devfeed.tech/topics/api.md>)

Tags: [api](<https://devfeed.tech/tags/api.md>), [code](<https://devfeed.tech/tags/code.md>), [download](<https://devfeed.tech/tags/download.md>), [editor](<https://devfeed.tech/tags/editor.md>), [embedded](<https://devfeed.tech/tags/embedded.md>), [github-issues](<https://devfeed.tech/tags/github-issues.md>), [openapi](<https://devfeed.tech/tags/openapi.md>), [openapi-specification](<https://devfeed.tech/tags/openapi-specification.md>), [swagger](<https://devfeed.tech/tags/swagger.md>)

## AI overview

This tutorial explains how to split a large OpenAPI specification into multiple files and work with external references. It discusses Swagger Editor's limitations, Stoplight Studio, swagger-ui-watcher, and a workflow for organizing a pet store API across separate files.

## Source excerpt

Real-life OpenAPI specification files tend to go really big really fast. In this post, I'll try to explore how we can split single specification file into multiple files and don't get crazy while scrolling up and down like a mad man. Read more