API: deprecate toggle of superuser status in favor of new idempotent endpoint

[zearaujo25]

What this PR does / why we need it: Adds a new endpoint to make the superuser status change idempotent. Which issue(s) this PR closes:

• Closes #9887

Special notes for your reviewer: I wasn't able to run the integrations tests locally as i keep receiving the java connection refused error

Suggestions on how to test this: Integration test

Does this PR introduce a user interface change? If mockups are available, please link/include them here: no Is there a release notes update needed for this change?: New endpoint addition Additional documentation:

Preview at https://dataverse-guide--10440.org.readthedocs.build/en/10440/api/native-api.html#set-superuser-status