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/ApplicationProfiles/actions/runs/28827220710

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/