Platform API

<back to all web services

UpdateContactGroup

Update the specified contact group

Requires Authentication
The following routes are available for this service:
PUT/api/contactgroups/{ContactGroupId}
import java.math.*;
import java.util.*;
import java.io.InputStream;
import net.servicestack.client.*;

public class dtos
{

    /**
    * Update the specified contact group
    */
    @Api(Description="Update the specified contact group")
    public static class UpdateContactGroup
    {
        /**
        * Id of Contact group to be updated
        */
        @ApiMember(Description="Id of Contact group to be updated", Name="CustomerGroupId")
        public UUID CustomerGroupId = null;

        public String CustomerName = null;
        public UUID NameTypeId = null;
        public ArrayList<ContactGroupConnectionModel> Contacts = null;
        public String RecordStatus = null;
        
        public UUID getCustomerGroupId() { return CustomerGroupId; }
        public UpdateContactGroup setCustomerGroupId(UUID value) { this.CustomerGroupId = value; return this; }
        public String getCustomerName() { return CustomerName; }
        public UpdateContactGroup setCustomerName(String value) { this.CustomerName = value; return this; }
        public UUID getNameTypeId() { return NameTypeId; }
        public UpdateContactGroup setNameTypeId(UUID value) { this.NameTypeId = value; return this; }
        public ArrayList<ContactGroupConnectionModel> getContacts() { return Contacts; }
        public UpdateContactGroup setContacts(ArrayList<ContactGroupConnectionModel> value) { this.Contacts = value; return this; }
        public String getRecordStatus() { return RecordStatus; }
        public UpdateContactGroup setRecordStatus(String value) { this.RecordStatus = value; return this; }
    }

    public static class ContactGroupConnectionModel extends UserProfileSummaryModel
    {
        /**
        * Contact Group Id
        */
        @ApiMember(DataType="Guid", Description="Contact Group Id", Name="ContactGroupId")
        public UUID ContactGroupId = null;

        /**
        * Connection id of the contact in the group
        */
        @ApiMember(DataType="string", Description="Connection id of the contact in the group", Name="ContactGroupConnectionId")
        public UUID ContactGroupConnectionId = null;

        /**
        * The Id of the Role this contact is connected to the group with.
        */
        @ApiMember(DataType="string", Description="The Id of the Role this contact is connected to the group with.", Name="ConnectionRoleId")
        public UUID ConnectionRoleId = null;

        /**
        * Order of contacts within a group, the primary contact will have an index of 1.
        */
        @ApiMember(DataType="int", Description="Order of contacts within a group, the primary contact will have an index of 1.", Name="Index")
        public Integer Index = null;

        /**
        * List of roles that the contact in the contact group has across appliances for e.g. Platform Customer, Nexus customer etc.
        */
        @ApiMember(DataType="string", Description="List of roles that the contact in the contact group has across appliances for e.g. Platform Customer, Nexus customer etc.", Name="ContactRoles")
        public ArrayList<RoleModel> ContactRoles = null;
        
        public UUID getContactGroupId() { return ContactGroupId; }
        public ContactGroupConnectionModel setContactGroupId(UUID value) { this.ContactGroupId = value; return this; }
        public UUID getContactGroupConnectionId() { return ContactGroupConnectionId; }
        public ContactGroupConnectionModel setContactGroupConnectionId(UUID value) { this.ContactGroupConnectionId = value; return this; }
        public UUID getConnectionRoleId() { return ConnectionRoleId; }
        public ContactGroupConnectionModel setConnectionRoleId(UUID value) { this.ConnectionRoleId = value; return this; }
        public Integer getIndex() { return Index; }
        public ContactGroupConnectionModel setIndex(Integer value) { this.Index = value; return this; }
        public ArrayList<RoleModel> getContactRoles() { return ContactRoles; }
        public ContactGroupConnectionModel setContactRoles(ArrayList<RoleModel> value) { this.ContactRoles = value; return this; }
    }

