docs: 📝 improve /tenant API documentation

Closed Sacha Brants requested to merge slb/sb/fix-openapi-tenant into master

Clarifies the various parameters needed to register a data partition.

Merge request reports