Versioning

The developer who owns a tenant API is in control of that API's definition.

Any changes to an API definition should be made in a non-breaking style, (as per openstack)

Generally acceptable

Generally not acceptable

If you need to make a breaking change, you should define a new tenant API instead.