diff --git a/doc/rapi.rst b/doc/rapi.rst
index 89ce59017425e242238923a6160bda254c0fbba2..99f05907d7eb92baf3aa6b7bf3ab6bb0ae8223a5 100644
--- a/doc/rapi.rst
+++ b/doc/rapi.rst
@@ -1301,11 +1301,14 @@ It supports the following commands: ``GET``, ``PUT``.
 The role is always one of the following:
 
   - drained
-  - master
   - master-candidate
   - offline
   - regular
 
+Note that the 'master' role is a special, and currently it can't be
+modified via RAPI, only via the command line (``gnt-cluster
+master-failover``).
+
 ``GET``
 ~~~~~~~