> openapi-lint
> npx --yes @redocly/cli lint ./api/openapi.yml

validating ./api/openapi.yml...
[1] api/openapi.yml:2:1 at #/openapi

Servers must be present.

1 | # yaml-language-server: $schema=https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/schemas/v3.1/schema.json
2 | openapi: 3.1.0
3 | info:
4 |   title: CrossLab Device Service REST API (internal)

Warning was generated by the no-empty-servers rule.


[2] api/openapi.yml:3:1 at #/info

Info object should contain `license` field.

1 | # yaml-language-server: $schema=https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/schemas/v3.1/schema.json
2 | openapi: 3.1.0
3 | info:
4 |   title: CrossLab Device Service REST API (internal)
5 |   description: |-

Warning was generated by the info-license rule.


[3] api/parameters/device_id.yml:3:7 at #/name

Path parameter `device_id` is not used in the path `{$request.query.changedUrl}`.

1 | # yaml-language-server: $schema=https://cross-lab-project.github.io/crosslab/meta-schemas/openapi-parameter.json
2 | in: path
3 | name: device_id
4 | description: UUID of the device
5 | required: true

Warning was generated by the path-parameters-defined rule.


[4] api/parameters/device_id.yml:3:7 at #/name

Path parameter `device_id` is not used in the path `{$request.query.changedUrl}`.

1 | # yaml-language-server: $schema=https://cross-lab-project.github.io/crosslab/meta-schemas/openapi-parameter.json
2 | in: path
3 | name: device_id
4 | description: UUID of the device
5 | required: true

Warning was generated by the path-parameters-defined rule.


./api/openapi.yml: validated in 139ms

Woohoo! Your OpenAPI definition is valid. 🎉
You have 4 warnings.