How to generate the *.api.ts files based on a large yml spec

[Amansaxena001]

How to auto-generate separate files per tag for large OpenAPI specs?

---

Question

We have a large OpenAPI spec with 50+ tags. We want to generate separate files per tag (e.g., oauth.api.ts,
users.api.ts, tasks.api.ts).

Before writing custom scripts, I wanted to check:

1. Does mode: 'tags' automatically create one file per tag from the OpenAPI spec?
2. Can we customize the output file naming per tag (e.g., convert "JWT Token V1" → jwt-token-v1.api.ts)?
3. Is there a way to avoid manually defining 50+ config entries for each tag?

[melloware]

1. Docs state that here: https://orval.dev/docs/reference/configuration/output#tags you can do tags or tags-split

2. Docs state naming conventions: https://orval.dev/docs/reference/configuration/output#namingconvention

3. Not sure what your question is