Vote on who gets the next spotlight
Adds the caller's ballot to the open spotlight vote, opening one if none is open. One ballot per owner: a second vote replaces the first. That is the whole anti-buy-the-spotlight rule — there is no way to send the command more times and weigh more, because the store holds the latest ballot per owner and not a count of them.
Adds the caller's ballot to the open spotlight vote, opening one if none is open. One ballot per owner: a second vote replaces the first. That is the whole anti-buy-the-spotlight rule — there is no way to send the command more times and weigh more, because the store holds the latest ballot per owner and not a count of them.
Authorization
bearerAuth A bearer token. The Account routes accept a Privy access token; the MCP transport accepts an sk- API key issued by POST /account/api-keys.
In: header
Request Body
application/json
Who the vote is for.
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/community/spotlight" \ -H "Content-Type: application/json" \ -d '{ "candidate": "string" }'{ "id": "string", "candidate": "string", "status": "open", "winner": "string", "closedAt": "string", "createdAt": "string"}Get the open spotlight vote GET
The open spotlight vote and the ballots on it, or `null` when no vote is open. One vote at a time. A second open vote would mean two spotlight slots, which is not a thing the Kit offers — so casting a vote while one is open adds a ballot to it rather than starting another.
Close the spotlight vote POST
Closes the open vote and records its winner. The winner is the highest ballot count, ties broken by the order the ballots were cast — so the person who got there first keeps it and the outcome is the same on every run. The closed vote is kept, so a spotlight can be shown after the fact. Closing with no open vote is a 409, not a silent success: a caller that asked to close something needs to know it was not there.