POST api/v2.0/Ideation/AddIdeaCategories

Add categories to an idea.

Request Information

URI Parameters

None.

Body Parameters

Name	Description	Type	Additional information
IdeationKey	Key of the idea.	globally unique identifier	Required
IdeationCategoryKeys	Category keys to add to the idea.	Collection of globally unique identifier	Required

Request Formats

application/json, text/json

Sample:

{
  "IdeationKey": "d464a033-21bd-4366-9b77-c0c80992f185",
  "IdeationCategoryKeys": [
    "d0b1d8fb-3807-4bc3-b35e-3c8137a22db5",
    "7f703884-1b7f-44a3-ba68-e43dc0fa22c8"
  ]
}

application/xml, text/xml

Sample:

<SetIdeaCategoriesRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/HigherLogic.API.Models.Enterprise.Ideation">
  <IdeationCategoryKeys xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:guid>d0b1d8fb-3807-4bc3-b35e-3c8137a22db5</d2p1:guid>
    <d2p1:guid>7f703884-1b7f-44a3-ba68-e43dc0fa22c8</d2p1:guid>
  </IdeationCategoryKeys>
  <IdeationKey>d464a033-21bd-4366-9b77-c0c80992f185</IdeationKey>
</SetIdeaCategoriesRequest>

Response Information

Resource Description

Idea updated

IdeaDetails

Name	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

Sample:

{
  "IdeationKey": "7a401ef1-2cc0-49f3-9d0b-c1919a4d9553",
  "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": "c28a4313-a836-4f1c-8cc1-9cd302af06ac",
    "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": "2026-03-26T21:39:00.4451585Z",
    "UpdatedByContactKey": "3a19cf1c-b2e6-47c5-9c82-86aca71532e5",
    "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": "2026-03-26T21:39:00.4451585Z"
  },
  "IsAnonymous": true,
  "CreatedOn": "2026-03-26T21:39:00.4451585Z",
  "UpdatedOn": "2026-03-26T21:39:00.4451585Z",
  "AttachmentURLs": null
}

application/xml

Sample:

Sample not available.

text/xml

Sample:

Sample not available.