Create Achievement REST Endpoint

Ben Tiedt — Fri, 08 Mar 2024 17:43:36 GMT

Current Revision posted to API Documentation by Ben Tiedt on 03/08/2024 17:43:36

POST api.ashx/v2/achievement.{json|xml}

Request Parameters

Name	Type	Location	Description	Required
AutomationConfiguration	string	Request Body	Querystring encoded configuration values used by the selected automation for this achievement.	Optional
AutomationId	Guid	Request Body	Identifies the ID of the automation used to automatically award/revoke this achievement.	Optional
BadgeIconData	Byte[]	Request Body	Data of the file representing the badge for the Achievement. Either BadgeIconData or BadgeIconUploadContext is required. OBSOLETE in 12: Use BadgeIconUploadContext instead.	Optional
BadgeIconName	string	Request Body	Name of the file representing the badge for the Achievement	Required
BadgeIconUploadContext	string	Request Body	Upload context of the file representing the badge for the Achievement. Either BadgeIconData or BadgeIconUploadContext is required.	Optional
Criteria	string	Request Body	Criteria to earn the Achievement	Required
Enabled	bool	Request Body	Enabled state of the achievement, whether it can be earned.	Optional
Id	Guid	Request Body	Id of the Achievement	Optional
Title	string	Request Body	Title of the Achievement	Required

Example Requests

Widget Javascript

jQuery.telligent.evolution.post({
	url: jQuery.telligent.evolution.site.getBaseUrl() + 'api.ashx/v2/achievement.json',
	data: { 
		'BadgeIconName': 'badgeiconname',
		'Criteria': 'criteria',
		'Title': 'title'
	}
}).then(function(response) {
	// use response
});

Example Responses

JSON

{
  "Achievement": {
    "Id": "49fec544-6df7-4a82-872b-f8be586d5e9e",
    "Title": "title",
    "Criteria": "criteria",
    "BadgeIconUrl": "badgeiconurl",
    "Enabled": true,
    "CreatedDate": "2012-01-04T00:00:00",
    "AutomationId": "9f5a6721-639d-4e1d-ab6a-ce63b7750f46",
    "AutomationConfiguration": {},
    "ContentId": "49fec544-6df7-4a82-872b-f8be586d5e9e",
    "Url": "/achievements/49fec544-6df7-4a82-872b-f8be586d5e9e",
    "Application": {
      "Id": 1,
      "DateCreated": "2018-10-22T23:11:22.61",
      "Description": "",
      "Key": "root",
      "Name": "Community 12.1",
      "ParentGroupId": -1,
      "Url": "http://thirteen.community.local.telligent.com/",
      "GroupType": "Joinless",
      "EnableGroupMessages": true,
      "EnableContact": false,
      "TotalMembers": 0,
      "HasGroups": true,
      "PendingMembers": 0,
      "AvatarUrl": "http://thirteen.community.local.telligent.com/cfs-file/__key/system/images/defaulthub.gif",
      "GroupCount": 5,
      "ThemeId": "3fc3f824-83d1-4ec4-85ef-92e206116d49",
      "ApplicationId": "39ded655-26b5-48ab-b2ed-d7fde09d35b2",
      "ContainerId": "39ded655-26b5-48ab-b2ed-d7fde09d35b2",
      "ExtendedAttributes": [],
      "Warnings": [],
      "Errors": []
    },
    "Warnings": [],
    "Errors": []
  },
  "Errors": [
    "string",
    "string"
  ]
}

XML

<?xml version="1.0" encoding="utf-16"?>
<Response>
  <Achievement>
    <Id>49fec544-6df7-4a82-872b-f8be586d5e9e</Id>
    <Title>title</Title>
    <Criteria>criteria</Criteria>
    <BadgeIconUrl>badgeiconurl</BadgeIconUrl>
    <Enabled>true</Enabled>
    <CreatedDate>2012-01-04T00:00:00</CreatedDate>
    <AutomationId>9f5a6721-639d-4e1d-ab6a-ce63b7750f46</AutomationId>
  </Achievement>
  <Errors>
    <Message>string</Message>
    <Message>string</Message>
  </Errors>
</Response>