YM REST Services

<back to all web services

ContentAreas

Requires Authentication
Requires any of the roles:admin, oauthadmin
The following routes are available for this service:
GET/Ams/{ClientID}/ContentAreasReturn a content area.
PUT/Ams/{ClientID}/ContentAreasUpdate a content area.
ContentAreas Parameters:
NameParameterData TypeRequiredDescription
AreaTypebodystringNo
VersionIDbodyint?No
RevertbodyboolNo
VersionLabelbodystringNo
VersionNotesbodystringNo
PublishbodyboolNo
ContentAreabodyContentAreaNo
MemberBaseSharedDto Parameters:
NameParameterData TypeRequiredDescription
MemberIDformintNo
BaseSharedDto Parameters:
NameParameterData TypeRequiredDescription
ClientIDformintNo
ResponseStatusformResponseStatusNo
BypassCacheformboolNo
DateCachedformDateTimeNo
DeviceformDeviceNo
ContentArea Parameters:
NameParameterData TypeRequiredDescription
TitleDefaultformstringNo
TitleformstringNo
BodyformstringNo
AutoFormattedformintNo
AllowSponsorRotatorWidgetformboolNo
ContentTypeformintNo
RotatorIdformint?No
AreaStatusformintNo
VersionIDformint?No
ModifiedAtformDateTime?No
ModifiedByLastNameformstringNo
ModifiedByFirstNameformstringNo
MessageTypeformstringNo
MessageLocationformstringNo
MessageTypeIDformstringNo

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 /Ams/{ClientID}/ContentAreas HTTP/1.1 
Host: ws.yourmembership.com 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	AreaType: String,
	VersionID: 0,
	Revert: False,
	VersionLabel: String,
	VersionNotes: String,
	Publish: False,
	ContentArea: 
	{
		TitleDefault: String,
		Title: String,
		Body: String,
		AutoFormatted: 0,
		AllowSponsorRotatorWidget: False,
		ContentType: 0,
		RotatorId: 0,
		AreaStatus: 0,
		VersionID: 0,
		ModifiedAt: 0001-01-01,
		ModifiedByLastName: String,
		ModifiedByFirstName: String,
		MessageType: String,
		MessageLocation: String,
		MessageTypeID: String
	},
	MemberID: 0,
	ClientID: 0,
	ResponseStatus: 
	{
		ErrorCode: String,
		Message: String,
		StackTrace: String,
		Errors: 
		[
			{
				ErrorCode: String,
				FieldName: String,
				Message: String,
				Meta: 
				{
					String: String
				}
			}
		],
		Meta: 
		{
			String: String
		}
	},
	BypassCache: False,
	DateCached: 2024-05-03T07:52:02.1829608-04:00,
	Device: Desktop
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	AreaType: String,
	VersionID: 0,
	Revert: False,
	VersionLabel: String,
	VersionNotes: String,
	Publish: False,
	ContentArea: 
	{
		TitleDefault: String,
		Title: String,
		Body: String,
		AutoFormatted: 0,
		AllowSponsorRotatorWidget: False,
		ContentType: 0,
		RotatorId: 0,
		AreaStatus: 0,
		VersionID: 0,
		ModifiedAt: 0001-01-01,
		ModifiedByLastName: String,
		ModifiedByFirstName: String,
		MessageType: String,
		MessageLocation: String,
		MessageTypeID: String
	},
	MemberID: 0,
	ClientID: 0,
	ResponseStatus: 
	{
		ErrorCode: String,
		Message: String,
		StackTrace: String,
		Errors: 
		[
			{
				ErrorCode: String,
				FieldName: String,
				Message: String,
				Meta: 
				{
					String: String
				}
			}
		],
		Meta: 
		{
			String: String
		}
	},
	BypassCache: False,
	DateCached: 2024-05-03T07:52:02.1907801-04:00,
	Device: Desktop
}