Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

OpenApi definition is out of date #2314

Open
ahmednfwela opened this issue Oct 12, 2023 · 0 comments
Open

OpenApi definition is out of date #2314

ahmednfwela opened this issue Oct 12, 2023 · 0 comments

Comments

@ahmednfwela
Copy link

First; The link presented here is wrong
image
It leads to https://raw.githubusercontent.com/mail-in-a-box/mailinabox/api-spec/api/mailinabox.yml
which is 404.
Second; The api definition found here:
https://github.com/mail-in-a-box/mailinabox/blob/main/api/mailinabox.yml
is out of date in multiple places:

  1. A lot of properties should be marked as nullable: true, but aren't, e.g. in MeResponse, only the status should be required and not nullable.
  2. MailAlias is missing auto property, and should have no required property.

and that is from my initial testing, I will be adding more as I stumble on them.

Is there any way I can contribute to fix this ? where is the api source of truth ?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant