POST api/v2/pointtransactions.{json|xml}
Scopes
Points › Modify Point Transactions points.transactions.modify
Request Parameters
| Name | Type | Location | Description | Required | Default | Options |
|---|---|---|---|---|---|---|
| ContentId | Guid | Request Body | Identifier of content related to this point transaction | Required | ||
| ContentTypeId | Guid | Request Body | Content Type identifier of content related to this point transaction | Required | ||
| CreatedDate | DateTime | Request Body | Date and time the point transaction was created. The current time will be used if not specified. | Optional | ||
| Description | string | Request Body | Short explanation of why points are being awarded | Required | ||
| UserId | int | Request Body | Which user points are being awarded to | Required | ||
| Value | int | Request Body | Amount of points being awarded (or removed if this number is negative) | Required |
Example Requests
Widget Javascript
jQuery.telligent.evolution.post({
url: jQuery.telligent.evolution.site.getBaseUrl() + 'api/v2/pointtransactions.json',
data: {
'ContentId': '49fec544-6df7-4a82-872b-f8be586d5e9e',
'ContentTypeId': '49fec544-6df7-4a82-872b-f8be586d5e9e',
'Description': 'description',
'UserId': '6',
'Value': '6'
}
}).then(function(response) {
// use response
});Example Responses
JSON
{
"PointTransaction": {"Description":"description","CreatedDate":"2012-01-04T00:00:00","Value":6,"TypeId":"49fec544-6df7-4a82-872b-f8be586d5e9e","User":{"AvatarUrl":"avatarurl","DisplayName":"displayname","ProfileUrl":"profileurl","Username":"username","CurrentStatus":{"Author":{"AvatarUrl":"avatarurl","DisplayName":"displayname","ProfileUrl":"profileurl","Username":"username","CurrentStatus":{"Author":{"AvatarUrl":"avatarurl","DisplayName":"displayname","ProfileUrl":"profileurl","Username":"username","CurrentStatus":null,"Id":null},"Body":"body","CreatedDate":"2012-05-02T00:00:00","ReplyCount":25,"Group":{"AvatarUrl":"avatarurl","DateCreated":null,"Description":"description","Key":"key","Name":"name","ParentGroupId":null,"Url":"url","TotalMembers":null,"HasGroups":true,"GroupCount":null,"GroupType":"grouptype","EnableGroupMessages":true,"EnableContact":true,"SearchUniqueId":"searchuniqueid","IsEnabled":true,"ExtendedAttributes":[],"ContainerId":"9f5a6721-639d-4e1d-ab6a-ce63b7750f46","ContainerTypeId":"23b05a61-c3e5-4451-90d9-bfa00453bce4","Container":null,"Id":null},"AttachedUrl":"attachedurl","HasReplies":true,"Replies":[],"ContentId":"e3715662-2528-4ba1-84a7-bfcd9d548f80","ContentType":"56f1a3ec-14bb-45c6-949f-ee7776d68c78","Url":"url","IsPublished":true,"Content":{"CreatedByUser":null,"ContentId":"bd519379-b61f-4e2f-b0f9-c0f28c5cceb1","ContentTypeId":"9ba1ec43-dc34-4e27-a579-4a0855144e2f","CreatedDate":"2012-06-04T00:00:00","HtmlName":"htmlname","HtmlDescription":"htmldescription","Url":"url","AvatarUrl":"avatarurl","Application":null},"Id":"e3715662-2528-4ba1-84a7-bfcd9d548f80"},"Id":8},"Body":"body","CreatedDate":"2011-05-28T00:00:00","ReplyCount":4,"Group":{"AvatarUrl":"avatarurl","DateCreated":"2011-12-09T00:00:00","Description":"description","Key":"key","Name":"name","ParentGroupId":7,"Url":"url","TotalMembers":27,"HasGroups":true,"GroupCount":32,"GroupType":"grouptype","EnableGroupMessages":true,"EnableContact":true,"SearchUniqueId":"searchuniqueid","IsEnabled":true,"ExtendedAttributes":[{"Key":"key","Value":"value"},{"Key":"key","Value":"value"}],"ContainerId":"6cdcf200-3bad-476d-af45-97b52545c337","ContainerTypeId":"23b05a61-c3e5-4451-90d9-bfa00453bce4","Container":{"ContainerId":"b04540ec-eb38-4fa1-b7bb-e3fde05401b4","ContainerTypeId":"44df201a-07e6-42eb-96c7-8ce7ce35aab6","HtmlName":"htmlname","Url":"url","AvatarUrl":"avatarurl"},"Id":52},"AttachedUrl":"attachedurl","HasReplies":true,"Replies":[],"ContentId":"49fec544-6df7-4a82-872b-f8be586d5e9e","ContentType":"56f1a3ec-14bb-45c6-949f-ee7776d68c78","Url":"url","IsPublished":true,"Content":{"CreatedByUser":{"AvatarUrl":"avatarurl","DisplayName":"displayname","ProfileUrl":"profileurl","Username":"username","CurrentStatus":{"Author":null,"Body":"body","CreatedDate":null,"ReplyCount":19,"Group":null,"AttachedUrl":"attachedurl","HasReplies":null,"Replies":[],"ContentId":"fe65240b-044c-4292-9946-f10e0361ecff","ContentType":"56f1a3ec-14bb-45c6-949f-ee7776d68c78","Url":"url","IsPublished":true,"Content":null,"Id":"fe65240b-044c-4292-9946-f10e0361ecff"},"Id":112},"ContentId":"bd519379-b61f-4e2f-b0f9-c0f28c5cceb1","ContentTypeId":"9ba1ec43-dc34-4e27-a579-4a0855144e2f","CreatedDate":"2012-03-29T00:00:00","HtmlName":"htmlname","HtmlDescription":"htmldescription","Url":"url","AvatarUrl":"avatarurl","Application":{"ApplicationId":"e3715662-2528-4ba1-84a7-bfcd9d548f80","ApplicationTypeId":"6cdcf200-3bad-476d-af45-97b52545c337","HtmlName":"htmlname","HtmlDescription":"htmldescription","Url":"url","AvatarUrl":"avatarurl","Container":{"ContainerId":"b04540ec-eb38-4fa1-b7bb-e3fde05401b4","ContainerTypeId":"44df201a-07e6-42eb-96c7-8ce7ce35aab6","HtmlName":"htmlname","Url":"url","AvatarUrl":"avatarurl"}}},"Id":"49fec544-6df7-4a82-872b-f8be586d5e9e"},"Id":61},"Content":{"CreatedByUser":{"AvatarUrl":"avatarurl","DisplayName":"displayname","ProfileUrl":"profileurl","Username":"username","CurrentStatus":{"Author":{"AvatarUrl":"avatarurl","DisplayName":"displayname","ProfileUrl":"profileurl","Username":"username","CurrentStatus":{"Author":null,"Body":"body","CreatedDate":null,"ReplyCount":18,"Group":null,"AttachedUrl":"attachedurl","HasReplies":null,"Replies":[],"ContentId":"9f5a6721-639d-4e1d-ab6a-ce63b7750f46","ContentType":"56f1a3ec-14bb-45c6-949f-ee7776d68c78","Url":"url","IsPublished":true,"Content":null,"Id":"9f5a6721-639d-4e1d-ab6a-ce63b7750f46"},"Id":76},"Body":"body","CreatedDate":"2012-04-19T00:00:00","ReplyCount":6,"Group":{"AvatarUrl":"avatarurl","DateCreated":"2012-01-16T00:00:00","Description":"description","Key":"key","Name":"name","ParentGroupId":25,"Url":"url","TotalMembers":8,"HasGroups":true,"GroupCount":4,"GroupType":"grouptype","EnableGroupMessages":true,"EnableContact":true,"SearchUniqueId":"searchuniqueid","IsEnabled":true,"ExtendedAttributes":[],"ContainerId":"2d525bad-c4df-470d-a193-a1c6d66e5c3e","ContainerTypeId":"23b05a61-c3e5-4451-90d9-bfa00453bce4","Container":{"ContainerId":"bd519379-b61f-4e2f-b0f9-c0f28c5cceb1","ContainerTypeId":"9ba1ec43-dc34-4e27-a579-4a0855144e2f","HtmlName":"htmlname","Url":"url","AvatarUrl":"avatarurl"},"Id":7},"AttachedUrl":"attachedurl","HasReplies":true,"Replies":[],"ContentId":"fe65240b-044c-4292-9946-f10e0361ecff","ContentType":"56f1a3ec-14bb-45c6-949f-ee7776d68c78","Url":"url","IsPublished":true,"Content":{"CreatedByUser":{"AvatarUrl":"avatarurl","DisplayName":"displayname","ProfileUrl":"profileurl","Username":"username","CurrentStatus":null,"Id":null},"ContentId":"b04540ec-eb38-4fa1-b7bb-e3fde05401b4","ContentTypeId":"44df201a-07e6-42eb-96c7-8ce7ce35aab6","CreatedDate":"2012-01-04T00:00:00","HtmlName":"htmlname","HtmlDescription":"htmldescription","Url":"url","AvatarUrl":"avatarurl","Application":{"ApplicationId":"49fec544-6df7-4a82-872b-f8be586d5e9e","ApplicationTypeId":"9f5a6721-639d-4e1d-ab6a-ce63b7750f46","HtmlName":"htmlname","HtmlDescription":"htmldescription","Url":"url","AvatarUrl":"avatarurl","Container":null}},"Id":"fe65240b-044c-4292-9946-f10e0361ecff"},"Id":27},"ContentId":"2d525bad-c4df-470d-a193-a1c6d66e5c3e","ContentTypeId":"bd519379-b61f-4e2f-b0f9-c0f28c5cceb1","CreatedDate":"2012-05-02T00:00:00","HtmlName":"htmlname","HtmlDescription":"htmldescription","Url":"url","AvatarUrl":"avatarurl","Application":{"ApplicationId":"9ba1ec43-dc34-4e27-a579-4a0855144e2f","ApplicationTypeId":"e3715662-2528-4ba1-84a7-bfcd9d548f80","HtmlName":"htmlname","HtmlDescription":"htmldescription","Url":"url","AvatarUrl":"avatarurl","Container":{"ContainerId":"6cdcf200-3bad-476d-af45-97b52545c337","ContainerTypeId":"b04540ec-eb38-4fa1-b7bb-e3fde05401b4","HtmlName":"htmlname","Url":"url","AvatarUrl":"avatarurl"}}},"Id":0},
"Errors": ["string","string"]
}XML
<?xml version="1.0" encoding="utf-16"?>
<Response>
<PointTransaction>
<Id>0</Id>
<Description>description</Description>
<CreatedDate>2012-01-04T00:00:00</CreatedDate>
<Value>6</Value>
<TypeId>49fec544-6df7-4a82-872b-f8be586d5e9e</TypeId>
<User>
<Id>61</Id>
<AvatarUrl>avatarurl</AvatarUrl>
<DisplayName>displayname</DisplayName>
<ProfileUrl>profileurl</ProfileUrl>
<Username>username</Username>
<CurrentStatus>
<Id>49fec544-6df7-4a82-872b-f8be586d5e9e</Id>
<Author>
<Id>8</Id>
<AvatarUrl>avatarurl</AvatarUrl>
<DisplayName>displayname</DisplayName>
<ProfileUrl>profileurl</ProfileUrl>
<Username>username</Username>
<CurrentStatus>
<Id>e3715662-2528-4ba1-84a7-bfcd9d548f80</Id>
<Author>
<Id />
<AvatarUrl>avatarurl</AvatarUrl>
<DisplayName>displayname</DisplayName>
<ProfileUrl>profileurl</ProfileUrl>
<Username>username</Username>
</Author>
<Body>body</Body>
<CreatedDate>2012-05-02T00:00:00</CreatedDate>
<ReplyCount>25</ReplyCount>
<Group>
<Id />
<AvatarUrl>avatarurl</AvatarUrl>
<DateCreated />
<Description>description</Description>
<Key>key</Key>
<Name>name</Name>
<Url>url</Url>
<TotalMembers />
<HasGroups>true</HasGroups>
<GroupCount />
<GroupType>grouptype</GroupType>
<EnableGroupMessages>true</EnableGroupMessages>
<EnableContact>true</EnableContact>
<SearchUniqueId>searchuniqueid</SearchUniqueId>
<ExtendedAttributes />
<ContainerId>9f5a6721-639d-4e1d-ab6a-ce63b7750f46</ContainerId>
</Group>
<AttachedUrl>attachedurl</AttachedUrl>
<HasReplies>true</HasReplies>
<ContentId>e3715662-2528-4ba1-84a7-bfcd9d548f80</ContentId>
<ContentType>56f1a3ec-14bb-45c6-949f-ee7776d68c78</ContentType>
<Url>url</Url>
<IsPublished>true</IsPublished>
<Content>
<ContentId>bd519379-b61f-4e2f-b0f9-c0f28c5cceb1</ContentId>
<ContentTypeId>9ba1ec43-dc34-4e27-a579-4a0855144e2f</ContentTypeId>
<CreatedDate>2012-06-04T00:00:00</CreatedDate>
<HtmlName>htmlname</HtmlName>
<HtmlDescription>htmldescription</HtmlDescription>
<Url>url</Url>
<AvatarUrl>avatarurl</AvatarUrl>
</Content>
</CurrentStatus>
</Author>
<Body>body</Body>
<CreatedDate>2011-05-28T00:00:00</CreatedDate>
<ReplyCount>4</ReplyCount>
<Group>
<Id>52</Id>
<AvatarUrl>avatarurl</AvatarUrl>
<DateCreated>2011-12-09T00:00:00</DateCreated>
<Description>description</Description>
<Key>key</Key>
<Name>name</Name>
<ParentGroupId>7</ParentGroupId>
<Url>url</Url>
<TotalMembers>27</TotalMembers>
<HasGroups>true</HasGroups>
<GroupCount>32</GroupCount>
<GroupType>grouptype</GroupType>
<EnableGroupMessages>true</EnableGroupMessages>
<EnableContact>true</EnableContact>
<SearchUniqueId>searchuniqueid</SearchUniqueId>
<ExtendedAttributes>
<key>value</key>
<key>value</key>
</ExtendedAttributes>
<ContainerId>6cdcf200-3bad-476d-af45-97b52545c337</ContainerId>
<Container>
<ContainerId>b04540ec-eb38-4fa1-b7bb-e3fde05401b4</ContainerId>
<ContainerTypeId>44df201a-07e6-42eb-96c7-8ce7ce35aab6</ContainerTypeId>
<HtmlName>htmlname</HtmlName>
<Url>url</Url>
<AvatarUrl>avatarurl</AvatarUrl>
</Container>
</Group>
<AttachedUrl>attachedurl</AttachedUrl>
<HasReplies>true</HasReplies>
<ContentId>49fec544-6df7-4a82-872b-f8be586d5e9e</ContentId>
<ContentType>56f1a3ec-14bb-45c6-949f-ee7776d68c78</ContentType>
<Url>url</Url>
<IsPublished>true</IsPublished>
<Content>
<CreatedByUser>
<Id>112</Id>
<AvatarUrl>avatarurl</AvatarUrl>
<DisplayName>displayname</DisplayName>
<ProfileUrl>profileurl</ProfileUrl>
<Username>username</Username>
<CurrentStatus>
<Id>fe65240b-044c-4292-9946-f10e0361ecff</Id>
<Body>body</Body>
<CreatedDate />
<ReplyCount>19</ReplyCount>
<AttachedUrl>attachedurl</AttachedUrl>
<HasReplies />
<ContentId>fe65240b-044c-4292-9946-f10e0361ecff</ContentId>
<ContentType>56f1a3ec-14bb-45c6-949f-ee7776d68c78</ContentType>
<Url>url</Url>
<IsPublished>true</IsPublished>
</CurrentStatus>
</CreatedByUser>
<ContentId>bd519379-b61f-4e2f-b0f9-c0f28c5cceb1</ContentId>
<ContentTypeId>9ba1ec43-dc34-4e27-a579-4a0855144e2f</ContentTypeId>
<CreatedDate>2012-03-29T00:00:00</CreatedDate>
<HtmlName>htmlname</HtmlName>
<HtmlDescription>htmldescription</HtmlDescription>
<Url>url</Url>
<AvatarUrl>avatarurl</AvatarUrl>
<Application>
<ApplicationId>e3715662-2528-4ba1-84a7-bfcd9d548f80</ApplicationId>
<ApplicationTypeId>6cdcf200-3bad-476d-af45-97b52545c337</ApplicationTypeId>
<HtmlName>htmlname</HtmlName>
<HtmlDescription>htmldescription</HtmlDescription>
<Url>url</Url>
<AvatarUrl>avatarurl</AvatarUrl>
<Container>
<ContainerId>b04540ec-eb38-4fa1-b7bb-e3fde05401b4</ContainerId>
<ContainerTypeId>44df201a-07e6-42eb-96c7-8ce7ce35aab6</ContainerTypeId>
<HtmlName>htmlname</HtmlName>
<Url>url</Url>
<AvatarUrl>avatarurl</AvatarUrl>
</Container>
</Application>
</Content>
</CurrentStatus>
</User>
<Content>
<CreatedByUser>
<Id>27</Id>
<AvatarUrl>avatarurl</AvatarUrl>
<DisplayName>displayname</DisplayName>
<ProfileUrl>profileurl</ProfileUrl>
<Username>username</Username>
<CurrentStatus>
<Id>fe65240b-044c-4292-9946-f10e0361ecff</Id>
<Author>
<Id>76</Id>
<AvatarUrl>avatarurl</AvatarUrl>
<DisplayName>displayname</DisplayName>
<ProfileUrl>profileurl</ProfileUrl>
<Username>username</Username>
<CurrentStatus>
<Id>9f5a6721-639d-4e1d-ab6a-ce63b7750f46</Id>
<Body>body</Body>
<CreatedDate />
<ReplyCount>18</ReplyCount>
<AttachedUrl>attachedurl</AttachedUrl>
<HasReplies />
<ContentId>9f5a6721-639d-4e1d-ab6a-ce63b7750f46</ContentId>
<ContentType>56f1a3ec-14bb-45c6-949f-ee7776d68c78</ContentType>
<Url>url</Url>
<IsPublished>true</IsPublished>
</CurrentStatus>
</Author>
<Body>body</Body>
<CreatedDate>2012-04-19T00:00:00</CreatedDate>
<ReplyCount>6</ReplyCount>
<Group>
<Id>7</Id>
<AvatarUrl>avatarurl</AvatarUrl>
<DateCreated>2012-01-16T00:00:00</DateCreated>
<Description>description</Description>
<Key>key</Key>
<Name>name</Name>
<ParentGroupId>25</ParentGroupId>
<Url>url</Url>
<TotalMembers>8</TotalMembers>
<HasGroups>true</HasGroups>
<GroupCount>4</GroupCount>
<GroupType>grouptype</GroupType>
<EnableGroupMessages>true</EnableGroupMessages>
<EnableContact>true</EnableContact>
<SearchUniqueId>searchuniqueid</SearchUniqueId>
<ExtendedAttributes />
<ContainerId>2d525bad-c4df-470d-a193-a1c6d66e5c3e</ContainerId>
<Container>
<ContainerId>bd519379-b61f-4e2f-b0f9-c0f28c5cceb1</ContainerId>
<ContainerTypeId>9ba1ec43-dc34-4e27-a579-4a0855144e2f</ContainerTypeId>
<HtmlName>htmlname</HtmlName>
<Url>url</Url>
<AvatarUrl>avatarurl</AvatarUrl>
</Container>
</Group>
<AttachedUrl>attachedurl</AttachedUrl>
<HasReplies>true</HasReplies>
<ContentId>fe65240b-044c-4292-9946-f10e0361ecff</ContentId>
<ContentType>56f1a3ec-14bb-45c6-949f-ee7776d68c78</ContentType>
<Url>url</Url>
<IsPublished>true</IsPublished>
<Content>
<CreatedByUser>
<Id />
<AvatarUrl>avatarurl</AvatarUrl>
<DisplayName>displayname</DisplayName>
<ProfileUrl>profileurl</ProfileUrl>
<Username>username</Username>
</CreatedByUser>
<ContentId>b04540ec-eb38-4fa1-b7bb-e3fde05401b4</ContentId>
<ContentTypeId>44df201a-07e6-42eb-96c7-8ce7ce35aab6</ContentTypeId>
<CreatedDate>2012-01-04T00:00:00</CreatedDate>
<HtmlName>htmlname</HtmlName>
<HtmlDescription>htmldescription</HtmlDescription>
<Url>url</Url>
<AvatarUrl>avatarurl</AvatarUrl>
<Application>
<ApplicationId>49fec544-6df7-4a82-872b-f8be586d5e9e</ApplicationId>
<ApplicationTypeId>9f5a6721-639d-4e1d-ab6a-ce63b7750f46</ApplicationTypeId>
<HtmlName>htmlname</HtmlName>
<HtmlDescription>htmldescription</HtmlDescription>
<Url>url</Url>
<AvatarUrl>avatarurl</AvatarUrl>
</Application>
</Content>
</CurrentStatus>
</CreatedByUser>
<ContentId>2d525bad-c4df-470d-a193-a1c6d66e5c3e</ContentId>
<ContentTypeId>bd519379-b61f-4e2f-b0f9-c0f28c5cceb1</ContentTypeId>
<CreatedDate>2012-05-02T00:00:00</CreatedDate>
<HtmlName>htmlname</HtmlName>
<HtmlDescription>htmldescription</HtmlDescription>
<Url>url</Url>
<AvatarUrl>avatarurl</AvatarUrl>
<Application>
<ApplicationId>9ba1ec43-dc34-4e27-a579-4a0855144e2f</ApplicationId>
<ApplicationTypeId>e3715662-2528-4ba1-84a7-bfcd9d548f80</ApplicationTypeId>
<HtmlName>htmlname</HtmlName>
<HtmlDescription>htmldescription</HtmlDescription>
<Url>url</Url>
<AvatarUrl>avatarurl</AvatarUrl>
<Container>
<ContainerId>6cdcf200-3bad-476d-af45-97b52545c337</ContainerId>
<ContainerTypeId>b04540ec-eb38-4fa1-b7bb-e3fde05401b4</ContainerTypeId>
<HtmlName>htmlname</HtmlName>
<Url>url</Url>
<AvatarUrl>avatarurl</AvatarUrl>
</Container>
</Application>
</Content>
</PointTransaction>
<Errors>
<Message>string</Message>
<Message>string</Message>
</Errors>
</Response>