chore(docs): OpenAPI examples and description updates (#1232)

* added api-examples

* Added examples for API's

* Added examples and description for API's

* Changed wordings

Author: LakshmiLavanyaKasturi