majiayu000 merge-openapi-specs
Use speakeasy merge to combine multiple specs into one.
Command
speakeasy merge -o <output-path> <spec1> <spec2> [spec3...]
Example
# Merge two specs
speakeasy merge -o combined.yaml ./api/users.yaml ./api/orders.yaml
# Merge multiple specs
speakeasy merge -o combined.yaml ./specs/*.yaml
Use Cases
- Microservices with separate specs per service
- API versioning with multiple spec files
- Combining public and internal API specs
Conflict Resolution
When specs have conflicts:
- Later specs override earlier ones for duplicate paths
- Schema conflicts may require manual resolution
- Review merged output for correctness