EDU-13834 - Add new parameter and update descriptions

[mariananantua]

Types of changes

• New content (endpoints, descriptions or fields from scratch)
• Improvement (make an endpoint's title or description even better)
• Spelling and grammar accuracy (self-explanatory)

Changelog

Do not forget to update your changes to our Developer Portal's changelog. Did you create a release note?

• Yes, I already created a release note about this change.
• No, but I am going to.

[github-actions]

Thanks for your contribution. The .json file will be checked now with Spectral.

[PedroAntunesCosta]

I recommend addressing the spectral alerts. Especially because the permissions are already indicated in some of the endpoints, just not in the format we standardized. See our doc on Endpoint permissions.

[PedroAntunesCosta]

Good job! But you must update the branch and, possibly, address conflicts.