chore(docs): updating API docs

[allanbowe]

Issue

n/a

Intent

Updating API docs

Implementation

Updated the descriptions and ran npm run swagger to regenerate the swagger.yml

Checks

• [x] Code is formatted correctly (npm run lint:fix).
• [ ] Any new functionality has been unit tested.
• [ ] All unit tests are passing (npm test).
• [ ] All CI checks are green.
• [ ] Reviewer is assigned.

[sasjsbot]

:tada: This PR is included in version 0.21.2 :tada:

The release is available on:

• GitHub release
• v0.21.2

Your semantic-release bot :package::rocket: