Change team

put/v1/users/changeTeam

This API allows you to move users from one team to another. You can also set it to either transfer their documents to another user or retain them.

curl --location --request PUT 'https://api.boldsign.com/v1/users/changeTeam?userId=d98c14c5-60e0-411f-b02d-b39ca83c0da8' \
--header 'accept: */*' \
--header 'X-API-KEY: {apikey}' \
--header 'Content-Type: application/json' \
--data '{
  "toTeamId": "9bca0986-xxx-xxxx-xxx-30ffe3a2c5b7",
  "transferDocumentsToUserId": "8117b911-xxx-xxxx-xxx-819aab1e2bd5"
}'
// requires beta version of the SDK at least v4.10.18-beta
var apiClient = new ApiClient("https://api.boldsign.com", "{apikey}");
var userClient = new UserClient(apiClient);

var changeTeam = new ChangeTeam()
{
    ToTeamId = "9bca0986-xxx-xxxx-xxx-30ffe3a2c5b7",
    TransferDocumentsToUserId = "8117b911-xxx-xxxx-xxx-819aab1e2bd5"
};

await userClient.ChangeTeam("UserId", changeTeam);
import boldsign
from boldsign.models import ChangeTeam

configuration = boldsign.Configuration(api_key="YOUR_API_KEY")

with boldsign.ApiClient(configuration) as api_client:
    
    change_teams_api = boldsign.UserApi(api_client)
    change_team = boldsign.ChangeTeamRequest(
        to_team_id = "YOUR_TEAM_ID",
    )
    team_details_response = change_teams_api.change_team(
        user_id="YOUR_USER_ID",
        change_team_request= change_team
    )
import { UserApi, ChangeTeamRequest} from 'boldsign';
const userApi = new UserApi();
userApi.setApiKey("YOUR_API_KEY");
var changeTeam = new ChangeTeamRequest();
changeTeam.toTeamId = "YOUR_TEAM_ID";
userApi.changeTeam("YOUR_USER_ID",changeTeam);
<?php
require_once "vendor/autoload.php";

$config = new BoldSign\Configuration();
$config->setApiKey('YOUR_API_KEY');
$apiInstance = new BoldSign\Api\UserApi($config);
$changeTeam = new BoldSign\Model\ChangeTeamRequest();
$changeTeam->setToTeamId("YOUR_TEAM_ID");
$apiInstance->changeTeam("YOUR_USER_ID",$changeTeam);
ApiClient apiClient = Configuration.getDefaultApiClient();
apiClient.setApiKey("YOUR_API_KEY");
UserApi userApi = new UserApi(apiClient);
ChangeTeamRequest changeTeamRequest = new ChangeTeamRequest();
changeTeamRequest.setToTeamId("YOUR_TEAM_ID");
userApi.changeTeam("YOUR_USER_ID", changeTeamRequest);
userIdStringRequiredThe User ID of the user. It can be obtained from users and teams from the web app.
ToTeamIdstringRequiredThe team ID to which the user is transferred.

TransferDocumentsToUserIdstring

The target user ID to which the user can transfer documents while changing the team.

Note:

  1. If a document is currently in-progress then the document will be declined or revoked.

  2. All sender identity approvals for the deleted user will be revoked, and the reassigned user will need to obtain approval again from those sender identities to access the on-behalf documents.

200 Success