    public static class UserProfileSummaryModel
    {
        /**
        * User Profile Id
        */
        @ApiMember(DataType="Guid", Description="User Profile Id", Name="UserProfileId")
        public UUID UserProfileId = null;

        /**
        * User linked to the profile
        */
        @ApiMember(DataType="Guid", Description="User linked to the profile", Name="UserId")
        public UUID UserId = null;

        /**
        * Contact linked to the profile
        */
        @ApiMember(DataType="Guid", Description="Contact linked to the profile", Name="ContactId")
        public UUID ContactId = null;

        /**
        * User linked to the profile
        */
        @ApiMember(DataType="string", Description="User linked to the profile", Name="UserName")
        public String UserName = null;

        /**
        * User Profile Name
        */
        @ApiMember(DataType="string", Description="User Profile Name", Name="ProfileName")
        public String ProfileName = null;

        /**
        * Full name of the contact linked to the profile
        */
        @ApiMember(DataType="string", Description="Full name of the contact linked to the profile", Name="ContactFullName")
        public String ContactFullName = null;

        /**
        * Email Address of the contact linked to the profile
        */
        @ApiMember(DataType="string", Description="Email Address of the contact linked to the profile", Name="EmailAddress")
        public String EmailAddress = null;

        /**
        * Email signature of the contact linked to the profile
        */
        @ApiMember(DataType="string", Description="Email signature of the contact linked to the profile", Name="EmailSignature")
        public String EmailSignature = null;

        /**
        * Mobile number of the contact linked to the profile
        */
        @ApiMember(DataType="string", Description="Mobile number of the contact linked to the profile", Name="MobileNumber")
        public String MobileNumber = null;

        /**
        * Phone number of the contact linked to the profile
        */
        @ApiMember(DataType="string", Description="Phone number of the contact linked to the profile", Name="PhoneNumber")
        public String PhoneNumber = null;

        /**
        * Type of contact (person, organisation etc.) linked to the profile
        */
        @ApiMember(DataType="string", Description="Type of contact (person, organisation etc.) linked to the profile", Name="ContactTypeId")
        public UUID ContactTypeId = null;

        /**
        * Type of contact (person, organisation etc.) linked to the profile
        */
        @ApiMember(DataType="string", Description="Type of contact (person, organisation etc.) linked to the profile", Name="ContactTypeName")
        public String ContactTypeName = null;

        /**
        * First name of the contact linked to the profile
        */
        @ApiMember(DataType="string", Description="First name of the contact linked to the profile", Name="FirstName")
        public String FirstName = null;

        /**
        * Surname of the contact linked to the profile
        */
        @ApiMember(DataType="string", Description="Surname of the contact linked to the profile", Name="Surname")
        public String Surname = null;

        /**
        * Title of contact linked to the profile
        */
        @ApiMember(DataType="string", Description="Title of contact linked to the profile", Name="Title")
        public String Title = null;

        /**
        * Legal name of contact linked to the profile
        */
        @ApiMember(DataType="string", Description="Legal name of contact linked to the profile", Name="LegalName")
        public String LegalName = null;

        /**
        * Trading name of contact linked to the profile
        */
        @ApiMember(DataType="string", Description="Trading name of contact linked to the profile", Name="TradingName")
        public String TradingName = null;

        /**
        * Australian Business Number
        */
        @ApiMember(DataType="string", Description="Australian Business Number", Name="Abn", ParameterType="query")
        public String Abn = null;

        /**
        * Australian Company Number
        */
        @ApiMember(DataType="string", Description="Australian Company Number", Name="Acn", ParameterType="query")
        public String Acn = null;

        /**
        * Australian Registered Body Number
        */
        @ApiMember(DataType="string", Description="Australian Registered Body Number", Name="Arbn", ParameterType="query")
        public String Arbn = null;

        /**
        * Indicates if the Contact is registered for GST.
        */
        @ApiMember(DataType="bool", Description="Indicates if the Contact is registered for GST.", Name="GstRegistered", ParameterType="query")
        public Boolean GstRegistered = null;

