put

/accounts/{accountId}/users/{userId}/account

Disassociate a user from one Account and move the user to another Account under the same Master Account.

With this API, a user under a Master Account or a Sub Account can be moved to another Sub Account within the same Master Account. To move a user from a Master Account to a Sub Account, use me as the value for accountId. In this scenario, “me” refers to the Account ID of the Master Account.

To move a user from one Sub Account to another Sub Account, provide the Sub Account’s Account ID as the value for accountId.

Prerequisites:

  • The account should have Pro or a higher plan with Master Account option enabled.
  • The user whose account needs to be switched should not be an admin or an owner of that account.
  • The user should not have the same managed domain as the account owner.

Scope: user:master

Rate Limit Label: Light

Authorization

oauth2 - authorizationCode

Request Parameters

2 Path Parameters

Request Body

1 Example
Schema
object
account_id
string

The Account ID of the account to which you would like move the user to.

required

Responses

HTTP Status Code: 204
User’s account switched successfully.

Send a Test Request

Send requests directly from the browser (CORS must be enabled)
Path Params
2 path params not set
accountId
userId
$$.env
1 variable not set
oauth_access_token