Update openapi.yaml with missing spec

What does this MR do and why?

This MR adds many missing Open API specs.

I dont think we should merge it though, it's too much for manual review, I am raising an issue to propose an automated ay of verifying the spec against the API to validate it's correct.

I used chat gpt to generate the missing yaml by batch feeding it the markdown documentation

Screenshots or screen recordings

How to set up and validate locally

use cli tool if you want to validate, online swagger editor struggles with large size of yaml

npm install -g swagger-cli
swagger-cli validate ,filename