Issue Summary

The document Upgrade a Bitbucket cluster through the API without downtime provides the user with a warning:

Authenticating REST API calls

In a secure environment, you'll need to authenticate your REST API calls. See Personal access tokens and Bitbucket Server REST API Example - Basic Authentication for more information.

However, /rest/zdu endpoints can't be authenticated with HTTP tokens.

This is reproducible on Data Center: yes

Steps to Reproduce

Upgrade a Bitbucket cluster through the API without downtime

Expected Results

Only basic authentication is mentioned. HTTP access tokens are referred instead of Personal Access Tokens.

Actual Results

A generic message about REST authentication is displayed that can mislead the customers.

Workaround

Use only basic authentication for ZDU endpoints.