What sort of API is it? Web-based (as in REST or GraphQL)? Or software libraries? Curious the language, in that case...
You may also appreciate reading Swagger's tips: https://swagger.io/blog/api-documentation/best-practices-in-... and reading up on Swagger in general.