Documentation
Troubleshooting
Common problems
The things that actually come up, and what to do about each.
The slash commands don't appear
It says it can't read a channel I can read
/setup— it reports View Channel, Read Message History, Send Messages, and Embed Links per channel, so you can see which one is missing. Usually a channel-level override is denying the bot's role somewhere the server-level grant looks fine.The summary covered the wrong stretch of time
/settings timezone:America/New_York, times like since:9pm are read as UTC. Every summary states the window it used and why — check that line first. With no options at all, it starts from your own last message in the channel.It said there was nothing to catch up on, but the channel is busy
/privacy optout; or an admin has blocked the channel with /privacy channel. Try an explicit since:2 days to rule out the first.A scheduled summary stopped arriving
/schedule list to see its state. Schedules stop deliberately — and say so — when credits run out, the plan drops below what the schedule needs, or the destination channel is blocked or loses Send Messages. The one silent case is a genuinely quiet day, which produces nothing rather than a message saying nothing happened.It's using more credits than I expected
/settings, or a live channel with a low message threshold. Run /debug after a summary to see exactly what that one cost and why, and /usagefor the server's totals. The full formula is on Credits & billing.I bought a top-up and my balance didn't change
/usage in the server you want it in and apply it there. Nothing is lost in the meantime.It's taking a long time
Every error code
Every failure the bot can produce has a stable code and a short trace id, shown together at the bottom of the message — SB-CREDIT-402 · trace f3a9c2. The code tells you what class of problem it is; the trace id identifies your exact request in the logs.
Quote the trace id
Credits and plans
SB-CREDIT-402This server needs more creditsThe request costs more credits than the server has left.
Buy a top-up or upgrade from the buttons on the error, or narrow the request so it costs less. After buying a top-up, run /usage and apply it to this server — a purchase belongs to you until you choose where it goes.
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.
Wait for the daily reset named in the message, or ask an admin. This is per person, so other members are unaffected.
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.
Run the command again with max_credits set to at least the minimum the message names.
SB-CREDIT-503Paid usage is temporarily paused for this serverAn internal cost safeguard stopped the request. Your credit balance was not touched.
Try again later, use your own API key, or report it in the support server — this one is worth telling me about.
SB-TIER-402That quality needs a higher planModel quality is part of the plan, not something credits buy. Balanced needs Pro; Deep needs Scale.
Pick a quality the plan includes, or upgrade the server.
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.
Upgrade the server from the button on the error.
SB-PLAN-409This plan's limit is fullYou've used every schedule or live channel the plan includes.
Remove one you no longer need, or upgrade for a higher limit.
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.
Subscribe to keep asking questions. A top-up adds credits but won't unlock this.
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.
Try again tomorrow, or use your own API key in the meantime.
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.
Try again later, or add your own API key.
SB-AGENT-430Slow down for a momentAgent mentions are rate limited per person and channel.
Wait about a minute and mention it again.
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.
Pick a channel you have access to.
SB-PERM-401The bot can't read that channelYou can see the channel, but the bot is missing permissions there.
Ask an admin to grant it View Channel and Read Message History in that channel. /setup shows exactly what's missing.
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.
Ask an admin to grant Send Messages in that channel.
SB-PERM-402The bot can't create a thread herePosting a summary as a thread needs the Create Public Threads permission.
Ask an admin to grant it, or turn threads off in /settings.
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.
Mention the bot in a channel where you can create public threads.
SB-PERM-406You can't post in that channelThe agent's write tools never act somewhere you couldn't post yourself.
Choose a channel where you have Send Messages.
SB-PERM-404That needs Manage ServerYou tried to change something shared by everyone in the server.
Ask an admin, or make the change just for yourself instead.
SB-PERM-408This server limits summaries to adminsAn admin turned on the Manage Server requirement for every summary here.
Ask an admin to run it, or to change /privacy restrict.
SB-PRIV-403Summaries are disabled in that channelAn admin has excluded the channel from summarization entirely. This applies to admins too.
An admin can change it with /privacy channel.
SB-DM-403The bot can't send you a DMYour Discord privacy settings block direct messages from members of this server.
Turn on “Allow direct messages from server members” in that server's privacy settings, then try again.
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.
Widen the range, or pick a different channel.
SB-TIME-400That time didn't parseThe value in since or until wasn't a date or time it could read.
Try “3 hours”, “yesterday”, “since monday”, or “jan 5 2pm”.
SB-TIME-404Unknown timezoneTimezones have to be IANA names, which are the only kind that resolve unambiguously.
Use the Region/City form: America/New_York, Europe/London, Asia/Kolkata.
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.
Give it a few seconds and try again.
API keys
SB-KEY-401Your API key was rejectedThe provider says the key is invalid, revoked, or expired.
Run /setapikey with a fresh key, or /removeapikey to go back to the server's credits.
SB-KEY-402The API account couldn't pay for thisThe key is valid, but the provider declined the request for lack of funds.
Add billing on the provider's side, or remove the key with /removeapikey.
SB-KEY-404No payment route is availableThe server's credits can't cover the request and there's no key to fall back on.
Top up, upgrade, or add a key with /setapikey.
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.
Run /setapikey to add it again. Nothing else was lost.
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.
Try again shortly.
SB-PROV-504That took too longThe provider didn't respond in time.
Try again, or use a smaller range for a faster result.
SB-PROV-451The model declined to summarize thisThe provider's safety systems refused the content. It is occasionally a false positive.
Try a narrower range or a different summary style.
SB-RATE-429Rate limitedThe provider is throttling requests right now.
Try again in a moment — this usually clears within a minute.
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.
Check Send Messages and Embed Links on the destination, then run it again.
Presets
SB-PRESET-400That preset code isn't validThe sbp1:… code couldn't be read. Usually it was truncated when copied.
Ask whoever shared it to run /preset export again and copy the whole line.
SB-PRESET-409You already have a preset with that namePreset names have to be unique.
Pick a different name, or delete the existing one with /preset delete.
SB-PRESET-404No preset with that nameIt wasn't among your presets or the server's.
Run /preset list to see what's available.
Bugs
SB-SCHED-404That schedule isn't here any moreIt was removed, or it belongs to a different server.
Run /schedule list to see what's actually set up.
SB-INT-500Something broke on my endThis is a bug, not something you did wrong. It's already been logged.
Press Report on the message to send the details, or quote the trace id in the support server.
Getting help
If none of the above covers it, the Summary Bot support serveris the place. It's a small project run by one person, and questions get real answers rather than a ticket number.
What helps most, in one message:
- The error code and trace id, if you got one.
- What you ran, including the options you set.
- Roughly when it happened.
Never paste an API key or private message content
Billing transactions and refund requests have to go through Discord support, since Discord processes every payment — see how billing works.