Update Group

Update Group

This endpoint can be used to update the details of a group created in TaxBandits. You can update the name, reference ID, or as needed.

• If you need to assign new payers and team members to the group, use the 'AsgnPayers' and 'AsgnMembers' objects, respectively.
• If you need to remove the existing payers and team members from the group, use the 'RemovePayers' and 'RemoveMembers' objects, respectively.

PUT TeamMember/UpdateGroup 

Request Body

Field	Type	Description
TeamMemberDetails	object[]	Object to identify the team member and group details
GroupId	Guid	Unique identifier for the group
GroupNm	string	Name of the Group Size Range: 3..75
GroupRef	string	Unique reference for the group Size Range: ..100
GroupDesc	string	Description for the group Size Range: ..100
AsgnPayers	object[]	Object to identify the assigned payer details for the group
BusinessId	Guid	A unique identifier of the Business
PayerRef	string	A Unique reference of the payer
RemovePayers	object[]	Object to identify the assigned payer details to be unlinked from the group
BusinessId	Guid	A unique identifier of the Business
PayerRef	string	A Unique reference of the payer
AsgnMembers	object[]	Object to identify the assigned team member details for the group
MemberId	Guid	A unique identifier of the team member
MemberRef	string	A Unique reference of the team member
RemoveMembers	object[]	Object to identify the assigned team member details to be unlinked from the group
MemberId	Guid	A unique identifier of the team member
MemberRef	string	A Unique reference of the team member

Response Body

Field	Type	Description
SuccessRecords	object[]	Returns detailed information about the success records
GroupId	Guid	Returns unique identifier of the group
GroupNm	string	Returns the name of the group
GroupRef	string	Returns unique reference for the group
GroupDesc	string	Returns the description for the group
AsgnPayers	object[]	Object to identify the assigned payer details for the group
BusinessId	Guid	Returns unique identifier of the Business
PayerRef	string	Returns Unique reference of the payer
AsgnMembers	object[]	Object to identify the assigned team member details for the group
MemberId	Guid	Returns unique identifier of the team member
MemberRef	string	Returns unique reference of the team member
RemovePayers	object[]	Object to identify the assigned payer details to be unlinked from the group
BusinessId	Guid	Returns unique identifier of the Business
PayerRef	string	Returns Unique reference of the payer
RemoveMembers	object[]	Object to identify the assigned team member details to be unlinked from the group
MemberId	Guid	Returns unique identifier of the team member
MemberRef	string	Returns unique reference of the team member
ErrorRecords	object[]	Returns detailed information about the error records
GroupNm	string	Returns the name of the group
GroupRef	string	Returns unique reference for the group
GroupDesc	string	Returns the description for the group
AsgnPayers	object[]	Object to identify the assigned payer details for the group
BusinessId	Guid	A unique identifier of the Business
PayerRef	string	A Unique reference of the payer
AsgnMembers	object[]	Object to identify the assigned team member details for the group
MemberId	Guid	A unique identifier of the team member
MemberRef	string	A Unique reference of the team member
RemovePayers	object[]	Object to identify the assigned payer details to be unlinked from the group
BusinessId	Guid	Returns unique identifier of the Business
PayerRef	string	Returns Unique reference of the payer
RemoveMembers	object[]	Object to identify the assigned team member details to be unlinked from the group
MemberId	Guid	Returns unique identifier of the team member
MemberRef	string	Returns unique reference of the team member
Errors	object[]	Shows detailed error information
Id	string	Returns the validation error ID
Name	string	Name of the validation error
Message	string	Description of the validation error
Errors	object[]	Shows detailed error information
Id	string	Returns the validation error ID
Name	string	Name of the validation error
Message	string	Description of the validation error

Request JSON

{
    "TeamMemberDetails": [
        {
            "GroupId": 12904,
            "GroupNm": "Team 94x",
            "GroupRef": "94x",
            "GroupDesc": "The team handling 94x clients",
            "AsgnPayers": [
                {
                    "BusinessId": "e0b1d38e-770f-417b-a613-67c9563fa9a9"
                }
            ],
                        "AsgnMembers": [
                {
                    "MemberId": "f12226dc-1e7e-44d7-babd-114db0283df2"
                }
            ],
            
        }
    ]
}

Response JSON

Success Response - This is a sample response for successful API requests.

{
    "SuccessRecords": [
        {
            "GroupId": 12904,
            "GroupNm": "Team 94x",
            "GroupRef": "94x",
            "GroupDesc": "The team handling 94x clients",
            "AsgnPayers": [
                {
                    "BusinessId": "e0b1d38e-770f-417b-a613-67c9563fa9a9",
                    "PayerRef": null
                }
            ],
            "AsgnMembers": [
                {
                    "MemberId": "f12226dc-1e7e-44d7-babd-114db0283df2",
                    "MemberRef": null
                }
            ],
            "Status": "SUCCESS"
        }
    ],
    "ErrorRecords": null,
    "Errors": null
}