POST api.ashx/v2/ideas/challenge.{json|xml}
Request Parameters
Name | Type | Location | Description | Required | Default | Options |
---|---|---|---|---|---|---|
AllowMultipleVotes | bool | Request Body | Determines whether users can vote on their favorite ideas in this ideation. | Optional | ||
ApplicationKey | string | Request Body | Application Key | Optional | ||
CreatedDateUtc | DateTime | Request Body | Created Date Utc | Optional | ||
Description | string | Request Body | Description | Optional | ||
GroupId | int | Request Body | Group Id | Required | ||
IsEnabled | bool | Request Body | Enabled | Optional | ||
IsModerated | bool | Request Body | Moderate | Optional | ||
MaximumVotesPerIdea | int | Request Body | The maximum number of votes a user can cast for a given idea. Not setting this value or setting it to 0 will allow users to use as many votes as they have available on any given idea. This setting is only valid when multiple votes are permitted. | Optional | ||
MaximumVotesPerUser | int | Request Body | The maximum number of votes a user can cast within this ideation. Not setting this value or setting it to 0 will result in vote per user per idea. | Optional | ||
Name | string | Request Body | Ideation Name | Required | ||
RequiresCategory | bool | Request Body | Determines whether ideas created in this ideation must specify a category. | Optional |
Example Requests
Widget Javascript
jQuery.telligent.evolution.post({ url: jQuery.telligent.evolution.site.getBaseUrl() + 'api.ashx/v2/ideas/challenge.json', data: { 'GroupId': '6', 'Name': 'name' } }).then(function(response) { // use response });
Example Responses
JSON
{ "Challenge": { "Id": "49fec544-6df7-4a82-872b-f8be586d5e9e", "Group": { "Name": "name", "Url": "url", "AvatarUrl": "avatarurl", "Id": 6 }, "ApplicationId": "9f5a6721-639d-4e1d-ab6a-ce63b7750f46", "ApplicationTypeId": "fe65240b-044c-4292-9946-f10e0361ecff", "Name": "name", "Description": "description", "ApplicationKey": "applicationkey", "CreatedDate": "2012-01-04T00:00:00", "IsEnabled": true, "TotalPosts": 25, "LastPostDate": "2012-05-02T00:00:00", "MaximumVotesPerUser": 8, "MaximumVotesPerIdea": 4, "RequiresCategory": true, "AllowMultipleVotes": true }, "Errors": [ "string", "string" ] }
XML
<?xml version="1.0" encoding="utf-16"?> <Response> <Challenge> <Id>49fec544-6df7-4a82-872b-f8be586d5e9e</Id> <Group> <Name>name</Name> <Url>url</Url> <AvatarUrl>avatarurl</AvatarUrl> <Id>6</Id> </Group> <ApplicationId>9f5a6721-639d-4e1d-ab6a-ce63b7750f46</ApplicationId> <ApplicationTypeId>fe65240b-044c-4292-9946-f10e0361ecff</ApplicationTypeId> <Name>name</Name> <Description>description</Description> <ApplicationKey>applicationkey</ApplicationKey> <CreatedDate>2012-01-04T00:00:00</CreatedDate> <IsEnabled>true</IsEnabled> <TotalPosts>25</TotalPosts> <LastPostDate>2012-05-02T00:00:00</LastPostDate> <MaximumVotesPerUser>8</MaximumVotesPerUser> <MaximumVotesPerIdea>4</MaximumVotesPerIdea> <RequiresCategory>true</RequiresCategory> <AllowMultipleVotes>true</AllowMultipleVotes> </Challenge> <Errors> <Message>string</Message> <Message>string</Message> </Errors> </Response>