POST api/v2.0/Ideation/Post
Create a new idea.
Request Information
URI Parameters
None.
Body Parameters
New idea to submit
NewIdeaRequestName | Description | Type | Additional information |
---|---|---|---|
Title |
Title of the idea. Maximum length is 100 characters. |
string |
Required |
Description |
Description of the idea. |
string |
Required |
IdeationStatusKey |
Key for the status of the idea. Statuses are configurable on a per-site basis, the list of available statuses can be retrieved from the getStatuses endpoint. |
globally unique identifier |
Required |
IdeationCategoryKeys |
Keys for the categories the idea is associated to. Categories are configurable on a per-site basis, the list of available categories can be retrieved from the getCategories endpoint. |
Collection of globally unique identifier |
None. |
IsAnonymous |
True if the idea is being submitted anonymously. |
boolean |
None. |
Request Formats
application/json, text/json
{ "Title": "sample string 1", "Description": "sample string 2", "IdeationStatusKey": "dafdc232-5f0a-4d6e-975f-ce15b56696ed", "IdeationCategoryKeys": [ "8a7206ec-ba9d-456b-8f0f-49974f6a8140", "99e6eea7-96d0-4956-9e73-83043b651d49" ], "IsAnonymous": true }
application/xml, text/xml
<NewIdeaRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/HigherLogic.API.Models.Enterprise.Ideation"> <Description>sample string 2</Description> <IdeationCategoryKeys xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d2p1:guid>8a7206ec-ba9d-456b-8f0f-49974f6a8140</d2p1:guid> <d2p1:guid>99e6eea7-96d0-4956-9e73-83043b651d49</d2p1:guid> </IdeationCategoryKeys> <IdeationStatusKey>dafdc232-5f0a-4d6e-975f-ce15b56696ed</IdeationStatusKey> <IsAnonymous>true</IsAnonymous> <Title>sample string 1</Title> </NewIdeaRequest>
Response Information
Resource Description
Submitted idea
IdeaDetailsName | Description | Type | Additional information |
---|---|---|---|
IdeationKey |
Unique identifier of the idea. |
globally unique identifier |
None. |
Title |
Title of the idea. |
string |
None. |
Description |
Description of the idea. |
string |
None. |
LinkToViewIdea |
Direct link to view the idea on the main microsite. |
string |
None. |
Status |
Object containing information about the status of the idea. |
IdeaStatus |
None. |
Community |
The community the idea has been associated to. If null or doesn't exist (i.e. the idea is not associated to any community), the idea is considered to be a site-wide idea. |
Community |
None. |
Categories |
All categories the idea has been associated to. |
Collection of IdeaCategory |
None. |
TotalUpvotes |
Number of upvotes. |
integer |
None. |
TotalDownvotes |
Number of downvotes. |
integer |
None. |
HasOfficialComment |
True if this idea has an official comment from an admin. |
boolean |
None. |
Author |
Information about the author of the idea. |
ContactConcise |
None. |
IsAnonymous |
True if the idea was submitted anonymously. |
boolean |
None. |
CreatedOn |
DateTime the idea was created. |
date |
None. |
UpdatedOn |
Most recent DateTime the idea was updated. |
date |
None. |
AttachmentURLs |
Temporary URLs to view or download any attachments associated with the idea. |
Collection of IdeaAttachment |
None. |
Response Formats
application/json, text/json
{ "IdeationKey": "a6b64f98-2dca-4a3f-afab-0edd9843c174", "Title": "sample string 2", "Description": "sample string 3", "LinkToViewIdea": "sample string 4", "Status": null, "Community": null, "Categories": null, "TotalUpvotes": 5, "TotalDownvotes": 6, "HasOfficialComment": true, "Author": { "LinkToProfile": "sample string 1", "PictureUrl": "sample string 2", "ContactKey": "a95f36a2-26c3-4385-9efb-6237539167be", "FirstName": "sample string 4", "LastName": "sample string 5", "DisplayName": "sample string 6", "EmailAddress": "sample string 7", "ContactStatusCode": "sample string 8", "PrefixCode": "sample string 9", "UpdatedOn": "2025-02-18T10:31:29.2754713Z", "UpdatedByContactKey": "8b948e25-86ad-4414-bc9e-8113c64450da", "CompanyName": "sample string 12", "CompanyTitle": "sample string 13", "SuffixCode": "sample string 14", "Designation": "sample string 15", "LegacyContactKey": "sample string 16", "InformalName": "sample string 17", "MiddleName": "sample string 18", "IsCompany": true, "CompanyLegacyContactKey": "sample string 20", "AMSDirectoryOptOut": true, "HLDirectoryOptOut": true, "HLContactMeOptOut": true, "LargePictureUrl": "sample string 24", "AgreedToTermsDateTime": "2025-02-18T10:31:29.2754713Z" }, "IsAnonymous": true, "CreatedOn": "2025-02-18T10:31:29.2754713Z", "UpdatedOn": "2025-02-18T10:31:29.2754713Z", "AttachmentURLs": null }
application/xml
Sample not available.
text/xml
Sample not available.