Update API definition to fix CAMARA validation warnings and hints

**Problem description**
The automated CAMARA validation review is reporting many warnings and hints

**Expected behaviour**
Fix as many warnings and hints as possible

**Alternative solution**
None

**Additional context**
