To replace the API key Assembled uses to connect to MaestroQA, you create a new one in MaestroQA, and our Support team helps you update it in Assembled. How it's updated depends on how your connection was set up, so please contact Support before you change anything.
If you're here because of the November 13, 2026 security incident: Assembled can't revoke MaestroQA credentials from our side, so please replace yours using these steps. Pausing or disconnecting the integration in Assembled doesn't stop the old API key from working. Only retiring it in MaestroQA does. For more about the incident, see November 13, 2026 security incident.
Who does this
- An Assembled admin, or someone with a role that can configure third-party integrations.
- A MaestroQA admin who can create and delete API keys.
Before you start
- Contact Support and tell us which MaestroQA accounts you use with Assembled, including any test or sandbox accounts. Don't send credentials by email or chat.
- Note any custom MaestroQA settings you've set up in Assembled, such as mappings, so we can check them with you.
Steps
- Contact Support. We'll confirm which API key Assembled uses for your account and how to update it.
- In MaestroQA, have your admin create a new API key.
- Follow Support's instructions to update the key in Assembled. Don't remove the integration or set it up again from scratch, because that can delete your saved settings.
- Once the new API key is working, have your MaestroQA admin delete the old API key, including any older keys from earlier reconnects.
- Check the MaestroQA card in Configure > Third-party integrations for a new successful sync.
How to confirm it's working
- On the MaestroQA card, check for a recent successful sync. The Connected tag on its own doesn't confirm that data is flowing.
- Check that new QA scores appear in Assembled.
- If a sync row is red, hover over it to see the error, and send that error text to Support.
When you'll see data
Assembled syncs MaestroQA scores every 5 minutes. After the connection is updated, allow time for the next scheduled sync. Reports can take a little longer to refresh.
Restoring missed data
Updating the connection normally starts a backfill of your MaestroQA history. If you've customized MaestroQA mappings or settings in Assembled, let Support check them first, because a backfill that runs with missing settings can overwrite history. If you still see gaps, contact Support with the dates affected.
Things to watch for
- Contact Support first. We'll confirm the right way to update your connection before you change anything.
- Don't remove the integration. Removing it or setting it up again from scratch can delete your saved settings.
- Retire the old API key in MaestroQA. Disconnecting or pausing the integration in Assembled doesn't stop it from working.
- Keep the same access. Give the new API key the same permissions as the old one, or syncs can fail.
For more about how the integration works, see MaestroQA integration.
Need help?
If something doesn't look right, contact our Support team and include any error text you see. Please don't send API keys, tokens, or secrets by email or chat.