        /**
        * True if english is a secondary language for the contact.
        */
        @ApiMember(DataType="bool", Description="True if english is a secondary language for the contact.", Name="ESL", ParameterType="query")
        public Boolean ESL = null;

        /**
        * Language that is the primary language for the contact.
        */
        @ApiMember(DataType="string", Description="Language that is the primary language for the contact.", Name="Language", ParameterType="query")
        public String Language = null;

        /**
        * True if an interpreter is required.
        */
        @ApiMember(DataType="bool", Description="True if an interpreter is required.", Name="InterpreterRequired", ParameterType="query")
        public Boolean InterpreterRequired = null;

        /**
        * Licensee specific notes about the contact.
        */
        @ApiMember(DataType="string", Description="Licensee specific notes about the contact.", Name="LicenseeNotes", ParameterType="query")
        public String LicenseeNotes = null;

        /**
        * Profile photo of contact linked to the profile
        */
        @ApiMember(DataType="string", Description="Profile photo of contact linked to the profile", Name="ProfilePhotoUrl")
        public String ProfilePhotoUrl = null;

        /**
        * Thumbnail photo of contact linked to the profile
        */
        @ApiMember(DataType="string", Description="Thumbnail photo of contact linked to the profile", Name="ProfilePhotoThumbnailUrl")
        public String ProfilePhotoThumbnailUrl = null;

        /**
        * Profile photo id of contact linked to the profile
        */
        @ApiMember(DataType="Guid", Description="Profile photo id of contact linked to the profile", Name="ProfileImageId")
        public UUID ProfileImageId = null;

        /**
        * Profile description
        */
        @ApiMember(DataType="string", Description="Profile description", Name="Description")
        public String Description = null;

        /**
        * Employment Industry
        */
        @ApiMember(DataType="string", Description="Employment Industry", Name="EmploymentIndustry")
        public String EmploymentIndustry = null;

        /**
        * Employment Role
        */
        @ApiMember(DataType="string", Description="Employment Role", Name="EmploymentRole")
        public String EmploymentRole = null;

        /**
        * Areas of Work
        */
        @ApiMember(DataType="string", Description="Areas of Work", Name="EmploymentGeographicArea")
        public String EmploymentGeographicArea = null;

        /**
        * The contacts timezone.
        */
        @ApiMember(DataType="Guid", Description="The contacts timezone.", Name="Timezone", ParameterType="query")
        public UUID Timezone = null;

        /**
        * Timezone Name
        */
        @ApiMember(DataType="string", Description="Timezone Name", Name="TimezoneName", ParameterType="query")
        public String TimezoneName = null;

        /**
        * The primary address of the contact
        */
        @ApiMember(DataType="string", Description="The primary address of the contact", Name="PrimaryAddress", ParameterType="query")
        public String PrimaryAddress = null;

        /**
        * Is this an active contact? Or an inactive contact (deleted account)?
        */
        @ApiMember(DataType="bool", Description="Is this an active contact? Or an inactive contact (deleted account)?", Name="IsActiveContact")
        public Boolean IsActiveContact = null;
        
