openapi-cli-tool
openapi-cli-tool copied to clipboard
s it possible to separate paths into separate files?
openapi: 3.0.0
info:
title: XXXXXXX
version: '0.0.1'
license:
name: MIT
x-complex-type:
supported:
- version: '2.0'
level: baseapi
servers:
- url: https://{environment}.demo.com
description: Select a server
variables:
environment:
enum:
- api
- api.dev
- api.test
default: api
paths:
$ref: './groups/statusGroup.yaml'
file statusGroups.yaml
/status:
get:
$ref: '../endpoint/status/getVersion.yaml'
There comes a time when the swagger.yaml file has many paths and reading them is difficult. Is it possible to separate the groups/tags into separate files? I'm trying to create one file per endpoint group for easy reading but the paths: property doesn't accept $ref: in its schema. It would be great to be able to do this.