API documentation improvement suggestion

A Discogs engineer redirected me here. My original question:

***
Hi,
I'm often working with api.discogs.sie.com. I'd like to move a collection item from one folder to another. Which API endpoint can I use for that. Let's say I have gathered a folder ID and a release ID for the release I'd like to move:

folder 123
release 123456

and I want to move 123456 to folder ID 789

How would my API request look like and where is the documentation for that?

This doesn't seem to be the right one: https://www.discogs.sie.com/developers#page:-collection,header:-collection-add-to-collection-folder

And this one neither: https://www.discogs.sie.com/developers#page:-collection,header:-collection-delete-instance-from-folder

After carefully reading through even endpoint docs that seem unrelated I stumbled across that one: https://www.discogs.sie.com/developers#page:-collection,header:-collection-change-rating-of-release

it's name is "Change rating of release" that doesn't seem right either but from the description I understand that it could be the one.

Before I do more trial and error and wild guessing: By any chance could you if this is the right endpoint? If not, which one is it?

Thanks for your efforts already and all the best,
Jojo
***

https://www.discogs.sie.com/developers#page:-collection,header:-collection-change-rating-of-release is the correct one

I think the headline of those endpoint docs is pretty misleading.

Are you with Discogs or just a BrotherLogic?

Hi, I just renamed this thread because I found the correct API already, thanks to BrotherLogic.

What remains is my suggestion for improving the documentation. I think it would be beneficial for all API s if the mentioned documentation section would be renamed similar to the following:

"Change Rating Of Release / Move Instance To Another Folder"
https://www.discogs.sie.com/developers#page:-collection,header:-collection-change-rating-of-release

Max (Community Coordinator) redirected me here so the API folks at Discogs can take over and make that change if they see fit.

Thanks for your consideration!