For Elixir teams building APIs, what are you using for OpenAPI documentation and API lifecycle management?

Chat & Discussions Chat / Discussions
1

We’re evaluating alternatives to Stoplight and looking for feedback on:

  • OpenAPI support

  • Documentation workflows

  • Testing capabilities

  • Migration experience

Any recommendations from teams running APIs in production?

1 Like
2

OpenAPI import/export is usually the easy part — the bigger differences show up around keeping specs in sync, handling changes, generating docs, and making sure tests actually reflect the contract.

For migration, I’d definitely try moving a smaller API first. A lot of tools look similar on paper but differ quite a bit once you bring over existing schemas, examples, auth flows, and CI checks.

1 Like
3

I have had good experience using open_api_spex | Hex for documentation.