Documentation
Error codes
All 43 of them. Every failure the bot can produce is a stable code with a plain explanation and a next step — never a stack trace. Each code has its own page, so the one on your screen can be looked up directly:
/docs/errors/sb-credit-402.Credits and plans
Quote the trace id
Every failure also carries a short trace id, shown next to the code —
SB-CREDIT-402 · trace f3a9c2. The code says what class of problem it is; the trace id identifies your exact request in the logs. Pasting the whole footer line into the support server turns “a summary failed” into something that can be looked at directly.SB-CREDIT-402This server needs more creditsThe request costs more credits than the server has left.SB-CREDIT-429You've reached today's member safeguardOne member can only spend so many of the server's shared credits in a day, so a single account can't empty the balance for everyone.SB-CREDIT-430You've reached this period's member safeguardOne member has reached the server's interactive credit limit for this billing period or UTC month.SB-CREDIT-409That quality needs a higher automatic-run limitEvery automatic run has a standing credit cap. The quality you picked costs more than that cap allows even at its smallest size.SB-CREDIT-400That member safeguard won't workA per-member safeguard has to sit inside the range the message names, or be 0 to restore the recommended default for the plan.SB-CREDIT-503Paid usage is temporarily paused for this serverAn internal cost safeguard stopped the request. Your credit balance was not touched.SB-TIER-402That quality needs a higher planModel quality is part of the plan, not something credits buy. Balanced needs Pro; Deep needs Scale.SB-PLAN-402That feature needs a higher planServer-wide summaries, live channels, presets, and welcome summaries are plan features. Buying credits does not unlock them.SB-PLAN-409This plan's limit is fullYou've used every schedule or live channel the plan includes.SB-ASK-402This server used its three included asksWithout a subscription a server gets three /ask or @mention replies in total. Catch-ups keep working while it has credits.SB-QUOTA-431Summary Bot reached its daily safety stopThe bot's own provider wallet hit its daily ceiling. This is separate from your server's credits and resets at midnight UTC.SB-QUOTA-433Credit-funded requests are temporarily pausedCalls paid for by Summary Bot are paused. Your credits have not changed, and requests using a personal key still work.SB-AGENT-430Slow down for a momentAgent mentions are rate limited per person and channel.SB-REC-429This server has used today's plan analyses/recommend reads the whole server and costs no credits, so it runs twice a day per server. The count resets at midnight UTC.SB-REC-204There isn't enough activity to analyse yetThere were no recent messages in any channel both you and the bot can read, so anything /recommend said about a plan would be a guess rather than a measurement.
Permissions and privacy
SB-PERM-403You can't read that channelThe bot only summarizes channels you can already see yourself. This is the check that makes it safe to install.SB-PERM-401The bot can't read that channelYou can see the channel, but the bot is missing permissions there.SB-PERM-407The bot can't post in that channelIt can read the channel but has no Send Messages there, so the summary has nowhere to go.SB-PERM-402The bot can't create a thread herePosting a summary as a thread needs the Create Public Threads permission.SB-PERM-405You can't create a public thread hereAgent conversations live in a visible thread, and this channel doesn't let you create one.SB-PERM-406You can't post in that channelThe agent's write tools never act somewhere you couldn't post yourself.SB-PERM-404That needs Manage ServerYou tried to change something shared by everyone in the server.SB-PERM-408This server limits summaries to adminsAn admin turned on the Manage Server requirement for every summary here.SB-PRIV-403Summaries are disabled in that channelAn admin has excluded the channel from summarization entirely. This applies to admins too.SB-DM-403The bot can't send you a DMYour Discord privacy settings block direct messages from members of this server.
Your request
SB-MSG-204Nothing to catch up onNo messages were found in the range you asked for. Usually the range is narrower than you meant, or everyone in it opted out.SB-TIME-400That time didn't parseThe value in since or until wasn't a date or time it could read.SB-TIME-404Unknown timezoneTimezones have to be IANA names, which are the only kind that resolve unambiguously.SB-BUSY-409Still working on your last oneYou already have a summary running. They queue badly, so only one runs at a time per person.
API keys
SB-KEY-401Your API key was rejectedThe provider says the key is invalid, revoked, or expired.SB-KEY-402The API account couldn't pay for thisThe key is valid, but the provider declined the request for lack of funds.SB-KEY-404No payment route is availableThe server's credits can't cover the request and there's no key to fall back on.SB-KEY-409Your saved key couldn't be readThe stored key can no longer be decrypted. This happens when the bot's own credentials are rotated.
Upstream
SB-PROV-503The AI provider is having troubleThe request failed at the provider, not in the bot. You were not charged for work that didn't happen.SB-PROV-504That took too longThe provider didn't respond in time.SB-PROV-451The model declined to summarize thisThe provider's safety systems refused the content. It is occasionally a false positive.SB-RATE-429Rate limitedThe provider is throttling requests right now.SB-DISCORD-502The summary ran, but Discord couldn't post itThe AI work finished and spent credits, but delivery failed. The message tells you exactly what was spent and what's left, and it won't retry on its own.