Skip to content
Summary Bot

Documentation

Troubleshooting

Every error Summary Bot can show you is a named code with a plain explanation and a next step — never a stack trace. This page lists all of them, plus the handful of problems that come up most often.

Common problems

The things that actually come up, and what to do about each.

The slash commands don't appear
Discord caches an app's commands, and they can take a few minutes to show up after the bot joins. Fully quitting and reopening Discord — not just closing the window — usually forces a refresh. If they still aren't there after ten minutes, check that the bot was added with the applications.commands scope; re-running the invite link fixes it without removing anything.
It says it can't read a channel I can read
That's the bot's own permissions, not yours. Run /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
Almost always a timezone. Until you set one with /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
Three possibilities: the range was narrower than you meant; everyone who spoke has used /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
Run /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
The usual causes, in order: recast buttons (each one is a new request), a high quality tier set in /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
Expected, and recoverable. A one-time purchase belongs to you until you choose which server it goes to. Run /usage in the server you want it in and apply it there. Nothing is lost in the meantime.
It's taking a long time
Large reads are genuinely slow — a 5,000-message server-wide sweep takes around 40 seconds. The bot shows live progress with message counts so you can tell it's working rather than stuck. If it's consistently slower than that, use a smaller range or a lower quality tier.

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

If you bring a problem to the support server, paste the whole footer line. It turns “a summary failed” into a specific request that can be looked at directly.

Credits and plans

SB-CREDIT-402This server needs more credits

The 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 safeguard

One 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 limit

Every 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 server

An 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 plan

Model 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 plan

Server-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 full

You'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 asks

Without 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 stop

The 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 paused

Calls 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 moment

Agent 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 channel

The 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 channel

You 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 channel

It 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 here

Posting 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 here

Agent 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 channel

The 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 Server

You 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 admins

An 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 channel

An 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 DM

Your 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 on

No 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 parse

The 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 timezone

Timezones 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 one

You 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 rejected

The 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 this

The 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 available

The 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 read

The 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 trouble

The 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 long

The provider didn't respond in time.

Try again, or use a smaller range for a faster result.

SB-PROV-451The model declined to summarize this

The 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 limited

The 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 it

The 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 valid

The 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 name

Preset names have to be unique.

Pick a different name, or delete the existing one with /preset delete.

SB-PRESET-404No preset with that name

It 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 more

It 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 end

This 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

Not in the support server, not anywhere. If a problem involves a key, say so and it'll be handled privately.

Billing transactions and refund requests have to go through Discord support, since Discord processes every payment — see how billing works.

Open the support server