# Update Team PUT https://api.hellosign.com/v3/team Content-Type: application/json Updates the name of your Team. Reference: https://developer.hellosign.com/api/team/update ## OpenAPI Specification ```yaml openapi: 3.1.1 info: title: Update Team version: endpoint_team.update paths: /team: put: operationId: update summary: Update Team description: Updates the name of your Team. tags: - - subpackage_team parameters: - name: Authorization in: header description: Basic authentication of the form `Basic `. required: true schema: type: string responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/TeamGetResponse' '400': description: failed_operation content: {} requestBody: content: application/json: schema: $ref: '#/components/schemas/TeamUpdateRequest' components: schemas: TeamUpdateRequest: type: object properties: name: type: string description: The name of your Team. AccountResponseQuotas: type: object properties: api_signature_requests_left: type: - integer - 'null' description: API signature requests remaining. documents_left: type: - integer - 'null' description: Signature requests remaining. templates_total: type: - integer - 'null' description: Total API templates allowed. templates_left: type: - integer - 'null' description: API templates remaining. sms_verifications_left: type: - integer - 'null' description: SMS verifications remaining. num_fax_pages_left: type: - integer - 'null' description: Number of fax pages left AccountResponseUsage: type: object properties: fax_pages_sent: type: - integer - 'null' description: Number of fax pages sent AccountResponse: type: object properties: account_id: type: string description: The ID of the Account email_address: type: string description: The email address associated with the Account. is_locked: type: boolean description: >- Returns `true` if the user has been locked out of their account by a team admin. is_paid_hs: type: boolean description: Returns `true` if the user has a paid Dropbox Sign account. is_paid_hf: type: boolean description: Returns `true` if the user has a paid HelloFax account. quotas: $ref: '#/components/schemas/AccountResponseQuotas' callback_url: type: - string - 'null' description: The URL that Dropbox Sign events will `POST` to. role_code: type: - string - 'null' description: The membership role for the team. team_id: type: - string - 'null' description: The id of the team account belongs to. locale: type: - string - 'null' description: >- The locale used in this Account. Check out the list of [supported locales](/api/reference/constants/#supported-locales) to learn more about the possible values. usage: $ref: '#/components/schemas/AccountResponseUsage' TeamResponse: type: object properties: name: type: string description: The name of your Team accounts: type: array items: $ref: '#/components/schemas/AccountResponse' invited_accounts: type: array items: $ref: '#/components/schemas/AccountResponse' description: >- A list of all Accounts that have an outstanding invitation to join your Team. Note that this response is a subset of the response parameters found in `GET /account`. invited_emails: type: array items: type: string description: >- A list of email addresses that have an outstanding invitation to join your Team and do not yet have a Dropbox Sign account. WarningResponse: type: object properties: warning_msg: type: string description: Warning message warning_name: type: string description: Warning name required: - warning_msg - warning_name TeamGetResponse: type: object properties: team: $ref: '#/components/schemas/TeamResponse' warnings: type: array items: $ref: '#/components/schemas/WarningResponse' description: A list of warnings. required: - team ``` ## SDK Code Examples ```php PHP setUsername("YOUR_API_KEY"); // $config->setAccessToken("YOUR_ACCESS_TOKEN"); $team_update_request = (new Dropbox\Sign\Model\TeamUpdateRequest()) ->setName("New Team Name"); try { $response = (new Dropbox\Sign\Api\TeamApi(config: $config))->teamUpdate( team_update_request: $team_update_request, ); print_r($response); } catch (Dropbox\Sign\ApiException $e) { echo "Exception when calling TeamApi#teamUpdate: {$e->getMessage()}"; } ``` ```csharp C# using System; using System.Collections.Generic; using System.IO; using System.Text.Json; using Dropbox.Sign.Api; using Dropbox.Sign.Client; using Dropbox.Sign.Model; namespace Dropbox.SignSandbox; public class TeamUpdateExample { public static void Run() { var config = new Configuration(); config.Username = "YOUR_API_KEY"; // config.AccessToken = "YOUR_ACCESS_TOKEN"; var teamUpdateRequest = new TeamUpdateRequest( name: "New Team Name" ); try { var response = new TeamApi(config).TeamUpdate( teamUpdateRequest: teamUpdateRequest ); Console.WriteLine(response); } catch (ApiException e) { Console.WriteLine("Exception when calling TeamApi#TeamUpdate: " + e.Message); Console.WriteLine("Status Code: " + e.ErrorCode); Console.WriteLine(e.StackTrace); } } } ``` ```typescript TypeScript import * as fs from 'fs'; import api from "@dropbox/sign" import models from "@dropbox/sign" const apiCaller = new api.TeamApi(); apiCaller.username = "YOUR_API_KEY"; // apiCaller.accessToken = "YOUR_ACCESS_TOKEN"; const teamUpdateRequest: models.TeamUpdateRequest = { name: "New Team Name", }; apiCaller.teamUpdate( teamUpdateRequest, ).then(response => { console.log(response.body); }).catch(error => { console.log("Exception when calling TeamApi#teamUpdate:"); console.log(error.body); }); ``` ```java Java package com.dropbox.sign_sandbox; import com.dropbox.sign.ApiException; import com.dropbox.sign.Configuration; import com.dropbox.sign.api.*; import com.dropbox.sign.auth.*; import com.dropbox.sign.JSON; import com.dropbox.sign.model.*; import java.io.File; import java.math.BigDecimal; import java.time.LocalDate; import java.time.OffsetDateTime; import java.util.ArrayList; import java.util.List; import java.util.Map; public class TeamUpdateExample { public static void main(String[] args) { var config = Configuration.getDefaultApiClient(); ((HttpBasicAuth) config.getAuthentication("api_key")).setUsername("YOUR_API_KEY"); // ((HttpBearerAuth) config.getAuthentication("oauth2")).setBearerToken("YOUR_ACCESS_TOKEN"); var teamUpdateRequest = new TeamUpdateRequest(); teamUpdateRequest.name("New Team Name"); try { var response = new TeamApi(config).teamUpdate( teamUpdateRequest ); System.out.println(response); } catch (ApiException e) { System.err.println("Exception when calling TeamApi#teamUpdate"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } } ``` ```ruby Ruby require "json" require "dropbox-sign" Dropbox::Sign.configure do |config| config.username = "YOUR_API_KEY" # config.access_token = "YOUR_ACCESS_TOKEN" end team_update_request = Dropbox::Sign::TeamUpdateRequest.new team_update_request.name = "New Team Name" begin response = Dropbox::Sign::TeamApi.new.team_update( team_update_request, ) p response rescue Dropbox::Sign::ApiError => e puts "Exception when calling TeamApi#team_update: #{e}" end ``` ```python Python import json from datetime import date, datetime from pprint import pprint from dropbox_sign import ApiClient, ApiException, Configuration, api, models configuration = Configuration( username="YOUR_API_KEY", # access_token="YOUR_ACCESS_TOKEN", ) with ApiClient(configuration) as api_client: team_update_request = models.TeamUpdateRequest( name="New Team Name", ) try: response = api.TeamApi(api_client).team_update( team_update_request=team_update_request, ) pprint(response) except ApiException as e: print("Exception when calling TeamApi#team_update: %s\n" % e) ``` ```go Team Update package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.hellosign.com/v3/team" req, _ := http.NewRequest("PUT", url, nil) req.Header.Add("Authorization", "Basic :") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```swift Team Update import Foundation let headers = [ "Authorization": "Basic :", "Content-Type": "application/json" ] let request = NSMutableURLRequest(url: NSURL(string: "https://api.hellosign.com/v3/team")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "PUT" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ```php PHP setUsername("YOUR_API_KEY"); // $config->setAccessToken("YOUR_ACCESS_TOKEN"); $team_update_request = (new Dropbox\Sign\Model\TeamUpdateRequest()) ->setName("New Team Name"); try { $response = (new Dropbox\Sign\Api\TeamApi(config: $config))->teamUpdate( team_update_request: $team_update_request, ); print_r($response); } catch (Dropbox\Sign\ApiException $e) { echo "Exception when calling TeamApi#teamUpdate: {$e->getMessage()}"; } ``` ```csharp C# using System; using System.Collections.Generic; using System.IO; using System.Text.Json; using Dropbox.Sign.Api; using Dropbox.Sign.Client; using Dropbox.Sign.Model; namespace Dropbox.SignSandbox; public class TeamUpdateExample { public static void Run() { var config = new Configuration(); config.Username = "YOUR_API_KEY"; // config.AccessToken = "YOUR_ACCESS_TOKEN"; var teamUpdateRequest = new TeamUpdateRequest( name: "New Team Name" ); try { var response = new TeamApi(config).TeamUpdate( teamUpdateRequest: teamUpdateRequest ); Console.WriteLine(response); } catch (ApiException e) { Console.WriteLine("Exception when calling TeamApi#TeamUpdate: " + e.Message); Console.WriteLine("Status Code: " + e.ErrorCode); Console.WriteLine(e.StackTrace); } } } ``` ```typescript TypeScript import * as fs from 'fs'; import api from "@dropbox/sign" import models from "@dropbox/sign" const apiCaller = new api.TeamApi(); apiCaller.username = "YOUR_API_KEY"; // apiCaller.accessToken = "YOUR_ACCESS_TOKEN"; const teamUpdateRequest: models.TeamUpdateRequest = { name: "New Team Name", }; apiCaller.teamUpdate( teamUpdateRequest, ).then(response => { console.log(response.body); }).catch(error => { console.log("Exception when calling TeamApi#teamUpdate:"); console.log(error.body); }); ``` ```java Java package com.dropbox.sign_sandbox; import com.dropbox.sign.ApiException; import com.dropbox.sign.Configuration; import com.dropbox.sign.api.*; import com.dropbox.sign.auth.*; import com.dropbox.sign.JSON; import com.dropbox.sign.model.*; import java.io.File; import java.math.BigDecimal; import java.time.LocalDate; import java.time.OffsetDateTime; import java.util.ArrayList; import java.util.List; import java.util.Map; public class TeamUpdateExample { public static void main(String[] args) { var config = Configuration.getDefaultApiClient(); ((HttpBasicAuth) config.getAuthentication("api_key")).setUsername("YOUR_API_KEY"); // ((HttpBearerAuth) config.getAuthentication("oauth2")).setBearerToken("YOUR_ACCESS_TOKEN"); var teamUpdateRequest = new TeamUpdateRequest(); teamUpdateRequest.name("New Team Name"); try { var response = new TeamApi(config).teamUpdate( teamUpdateRequest ); System.out.println(response); } catch (ApiException e) { System.err.println("Exception when calling TeamApi#teamUpdate"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } } ``` ```ruby Ruby require "json" require "dropbox-sign" Dropbox::Sign.configure do |config| config.username = "YOUR_API_KEY" # config.access_token = "YOUR_ACCESS_TOKEN" end team_update_request = Dropbox::Sign::TeamUpdateRequest.new team_update_request.name = "New Team Name" begin response = Dropbox::Sign::TeamApi.new.team_update( team_update_request, ) p response rescue Dropbox::Sign::ApiError => e puts "Exception when calling TeamApi#team_update: #{e}" end ``` ```python Python import json from datetime import date, datetime from pprint import pprint from dropbox_sign import ApiClient, ApiException, Configuration, api, models configuration = Configuration( username="YOUR_API_KEY", # access_token="YOUR_ACCESS_TOKEN", ) with ApiClient(configuration) as api_client: team_update_request = models.TeamUpdateRequest( name="New Team Name", ) try: response = api.TeamApi(api_client).team_update( team_update_request=team_update_request, ) pprint(response) except ApiException as e: print("Exception when calling TeamApi#team_update: %s\n" % e) ``` ```go Default Example package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.hellosign.com/v3/team" payload := strings.NewReader("{\n \"name\": \"New Team Name\"\n}") req, _ := http.NewRequest("PUT", url, payload) req.Header.Add("Authorization", "Basic :") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```swift Default Example import Foundation let headers = [ "Authorization": "Basic :", "Content-Type": "application/json" ] let parameters = ["name": "New Team Name"] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.hellosign.com/v3/team")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "PUT" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```