PUT api/v2/admin/accounts/{id}/addressbookgrouppermissions

This method modifies addressbook group permissions for chosen sub accounts. You can only modify permissions for sub accounts that are one level below. Changing group permissions for sub that is one level below will automatically take care of all the subs that are below in the hierarchy.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
id

The account ID

globally unique identifier

Required

Body Parameters

AccountAddressbookGroupPermissionV2Request
NameDescriptionTypeAdditional information
AccountsAddressBookGroupAccess

Collection of AccountAddressBookGroupPermissionDetails

None.

Request Formats

application/json, text/json

Sample:
{
  "AccountsAddressBookGroupAccess": [
    {
      "ID": "1343bd1b-8cd3-46c7-98bf-2645369a181f",
      "GroupID": "bc9d4bc1-d90e-46b1-b464-f9087a5a144d",
      "PermissionLevel": 0
    },
    {
      "ID": "1343bd1b-8cd3-46c7-98bf-2645369a181f",
      "GroupID": "bc9d4bc1-d90e-46b1-b464-f9087a5a144d",
      "PermissionLevel": 0
    }
  ]
}

application/xml, text/xml

Sample:
<AccountAddressbookGroupPermissionV2Request xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <AccountsAddressBookGroupAccess>
    <AccountAddressBookGroupPermissionDetails>
      <ID>1343bd1b-8cd3-46c7-98bf-2645369a181f</ID>
      <GroupID>bc9d4bc1-d90e-46b1-b464-f9087a5a144d</GroupID>
      <PermissionLevel>NONE</PermissionLevel>
    </AccountAddressBookGroupPermissionDetails>
    <AccountAddressBookGroupPermissionDetails>
      <ID>1343bd1b-8cd3-46c7-98bf-2645369a181f</ID>
      <GroupID>bc9d4bc1-d90e-46b1-b464-f9087a5a144d</GroupID>
      <PermissionLevel>NONE</PermissionLevel>
    </AccountAddressBookGroupPermissionDetails>
  </AccountsAddressBookGroupAccess>
  <UserPassword>sample string 1</UserPassword>
</AccountAddressbookGroupPermissionV2Request>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

ResponseOfAccountAddressbookGroupPermissionResponse[]
NameDescriptionTypeAdditional information
Error

Error

None.

ResponseData

ResponseDataOfAccountAddressbookGroupPermissionResponse[]

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": [
      {
        "ID": "567b1ed4-13e3-4038-bb30-4b7dd68bb966",
        "Name": "sample string 2",
        "GroupID": "72b68ff4-3d68-4013-832f-ba70fe1e077a",
        "GroupName": "sample string 4",
        "PermissionLevel": 0
      },
      {
        "ID": "567b1ed4-13e3-4038-bb30-4b7dd68bb966",
        "Name": "sample string 2",
        "GroupID": "72b68ff4-3d68-4013-832f-ba70fe1e077a",
        "GroupName": "sample string 4",
        "PermissionLevel": 0
      }
    ]
  }
}

application/xml, text/xml

Sample:
<ResponseOfArrayOfAccountAddressbookGroupPermissionResponse 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>
      <AccountAddressbookGroupPermissionResponse>
        <ID>567b1ed4-13e3-4038-bb30-4b7dd68bb966</ID>
        <Name>sample string 2</Name>
        <GroupID>72b68ff4-3d68-4013-832f-ba70fe1e077a</GroupID>
        <GroupName>sample string 4</GroupName>
        <PermissionLevel>NONE</PermissionLevel>
      </AccountAddressbookGroupPermissionResponse>
      <AccountAddressbookGroupPermissionResponse>
        <ID>567b1ed4-13e3-4038-bb30-4b7dd68bb966</ID>
        <Name>sample string 2</Name>
        <GroupID>72b68ff4-3d68-4013-832f-ba70fe1e077a</GroupID>
        <GroupName>sample string 4</GroupName>
        <PermissionLevel>NONE</PermissionLevel>
      </AccountAddressbookGroupPermissionResponse>
    </Detail>
  </ResponseData>
</ResponseOfArrayOfAccountAddressbookGroupPermissionResponse>