Updating the Swagger Content

[shavidissa]

Purpose

Copy-edited the swagger content.

Goals

refined swagger content.

Approach

N/A

User stories

N/A

Release note

N/A

Documentation

These will affect the 3.2.0 swagger docs. It is still being hosted.

Training

N/A

Certification

N/A

Marketing

N/A

Automation tests

N/A

Security checks

• Followed secure coding standards in http://wso2.com/technical-reports/wso2-secure-engineering-guidelines? yes/no
• Ran FindSecurityBugs plugin and verified report? yes/no
• Confirmed that this PR doesn't commit any keys, passwords, tokens, usernames, or other secrets? yes/no

Samples

Provide high-level details about the samples related to this feature

Related PRs

List any other related PRs

Migrations (if applicable)

Describe migration steps and platforms on which migration has been tested

Test environment

List all JDK versions, operating systems, databases, and browser/versions on which this feature/fix was tested

Learning

Describe the research phase and any blog posts, patterns, libraries, or add-ons you used to solve the problem.