docs: 📝 improve /tenant API documentation

6 jobs for !157 with slb/sb/fix-openapi-tenant in 10 minutes and 44 seconds (queued for 5 seconds)
detached
Status Job ID Name Coverage
  Review
failed trigger-trusted-tests #461359
osdu-small

00:10:44

failed trigger-trusted-tests #461308
osdu-small

00:10:34

failed trigger-trusted-tests #461286
osdu-small

00:13:27

 
  Build
skipped compile-and-unit-test #461287
osdu-medium
 
  Containerize
skipped push_runtime_image #461288
osdu-medium
 
  Scan
skipped lint #461289
osdu-small
 
Name Stage Failure
failed
trigger-trusted-tests Review
Pipeline has been in state 'running' for 9.3 min, waiting for completion
Pipeline has been in state 'running' for 9.5 min, waiting for completion
Pipeline has been in state 'running' for 9.6 min, waiting for completion
Pipeline has been in state 'running' for 9.8 min, waiting for completion
Pipeline has been in state 'failed' for 6 sec, waiting for completion
Pipeline completed in state failed in 9.7 min
Pipeline status is not 'success', exiting with error status
Cleaning up file based variables
ERROR: Job failed: exit code 1