Developers / Changelog
Changelog and versioning
Our promise for v1
Code you write against /api/v1, /client/v1, the widget and @list79/client 0.x keeps working. Within v1 we only make changes that don't break it:
- We may add endpoints, add optional fields to what you send, add fields to what we return, add webhook events, and add new values to lists such as statuses and sources. Ignore fields and values you don't know.
- We won't remove or rename an endpoint or field, change a field's type or meaning, make an optional field required, or change how authentication works.
- If we ever must break something, it goes in a new version (
/api/v2), and v1 keeps running for at least 12 months after we announce it here and email every account owner who has used the API. - Security fixes are the one exception: if something has to change to keep your users safe, we change it, tell you why, and keep it as small as we can.
Changes
-
16 Nov 2026
Portals in your brand, and a roadmap that shows progress
- The portal has a plain look that fits any product. Set your brand colour, rounded or square corners, and light, dark or each visitor's setting under Keys and portal → Portal look. The widget uses the same colour unless
data-colorsays otherwise. - The roadmap is one track from Planned to In progress to Shipped, with milestones sorted by their target month and shipped work grouped by month.
- Widget config (
/widget/v1/config) addscolorandonColor.
- The portal has a plain look that fits any product. Set your brand colour, rounded or square corners, and light, dark or each visitor's setting under Keys and portal → Portal look. The widget uses the same colour unless
-
15 Nov 2026
Product name, tagline and description per language
- Under Product page, Other languages, give a product its own name, tagline and description in any language the portal supports. The portal, widget and sign-in email use the one for the visitor's language; anything left empty uses the default.
GET /client/v1/mereturnsproduct.names: the name in each language that has its own, by language code.product.nameis still the default.
-
15 Nov 2026
Import from Canny, UserVoice or a spreadsheet
- Upload a CSV file under Product settings, check which column is which (List79 guesses), and import requests with their status, date, author and voters.
- People are matched by user ID or email. Imported votes don't count toward your plan, imported people get no update emails unless you choose, and an import can be undone.
-
15 Nov 2026
MCP server for AI tools
https://list79.com/mcp(Streamable HTTP), signed in with a secret key:list_requests,get_request,list_voters,top_requests_by_revenue,list_milestones, and with a key that isn't read-onlyset_status,record_decision,add_note,replyandmerge_requests.- Shares the API's limit of 300 calls a minute per product.
-
15 Nov 2026
Safe retries, rate-limit headers and read-only keys
Idempotency-KeyonPOST,PATCH,PUTandDELETE: a retry with the same key and call gets the first answer back (Idempotent-Replayed: true) for 24 hours. The same key for a different call is a422.RateLimit-Limit,RateLimit-Remaining,RateLimit-ResetandRateLimit-Policyon every API answer.List79-Request-Idon every API, client API and widget answer, shown in the request log.- Read-only secret keys: a change made with one is a
403. - A failed user token now says why in the
401'sdetail.
-
15 Nov 2026
Team API and GitHub
PATCH /requests/{number},/decisions,/merge,/replies,/notesand/voters: your team's actions through the API. Changes are credited to the key on the request's page./requests/{number}/links: link GitHub issues and pull requests; with GitHub connected, closing one as completed ships the request./milestones: the roadmap through the API.GET /requeststakesqto search.
-
15 Nov 2026
Client API and
@list79/client0.1.0/client/v1: requests, voting, suggesting and comments from the browser, with your public key and the user's token.@list79/clienton npm: a typed client and React hooks. Requests made this way have sourceapp.
-
15 Nov 2026
Webhooks and test mode
- Webhooks:
request.created,request.status_changed,request.merged,vote.created,vote.deleted,comment.created, signed and retried. - Test mode:
pk_test_andsk_test_keys with their own data. Events from test mode have"livemode": false.
- Webhooks:
-
15 Nov 2026
Deleting users
DELETE /users/{userId}: remove a user's data when they delete their account in your app.
-
13 Nov 2026
v1
- The REST API with secret keys: requests, votes, comments and users.
- The drop-in widget with signed user tokens, and the public portal.
- Seven languages for the widget and portal.