mail-in-a-box / mailinabox

Mail-in-a-Box helps individuals take back control of their email by defining a one-click, easy-to-deploy SMTP+everything else server: a mail server in a box.

Home Page:https://mailinabox.email/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

OpenApi definition is out of date

ahmednfwela opened this issue · comments

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 ?