Developers

Adding an Idea to a Brainstorm Challenge

Submissions questions may not be required to add an idea to a challenge. Retreive the challenge profile prior to adding an idea to a challenge to get required submission questions. See here for more information.

Adding an idea to a challenge via the API requires a POST request.

POST parameters

• AddIdeaToChallenge - The data transfer object to hold data
  • Id - The id of the challenge
  • IdeaId - The id of the idea
  • SubmissionQuestions - Array of submission questions. See here for more information.
    • SubmissionQuestion - A data transfer object to hold data
      • Id - The id of the submission question
      • Value - The answer to the submission question

• XML
• JSON

<AddIdeaToChallenge xmlns="http://brainstorm.intuit.com" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <Id>311</Id>
    <IdeaId>7797</IdeaId>
    <SubmissionQuestions>
        <SubmissionQuestion>
            <Id>1807</Id>
            <Value>This is the answer to the sample submission question</Value>
        </SubmissionQuestion>
        <SubmissionQuestion>
            <Id>1808</Id>
            <Value>This is the other answer to the sample submission question</Value>
        </SubmissionQuestion>
    </SubmissionQuestions>
</AddIdeaToChallenge>
            

{
    "Id": 312,
    "IdeaId": 7798,
    "SubmissionQuestions": [
        {
            "Id": 1810,
            "Value": "This is the answer to the sample submission question"
        },
        {
            "Id": 1811,
            "Value": "This is the other answer to the sample submission question"
        }
    ]
}
           

this API endpoint also requires valid X-On-Behalf-Of headers. See here for more information.

POST: /api/challenge/addIdea

Setting the ContentType

All POST requests to Brainstorm must have the following content type: application/x-www-form-urlencoded

        webRequest.ContentType = "application/x-www-form-urlencoded";
    

Upon successfull request, you will see an ApiSuccessCreate XML or JSON response. The value of the Id element will be the id of the pipeline that was just created.

    <ApiSuccessCreate xmlns="http://schemas.datacontract.org/2004/07/Brainstorm.Model.DTO" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <Message>Successfully created</Message>
        <StatusCode>200</StatusCode>
        <Id>5000</Id>
    </ApiSuccessCreate>