v0.15.0
Quackback 0.15.0 lets you search your whole workspace from Ctrl+K, adds filters to the portal feed, and gives new teams a guided onboarding. Self-hosted installs can now be set up without a browser, and settings can be changed over the API and MCP. API keys now come in two kinds: personal keys that act as the teammate who made them, and workspace keys for integrations. This also tightens how existing keys and sign-ups work, so please read Before you upgrade first.
Before you upgrade
Action needed
- Replace API keys created by former teammates. Every existing key becomes a personal key: it has the access of the person who created it, checked on every request. If that person has been removed, has left or is blocked, the key stops working and returns
401. Removing a teammate also revokes their personal keys, and adding them back doesn't restore them. For integrations that must outlive any one person, create a workspace key in Settings > Developers. (#728, #904, #905) - Check keys made by teammates who can't see every conversation. A personal key now sees only the tickets and conversations its creator can see, over REST and MCP, including when it opens one by its ID. Keys made by Owners, Admins, Managers and Support leads see no change. A key made by someone limited to their own or their team's items now gets only those, and
404for the rest. (#904) - Re-send pending invitations after upgrading. Invitation and account recovery links sent before the upgrade show "invalid link" afterwards, because the sign-in library now stores them differently. (#772, #774)
- Set your proxy headers if you run behind a reverse proxy. Anonymous posting is now limited to 5 posts per IP address per hour. Without
TRUSTED_PROXY_HOPSorTRUSTED_CLIENT_IP_HEADER, Quackback sees every visitor as the proxy's address, so they all share one limit. (#706) - Allow a longer first start on large databases. New search indexes are built before the server starts, so raise health check and deploy timeouts if your database is large. (#779, #901)
Behaviour changes
- Personal keys can't exceed their creator's role. A key made by an admin who is now a member has member access. (#728)
- MCP tools check permissions one by one. People on custom roles, and the keys and apps they use, may lose tools their role doesn't cover. (#728)
- Keys with the
write:settingsscope can now change workspace settings. Check which keys hold it. (#740, #841) - The AI agent hands over when it needs a teammate to confirm an action. If it wants to use a tool you've set to "ask first", the customer sees "Connecting you to the team" and the conversation is routed to your team. The
assistant.handed_offwebhook fires with the reasonawaiting_confirmation. (#898) - Stricter API validation. A comment reaction must be a single emoji, and a status incident must use its own statuses and services that exist. Anything else returns
400. (#731, #715) - The audit log CSV has six new columns.
channel,credential_kind,credential_id,client_name,on_behalf_of_principal_idandon_behalf_ofcome after the existing ones, so scripts that read the first columns by position keep working; check any that read the row as a whole. (#733) - Status page RSS items have new IDs. Feed readers will show past updates as new once. (#714)
- The Copilot on Home Labs experiment is gone. Home shows the overview again. Teammates use Copilot from the conversation and ticket panel and in Slack. The experiment was off by default. (#900)
- 17 database migrations run on start. They correct the start times of past maintenance windows, split the AI permission in two, and mark every existing API key as a personal key. Every role that had the AI permission gets both halves, so nobody gains or loses access. (#738, #905)
What's new
Search and the portal
- Search everything from Ctrl+K. Posts, conversations, tickets, help center articles, changelog entries, people, teammates and companies appear in one ranked list, showing only what you can open. Press Enter for a full results page with type filters and highlighted excerpts. With an embedding provider set up, it also finds matches by meaning. (#901)
- Smarter search in the portal, widget and feedback list. Search matches the start of words, tolerates typos, and falls back to close matches when nothing matches exactly. A new Best match sort puts the closest results first, and a search with no results can be posted as a new post. (#778, #779, #780)
- Portal feed filters. Filter the feed by status, board, tag and view, and click a filter's chip to change it. Shipped posts link to the changelog entry that announced them, and the header stays visible as you scroll. (#777, #807, #808)
- Author-only replies. A board can limit replies to the post's author and your team. Contributed by @shamblashini. (#433)
- Title-only posts. Posts no longer need a description. (#701)
API keys
- Your own API keys. Every teammate can create, rename, rotate and revoke their own personal keys in their account settings, under API keys. New keys expire after 90 days by default. Admins can turn off new personal keys. (#906)
- Workspace keys for integrations. A workspace key has its own role, picked when you create it, and keeps working when people leave. Create one in Settings > Developers. You can only give a key a role whose permissions you hold, and only an admin can give one the Owner role. Admins see every teammate's personal keys there and can revoke any of them. (#905, #906)
Onboarding and admin
- Guided onboarding. New workspaces get a setup wizard, a launch plan on Home, a product tour, a Messenger preview, and quick ways to install Messenger and invite the team. Welcome and setup emails arrive in the team's language. (#706)
- Your logo, offered from your website. New workspaces look up the company website and offer the logo it finds. It is never applied without asking. Turn the lookup off with
DISABLE_AUTOMATIC_BRANDING=true. (#706, #723) - Support lead role. A new built-in role for running support. AI settings now have two permissions: Customer-facing AI and Teammate AI. (#738)
- See where each change came from. Every audit log entry shows whether a change came from the app, the API, MCP, the AI, a workflow or the system, and which key or app made it. (#733)
- Simpler custom sending domains. Setup takes three DNS records. Quackback checks them automatically for 72 hours and tells you when the domain goes live or breaks. A new Settings > Domains page shows all your domains, and a verified sending domain also verifies SSO domains under it. (#887, #894)
- Quinn is now Quackback AI. The built-in AI agent has a new name. (#711, #789)
Languages
- Thai and Ukrainian. Contributed by @iPLAYCAFE-dev and @shamblashini. (#692, #720)
- Every language fully translated. Polish terms were updated by @ggfunnn, and browsers set to plain
ptnow get Brazilian Portuguese. (#638, #707)
API, MCP and integrations
- Workspace settings over REST and MCP. Read and change settings with
/api/v1/settingsor theget_settingsandupdate_settingstools. Every change returns a receipt you can undo, and?dry_runpreviews a change without saving it. (#740, #841) - Sign in from CLIs and MCP clients. Tools without a browser can sign in by entering a code on the new
/devicepage. (#739) - New webhook events.
post.mentioned,post.owner_assigned, and status page events for incidents, maintenance and component changes. (#727) - Complete API reference. The OpenAPI spec now covers every public route, and
/api/v1/membersworks again. (#725) - Tracking consent in the widget. Hold visitor tracking until consent with
init({ tracking: false }), then callQuackback.tracking(true). Page-view counting and the device id can also be switched off per workspace. Both stay on by default. (#782, #785)
Self-hosting
- Set up without a browser.
POST /api/v1/setupwith aSETUP_TOKENcreates the workspace and first admin. If you don't set a token, the server prints one to its log on first start. The endpoint switches off once an admin exists. (#739) - Setup is locked to the first account. On a new install, nobody else can sign up until setup is finished. To hand an unfinished setup to someone else, set
SETUP_OWNER_EMAILand restart. (#702) - Session replay masking options. If you use PostHog,
POSTHOG_SESSION_RECORDING_MASK_TEXTandPOSTHOG_SESSION_RECORDING_MASK_INPUTScontrol what replays hide. Both stay on by default. (#800) - A one-time GitHub star prompt. After a few weeks of use, each teammate is asked once to star Quackback on GitHub. Turn it off with
DISABLE_GITHUB_STAR_PROMPT=true. (#896)
Security
- Votes stay private. Nobody can list the posts another person voted on. (#705)
- Restricted changelog entries stay out of RSS. The changelog feed respects category restrictions. Contributed by @kytenz. (#801)
- No comments on merged posts. A post merged into another can no longer receive comments. (#713)
- API keys stay inside their creator's access. A personal key can no longer list, open or change tickets and conversations its creator can't see. (#904)
- MCP
get_ticketchecks access. It returns only tickets the caller can see. Contributed by @melihsunbul. (#750) - Changelog links follow who can see the changelog. Posts no longer link to a changelog that is closed to the person viewing them. (#902)
- MCP flags customer-written text. Tool results mark text written by customers, so AI clients don't follow instructions hidden inside it. (#730)
- Dependency patches. Fixes for GHSA-qx66-fv34-fjm8 and GHSA-27r3-jxmh-p828, and the sign-in library's magic link fix. (#771, #772, #829)
Bug fixes
- Status page. People who unsubscribed are no longer added back, and emails only cover the services each subscriber chose. Rescheduled maintenance no longer starts at the old time, and no status update is lost if the server stops mid-change. (#714, #715, #722, #736)
- Jira. Status sync no longer stops silently after about 30 days. (#788)
- Domains. A slow DNS lookup no longer marks a working sending or help center domain as broken. (#890)
- Discord. The channel picker shows which channels the bot can post in, and explains why adding one failed. (#835)
- Help center SEO. Article titles include the workspace name, sitemap links use https, pages have canonical links, and repeated headings get their own anchors. (#783, #787)
- Inbox. The team response count is correct again, and searching status incidents works. (#828)
- Moderation. Approve and reject say when they fail, and rejected posts no longer show the review banner. Contributed by @Nuenni. (#893)
- Portal filters. Fixed a rendering issue when changing feed filters. Contributed by @MisakaMirai. (#876)
- Accessibility. Focus rings are clearly visible, touch targets are larger, admin pages have their own tab titles, and long workspace names fit the portal header. (#698, #700, #699)
- Performance. English pages are smaller to download, and the inbox and settings respond faster. (#716, #719, #721, #830)
- Long dialogs. Dialogs and side panels stay inside the screen and scroll, instead of running off the top and bottom. (#907)
- Wording. Board items are called posts everywhere. (#895)
Contributors
Thank you to the community contributors in this release:
- @iPLAYCAFE-dev added Thai. (#692)
- @shamblashini added Ukrainian and author-only replies for boards. (#720, #433)
- @ggfunnn translated the remaining portal text and updated the Polish terms. (#638)
- @kytenz kept restricted changelog entries out of the RSS feed. (#801)
- @Nuenni made moderation errors visible. (#893)
- @MisakaMirai fixed a rendering issue in the portal filters. (#876)
- @melihsunbul made MCP
get_ticketcheck the caller's access. (#750) - @theluckystrike co-wrote the widget hand-off tests. (#691)
Full Changelog: https://github.com/QuackbackIO/quackback/compare/v0.14.1...v0.15.0