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

NameDescriptionTypeAdditional information
groupID

The group to be modified

globally unique identifier

Required

Body Parameters

Either xml or json request.

Group
NameDescriptionTypeAdditional information
GroupName

The name of the group.

string

Required

Request Formats

application/json, text/json

Sample:
{
  "GroupName": "sample string 1",
  "GroupID": "5c67de74-65e8-4034-af77-71820aff027b"
}

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>5c67de74-65e8-4034-af77-71820aff027b</GroupID>
</Group>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

ResponseOfGroup
NameDescriptionTypeAdditional information
Error

Error

None.

ResponseData

ResponseDataOfGroup

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": "9a8694aa-cda2-432f-85ac-f827eb1fdebd"
    }
  }
}

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>9a8694aa-cda2-432f-85ac-f827eb1fdebd</GroupID>
    </Detail>
  </ResponseData>
</ResponseOfGroup>