RHP_API

<back to all web services

PatchClientMessengerSettings

Update the user client messenger settings.

Requires Authentication
The following routes are available for this service:
PATCH/User/Account/Settings/Messenger
PatchClientMessengerSettings Parameters:
NameParameterData TypeRequiredDescription
PermissionMessageReceivequeryMessageReceivePermission?No
PermissionVideoCallqueryMessageReceivePermission?No
DefaultFolderqueryMessageFolders?No
DefaultImageDurationqueryMessageImageDurationNo
CanReceivePhotosquerybool?No
CanReceiveGiftsquerybool?No
ThemequeryMessengerThemeNo
MessengerTheme Parameters:
NameParameterData TypeRequiredDescription
DarkModeformboolNoDEPRECATED. Replaced with DarkModeSetting
DarkModeSettingformToggleWithDefaultNo
ThemeTypeformMessengerThemeTypeNo
FontSizeformMessengerFontSizeNo
MessengerSettings Parameters:
NameParameterData TypeRequiredDescription
PermissionMessageReceiveformMessageReceivePermissionNoDetermines if a user can receive a message.
PermissionVideoCallformMessageReceivePermissionNoDetermines if a user can receive a video call.
ReplyLimitDaysformintNoThe number of days that a user can reply after the last received message in a conversation, if less than one is returned there is no limit.
DefaultFolderformMessageFoldersNo
OperationMethodformstringNo
DefaultImageDurationformMessageImageDurationNoDefault image shared duration.
CanReceivePhotosformboolNo
CanReceiveGiftsformboolNo
IsActiveformbool?NoIf true the client should display the 'Service Unavailable' popup.
ThemeformMessengerThemeNo

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.

PATCH /User/Account/Settings/Messenger HTTP/1.1 
Host: tstsrvs.redhotpie.com.au 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	PermissionMessageReceive: Anyone,
	PermissionVideoCall: Anyone,
	DefaultFolder: All,
	DefaultImageDuration: None,
	CanReceivePhotos: False,
	CanReceiveGifts: False,
	Theme: 
	{
		DarkMode: False,
		DarkModeSetting: Default,
		ThemeType: Green,
		FontSize: Small
	}
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	PermissionMessageReceive: Anyone,
	PermissionVideoCall: Anyone,
	ReplyLimitDays: 0,
	DefaultFolder: All,
	OperationMethod: String,
	DefaultImageDuration: None,
	CanReceivePhotos: False,
	CanReceiveGifts: False,
	IsActive: False,
	Theme: 
	{
		DarkMode: False,
		DarkModeSetting: Default,
		ThemeType: Green,
		FontSize: Small
	}
}