        public UUID getUserProfileId() { return UserProfileId; }
        public UserProfileSummaryModel setUserProfileId(UUID value) { this.UserProfileId = value; return this; }
        public UUID getUserId() { return UserId; }
        public UserProfileSummaryModel setUserId(UUID value) { this.UserId = value; return this; }
        public UUID getContactId() { return ContactId; }
        public UserProfileSummaryModel setContactId(UUID value) { this.ContactId = value; return this; }
        public String getUserName() { return UserName; }
        public UserProfileSummaryModel setUserName(String value) { this.UserName = value; return this; }
        public String getProfileName() { return ProfileName; }
        public UserProfileSummaryModel setProfileName(String value) { this.ProfileName = value; return this; }
        public String getContactFullName() { return ContactFullName; }
        public UserProfileSummaryModel setContactFullName(String value) { this.ContactFullName = value; return this; }
        public String getEmailAddress() { return EmailAddress; }
        public UserProfileSummaryModel setEmailAddress(String value) { this.EmailAddress = value; return this; }
        public String getEmailSignature() { return EmailSignature; }
        public UserProfileSummaryModel setEmailSignature(String value) { this.EmailSignature = value; return this; }
        public String getMobileNumber() { return MobileNumber; }
        public UserProfileSummaryModel setMobileNumber(String value) { this.MobileNumber = value; return this; }
        public String getPhoneNumber() { return PhoneNumber; }
        public UserProfileSummaryModel setPhoneNumber(String value) { this.PhoneNumber = value; return this; }
        public UUID getContactTypeId() { return ContactTypeId; }
        public UserProfileSummaryModel setContactTypeId(UUID value) { this.ContactTypeId = value; return this; }
        public String getContactTypeName() { return ContactTypeName; }
        public UserProfileSummaryModel setContactTypeName(String value) { this.ContactTypeName = value; return this; }
        public String getFirstName() { return FirstName; }
        public UserProfileSummaryModel setFirstName(String value) { this.FirstName = value; return this; }
        public String getSurname() { return Surname; }
        public UserProfileSummaryModel setSurname(String value) { this.Surname = value; return this; }
        public String getTitle() { return Title; }
        public UserProfileSummaryModel setTitle(String value) { this.Title = value; return this; }
        public String getLegalName() { return LegalName; }
        public UserProfileSummaryModel setLegalName(String value) { this.LegalName = value; return this; }
        public String getTradingName() { return TradingName; }
        public UserProfileSummaryModel setTradingName(String value) { this.TradingName = value; return this; }
        public String getAbn() { return Abn; }
        public UserProfileSummaryModel setAbn(String value) { this.Abn = value; return this; }
        public String getAcn() { return Acn; }
        public UserProfileSummaryModel setAcn(String value) { this.Acn = value; return this; }
        public String getArbn() { return Arbn; }
        public UserProfileSummaryModel setArbn(String value) { this.Arbn = value; return this; }
        public Boolean isGstRegistered() { return GstRegistered; }
        public UserProfileSummaryModel setGstRegistered(Boolean value) { this.GstRegistered = value; return this; }
        public Boolean isEsl() { return ESL; }
        public UserProfileSummaryModel setEsl(Boolean value) { this.ESL = value; return this; }
        public String getLanguage() { return Language; }
        public UserProfileSummaryModel setLanguage(String value) { this.Language = value; return this; }
        public Boolean isInterpreterRequired() { return InterpreterRequired; }
        public UserProfileSummaryModel setInterpreterRequired(Boolean value) { this.InterpreterRequired = value; return this; }
        public String getLicenseeNotes() { return LicenseeNotes; }
        public UserProfileSummaryModel setLicenseeNotes(String value) { this.LicenseeNotes = value; return this; }
        public String getProfilePhotoUrl() { return ProfilePhotoUrl; }
        public UserProfileSummaryModel setProfilePhotoUrl(String value) { this.ProfilePhotoUrl = value; return this; }
        public String getProfilePhotoThumbnailUrl() { return ProfilePhotoThumbnailUrl; }
        public UserProfileSummaryModel setProfilePhotoThumbnailUrl(String value) { this.ProfilePhotoThumbnailUrl = value; return this; }
        public UUID getProfileImageId() { return ProfileImageId; }
        public UserProfileSummaryModel setProfileImageId(UUID value) { this.ProfileImageId = value; return this; }
        public String getDescription() { return Description; }
        public UserProfileSummaryModel setDescription(String value) { this.Description = value; return this; }
        public String getEmploymentIndustry() { return EmploymentIndustry; }
        public UserProfileSummaryModel setEmploymentIndustry(String value) { this.EmploymentIndustry = value; return this; }
        public String getEmploymentRole() { return EmploymentRole; }
        public UserProfileSummaryModel setEmploymentRole(String value) { this.EmploymentRole = value; return this; }
        public String getEmploymentGeographicArea() { return EmploymentGeographicArea; }
        public UserProfileSummaryModel setEmploymentGeographicArea(String value) { this.EmploymentGeographicArea = value; return this; }
        public UUID getTimezone() { return Timezone; }
        public UserProfileSummaryModel setTimezone(UUID value) { this.Timezone = value; return this; }
        public String getTimezoneName() { return TimezoneName; }
        public UserProfileSummaryModel setTimezoneName(String value) { this.TimezoneName = value; return this; }
        public String getPrimaryAddress() { return PrimaryAddress; }
        public UserProfileSummaryModel setPrimaryAddress(String value) { this.PrimaryAddress = value; return this; }
        public Boolean getIsActiveContact() { return IsActiveContact; }
        public UserProfileSummaryModel setIsActiveContact(Boolean value) { this.IsActiveContact = value; return this; }
    }

