Close the spotlight vote
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.
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.
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
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/community/spotlight/close"{ "id": "string", "candidate": "string", "status": "open", "winner": "string", "closedAt": "string", "createdAt": "string"}Vote on who gets the next spotlight POST
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.
List your shops GET
Every shop the authenticated user owns, newest first. Another shopkeeper's shop is not in this list and is not distinguishable from one that does not exist.