POST /ideabank/proposals

Submit a new proposal to an idea bank on behalf of a panelist. Requires the canSubmitProposal capability (see Get Idea Bank). When the idea bank collects contact info, the panelist’s contact details can be attached to the submission.

Request

POST /public/ideabank/proposals

Headers

Request Body

{
	"title": "Dark mode",
	"description": "Please add a dark theme for night-time use.",
	"contactInfo": "panelist@example.com",
	"contactInfoLabel": "email"
}

contactInfo is only stored when both contactInfo and contactInfoLabel are supplied. Use the contactInfoCollection object from the Get Idea Bank response to decide whether to collect and which label to send.

Response

{
	"proposalId": "p-abc123",
	"title": "Dark mode",
	"description": "Please add a dark theme for night-time use.",
	"votes": 0,
	"totalVotes": 0
}

Response Fields

Examples

cURL

curl -X POST \
  "https://api.votito.com/public/ideabank/proposals" \
  -H "Authorization: abc123:xyz789:ses456" \
  -H "Content-Type: application/json" \
  -d '{"title":"Dark mode","description":"Please add a dark theme."}'

JavaScript

const submitProposal = async (publicKey, { title, description, contactInfo, contactInfoLabel } = {}) => {
	const response = await fetch('https://api.votito.com/public/ideabank/proposals', {
		method: 'POST',
		headers: {
			'Authorization': publicKey,
			'Content-Type': 'application/json'
		},
		body: JSON.stringify({ title, description, contactInfo, contactInfoLabel })
	});

	if (!response.ok) {
		throw new Error(`Failed to submit proposal: ${response.status}`);
	}

	return response.json();
};

// Usage
const proposal = await submitProposal(publicKey, {
	title: 'Dark mode',
	description: 'Please add a dark theme.'
});
console.log(`Created proposal ${proposal.proposalId}`);

Python

import requests

def submit_proposal(public_key, title, description, contact_info=None, contact_info_label=None):
    body = {"title": title, "description": description}
    if contact_info and contact_info_label:
        body["contactInfo"] = contact_info
        body["contactInfoLabel"] = contact_info_label
    response = requests.post(
        "https://api.votito.com/public/ideabank/proposals",
        headers={
            "Authorization": public_key,
            "Content-Type": "application/json"
        },
        json=body
    )
    response.raise_for_status()
    return response.json()

# Usage
proposal = submit_proposal(public_key, "Dark mode", "Please add a dark theme.")
print(proposal["proposalId"])

Error Handling

Notes

• Both title and description are mandatory; the server rejects empty values with field-required.
• A new proposal starts with votes and totalVotes equal to 0.
• Whether a panelist may submit is controlled by the canSubmitProposal capability; gate the submission form on it.