    public static class RoleModel
    {
        /**
        * Role Id
        */
        @ApiMember(DataType="Guid", Description="Role Id", IsRequired=true, Name="RoleId")
        public UUID RoleId = null;

        /**
        * Role Name
        */
        @ApiMember(DataType="string", Description="Role Name", Name="RoleName")
        public String RoleName = null;

        /**
        * Is the role a licensee role?
        */
        @ApiMember(DataType="bool", Description="Is the role a licensee role?", Name="IsLicensee")
        public Boolean IsLicenseeRole = null;

        /**
        * Is manage contacts role?
        */
        @ApiMember(DataType="bool", Description="Is manage contacts role?", Name="IsManageContacts")
        public Boolean IsManageContacts = null;

        /**
        * Is the role a Platform role?
        */
        @ApiMember(DataType="bool", Description="Is the role a Platform role?", Name="IsPlatformRole")
        public Boolean IsPlatformRole = null;

        /**
        * Is the role a services role?
        */
        @ApiMember(DataType="bool", Description="Is the role a services role?", Name="IsServiceRole")
        public Boolean IsServiceRole = null;

        /**
        * Is the role a customer role?
        */
        @ApiMember(DataType="bool", Description="Is the role a customer role?", Name="IsCustomerRole")
        public Boolean IsCustomerRole = null;

        /**
        * Is the role a functional role?
        */
        @ApiMember(DataType="bool", Description="Is the role a functional role?", Name="IsFunctionalRole")
        public Boolean IsFunctionalRole = null;

        /**
        * Is the role an auto-accept role?
        */
        @ApiMember(DataType="bool", Description="Is the role an auto-accept role?", Name="IsRequestAutoAccepted")
        public Boolean IsRequestAutoAccepted = null;

        /**
        * Suite that the role belongs to
        */
        @ApiMember(DataType="Guid", Description="Suite that the role belongs to", Name="SuiteId")
        public UUID SuiteId = null;

        /**
        * Suite that the role belongs to
        */
        @ApiMember(DataType="string", Description="Suite that the role belongs to", Name="SuiteName")
        public String SuiteName = null;

        /**
        * 'A' (Active) or 'I' (Inactive)
        */
        @ApiMember(DataType="string", Description="'A' (Active) or 'I' (Inactive)", Name="RecordStatus")
        public String RecordStatus = null;

        /**
        * Object Connection Id, which is populated when the roles are returned based on those that are connected to an object.
        */
        @ApiMember(DataType="Guid", Description="Object Connection Id, which is populated when the roles are returned based on those that are connected to an object.", Name="ObjectConnectionId")
        public UUID ObjectConnectionId = null;
        
