If zone is primary, email is positional. (we cannot create a primary zone without it)
If zone is secondary, email should not be provided.
I think email should be considered a positional argument, as it is not optional in both cases.
In my humble opinion, we can change the email's Description in the API reference to be the following:
"e-mail for the zone. Required only if zone is PRIMARY, and used in SOA records for the zone".
Thank you for your feedback.
So I understand the following:
If zone is primary, email is positional. (we cannot create a primary zone without it)
If zone is secondary, email should not be provided.
I think email should be considered a positional argument, as it is not optional in both cases.
In my humble opinion, we can change the email's Description in the API reference to be the following:
"e-mail for the zone. Required only if zone is PRIMARY, and used in SOA records for the zone".