documenting #7521

1 files changed, 16 insertions, 0 deletions

diff --git a/libeufin/api-sandbox.rst b/libeufin/api-sandbox.rst
index ea87cb84..c9b9561f 100644
--- a/libeufin/api-sandbox.rst
+++ b/libeufin/api-sandbox.rst
@@ -131,6 +131,11 @@ Accounts
    Allows the administrator and the user to reconfigure
    the account data of ``$username``.
 
+   .. note::
+     
+     Only the administrator has the rights to change the
+     user legal name.
+
    **Request:**
 
    .. ts:def:: CircuitAccountReconfiguration
@@ -145,6 +150,10 @@ Accounts
        // wants to convert the local currency back
        // to fiat.
        cashout_address: string;
+
+       // Legal name associated with $username.  NOTE:
+       // only the administrator can change this value.
+       name?: string;
      }
 
    **Response:**
@@ -152,6 +161,13 @@ Accounts
    :http:statuscode:`204 No content`:
      Operation successful.
 
+   :http:statuscode:`403 Forbidden`:
+     The rights to change ``$username`` are not sufficient.
+     That includes the case where a correctly authenticated
+     user tries to change their legal name.  It also
+     includes the case where 'admin' tries to change its
+     own account.
+
    :http:statuscode:`404 Not found`:
      The account pointed by ``$username``
      was not found.