        public UUID getRoleId() { return RoleId; }
        public RoleModel setRoleId(UUID value) { this.RoleId = value; return this; }
        public String getRoleName() { return RoleName; }
        public RoleModel setRoleName(String value) { this.RoleName = value; return this; }
        public Boolean getIsLicenseeRole() { return IsLicenseeRole; }
        public RoleModel setIsLicenseeRole(Boolean value) { this.IsLicenseeRole = value; return this; }
        public Boolean getIsManageContacts() { return IsManageContacts; }
        public RoleModel setIsManageContacts(Boolean value) { this.IsManageContacts = value; return this; }
        public Boolean getIsPlatformRole() { return IsPlatformRole; }
        public RoleModel setIsPlatformRole(Boolean value) { this.IsPlatformRole = value; return this; }
        public Boolean getIsServiceRole() { return IsServiceRole; }
        public RoleModel setIsServiceRole(Boolean value) { this.IsServiceRole = value; return this; }
        public Boolean getIsCustomerRole() { return IsCustomerRole; }
        public RoleModel setIsCustomerRole(Boolean value) { this.IsCustomerRole = value; return this; }
        public Boolean getIsFunctionalRole() { return IsFunctionalRole; }
        public RoleModel setIsFunctionalRole(Boolean value) { this.IsFunctionalRole = value; return this; }
        public Boolean getIsRequestAutoAccepted() { return IsRequestAutoAccepted; }
        public RoleModel setIsRequestAutoAccepted(Boolean value) { this.IsRequestAutoAccepted = value; return this; }
        public UUID getSuiteId() { return SuiteId; }
        public RoleModel setSuiteId(UUID value) { this.SuiteId = value; return this; }
        public String getSuiteName() { return SuiteName; }
        public RoleModel setSuiteName(String value) { this.SuiteName = value; return this; }
        public String getRecordStatus() { return RecordStatus; }
        public RoleModel setRecordStatus(String value) { this.RecordStatus = value; return this; }
        public UUID getObjectConnectionId() { return ObjectConnectionId; }
        public RoleModel setObjectConnectionId(UUID value) { this.ObjectConnectionId = value; return this; }
    }

    @ApiResponse(Description="Create contact group")
    public static class UpdateContactGroupResponse
    {
        public Boolean Status = null;
        public ResponseStatus ResponseStatus = null;
        
        public Boolean isStatus() { return Status; }
        public UpdateContactGroupResponse setStatus(Boolean value) { this.Status = value; return this; }
        public ResponseStatus getResponseStatus() { return ResponseStatus; }
        public UpdateContactGroupResponse setResponseStatus(ResponseStatus value) { this.ResponseStatus = value; return this; }
    }

}

Java UpdateContactGroup DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

PUT /api/contactgroups/{ContactGroupId} HTTP/1.1 
Host: pfapi.pstpf.com.au 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	CustomerName: String,
	Contacts: 
	[
		{
			Index: 0,
			ContactRoles: 
			[
				{
					RoleName: String,
					IsLicenseeRole: False,
					IsManageContacts: False,
					IsPlatformRole: False,
					IsServiceRole: False,
					IsCustomerRole: False,
					IsFunctionalRole: False,
					IsRequestAutoAccepted: False,
					SuiteName: String,
					RecordStatus: String
				}
			],
			UserName: String,
			ProfileName: String,
			ContactFullName: String,
			EmailAddress: String,
			EmailSignature: String,
			MobileNumber: String,
			PhoneNumber: String,
			ContactTypeName: String,
			FirstName: String,
			Surname: String,
			Title: String,
			LegalName: String,
			TradingName: String,
			Abn: String,
			Acn: String,
			Arbn: String,
			GstRegistered: False,
			ESL: False,
			Language: String,
			InterpreterRequired: False,
			LicenseeNotes: String,
			ProfilePhotoUrl: String,
			ProfilePhotoThumbnailUrl: String,
			Description: String,
			EmploymentIndustry: String,
			EmploymentRole: String,
			EmploymentGeographicArea: String,
			TimezoneName: String,
			PrimaryAddress: String,
			IsActiveContact: False
		}
	],
	RecordStatus: String
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	Status: False,
	ResponseStatus: 
	{
		ErrorCode: String,
		Message: String,
		StackTrace: String,
		Errors: 
		[
			{
				ErrorCode: String,
				FieldName: String,
				Message: String,
				Meta: 
				{
					String: String
				}
			}
		],
		Meta: 
		{
			String: String
		}
	}
}