Skip to content
sprintrr logo
sprintrr
Sign in

Troubleshooting

Fixes for common issues with avatars, profile sync, credits, plan changes, and the MCP API.

My avatar/display name didn't update everywhere

Profile changes propagate to the app's cached session. If a new avatar or display name doesn't appear immediately in the sidebar after saving, do a hard refresh. Avatars are written so they stay consistent across the app, the activity feed, and team lists; a stale view almost always resolves on reload.

AI generation says I'm out of credits

Check Settings → Billing for your balance and reset date. Options:

  • Wait for the monthly reset, or buy a credit pack.
  • Upgrade your plan for a larger monthly allotment.
  • Enable Bring Your Own Key — available on every plan — to run generation on your own provider key (no sprintrr credits consumed).

I enabled BYOK but generation still fails

  • Confirm the provider key is valid — sprintrr validates keys with a live test on save, but a key can be revoked or rate-limited on the provider side later.
  • Confirm the active provider is the one whose key you configured.
  • Check your provider account's quota/billing — with BYOK you pay the provider directly.

BYOK generation fails immediately with a key error

Errors that surface as soon as you click Generate point at the saved key itself, not at provider quota:

  • "Couldn't decrypt your saved key" — the encrypted key in storage can no longer be read (most often after a server-side encryption-key rotation). Delete the affected provider key in Settings → API Keys and add it again from your provider console.
  • Gemini rejects the key — make sure the key was created in Google AI Studio, not Cloud Console. The default Gemini model used for validation is gemini-3.1-flash-lite; if you've overridden the model, confirm the override is still available on your project.
  • OpenAI "must mention JSON" — sprintrr asks OpenAI for a JSON object response. Some restricted org policies block response_format: json_object; check your OpenAI org's model-access settings.

If the key is otherwise valid, see BYOK for default models and how to override them.

I clicked Log out and ended up back on the dashboard

This used to happen if a previous AI generation flag was wedged in your browser, or if you cancelled an in-progress Google sign-in mid-flow. Recent builds clear all session state on logout and hard-reload to the landing page, so the issue should be gone. If you're on an older client tab and still see the bounce:

  1. Click Log out once more (newer builds force a server-side session revoke).
  2. If you're still stuck, clear site data from your browser's DevTools (Application → Storage → Clear site data) and reload — that drops any cached client state.

A plan change isn't reflected

Billing is processed by Polar. After upgrading, downgrading, or reactivating, the change may take a moment to propagate; reload Settings → Billing. If a renewal is late, a short grace period keeps access active while billing resolves rather than cutting off immediately.

MCP: every request returns 401

The header must be exactly Authorization: Bearer sk_live_…. Confirm the key hasn't expired or been revoked. Because keys are unrecoverable by design, if you're unsure, create a fresh key in Settings → MCP Keys. See MCP → Errors.

MCP: 403 Permission denied

The key was created without the scope that endpoint requires. Create a key with the default (full) permissions, or include the specific action:resource scope. See MCP → Permissions and scopes.

MCP: client can't start the server

  • Ensure Node 18+ is available to npx.
  • Restart the MCP client after editing its config file.
  • To point at a non-production environment, set SPRINTRR_API_URL in the client's env block (defaults to https://www.sprintrr.ai).

A deleted project/task is gone for good

Deletion is permanent and cascades (deleting a project removes its tasks and milestones). There is no trash/restore — export before deleting if you might need the data.

Still need help?

Re-check the relevant guide from the sidebar, or review the FAQ. For account or billing issues, use the support/contact path in the app.

PreviousFAQ