Update API definitions to fix CAMARA validation warnings

[maheshc01]

Problem description
CAMARA validation is giving warnings and hints for current definition
see: https://github.com/camaraproject/ApplicationEndpointDiscovery/actions/runs/28826755338

Expected behavior
Update definition to remove warnings, and as many hints as required

Alternative solution
None

Additional context
Some warnings can be fixed using $refs to common schema files in code/common/

[maheshc01]

fixed.