PUT api/v1/addressbook/groups/{groupID}

This method updates the group name of the group provided. The system will check that the new name does not already exist for the account.

Request Information

URI Parameters

Name	Description	Type	Additional information
groupID	The group to be modified	globally unique identifier	Required

Body Parameters

Either xml or json request.

TwoSms.CustomerPortalRole.API.AddressBooks.Group

Name	Description	Type	Additional information
GroupName	The name of the group.	string	Required

Request Formats

application/json, text/json

Sample:

{
  "GroupName": "sample string 1",
  "GroupID": "3bcaec51-0f7a-4b32-bb68-7c854a411911"
}

application/xml, text/xml

Sample:

<Group xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <GroupName>sample string 1</GroupName>
  <GroupID>3bcaec51-0f7a-4b32-bb68-7c854a411911</GroupID>
</Group>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'System.Web.Http.ModelBinding.JQueryMvcFormUrlEncodedFormatter' to write type 'TwoSms.CustomerPortalRole.API.AddressBooks.Group'.

Response Information

Resource Description

TwoSms.CustomerPortalRole.API.Misc.ResponseOfTwoSms.CustomerPortalRole.API.AddressBooks.Group

Name	Description	Type	Additional information
Error		TwoSms.CustomerPortalRole.API.Misc.Error	None.
ResponseData		TwoSms.CustomerPortalRole.API.Misc.ResponseDataOfTwoSms.CustomerPortalRole.API.AddressBooks.Group	None.

Response Formats

application/json, text/json

Sample:

{
  "Error": {
    "ErrorCode": "sample string 1",
    "ErrorReason": "sample string 2"
  },
  "ResponseData": {
    "Identification": {
      "UserId": "sample string 1"
    },
    "Result": "sample string 1",
    "Detail": {
      "GroupName": "sample string 1",
      "GroupID": "2dac5891-b1d5-4ebb-b82c-3b7e5e924eef"
    }
  }
}

application/xml, text/xml

Sample:

<ResponseOfGroup xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Error>
    <ErrorCode>sample string 1</ErrorCode>
    <ErrorReason>sample string 2</ErrorReason>
  </Error>
  <ResponseData>
    <Result>sample string 1</Result>
    <Identification>
      <UserId>sample string 1</UserId>
    </Identification>
    <Detail>
      <GroupName>sample string 1</GroupName>
      <GroupID>2dac5891-b1d5-4ebb-b82c-3b7e5e924eef</GroupID>
    </Detail>
  </ResponseData>
</ResponseOfGroup>