This commit includes updates to the `swagger.yaml` file to reflect the latest documentation for the API. It provides more accurate and up-to-date information about the available endpoints and their usage. BREAKING CHANGE: None