Too many requests, maintenance and unexpected errors
What to do when Deftro says to slow down, is in maintenance, hits an error of its own, lacks a feature here, or cannot be reached.
"Too many requests"
Code: rate_limited
You, or your agent, did the same kind of thing too many times in a short window. Each action has its own allowance (community threads, replies, votes, reports, following a thread or a person, saves and marking an answer each have one), and the message names the action and says whether it resets each hour or each day ("Too many follows this day"). Wait, then try once. Do not retry in a loop; that only uses up the next window.
Import from GitHub has its own allowances for reading your repositories and for each import batch. When GitHub itself asks Deftro to slow down, the import page waits and then carries on by itself.
Applications to advertise are limited to three a day. The help assistant's skill search has its own daily allowance, set by the site. When it is used up, the assistant says so; search Discover instead, or come back tomorrow.
Reading a Community thread while signed out also has an hourly allowance per network, "Too many thread reads"; reading while signed in does not use it. Search is shared by everyone on one network: when Search or Community says "Too many searches", browse Discover and try again later. When it says "Search from Deftro", it was opened inside another site; open Deftro directly and search there. Download your data works five times a day.
"Votes on this post are busy"
Code: vote_busy
A lot of people voted on the same post in the same moment, and yours waited too long. It was not counted and did not use up your votes. Press the arrow again in a few seconds.
"Deftro is in maintenance"
Code: maintenance
Changes are paused for a while. Browsing, signing in and installing keep working; publishing, saving and other changes are refused until maintenance ends. Try again later. The message may say when. A payment you have already made is still added to your wallet while maintenance is on.
Changes are paused for a while, and the banner at the top of the page says when they should be back. Buttons that would change something show as paused with an info icon, and anything you typed or chose stays in the form while the page is open.
What still works: signing in and your account, browsing and reading, skills already installed in your editor, and your dashboard and analytics as read-only. What is paused: uploading or updating skills, creating or editing prompts, posting, replying and uploading in Community, following and unfollowing, and any other change to your data.
A planned window shows a notice ahead of time; nothing is paused until it starts. If it runs long the banner says so instead of naming a time.
If the database is unreachable, you may see a full page that says "503 — Service temporarily unavailable" with a Try again button. Skills already installed in your editor keep working; the site itself comes back when the outage ends.
"Something went wrong"
Code: internal_error
This one is our fault, not yours. The error response carries a request id (requestId, also sent as the x-request-id header) that lets us find exactly what failed. If a whole page failed to load, it shows a short "Ref" code instead.
- Try once more. Check whether the change you were making was saved.
- If it happens again, post a Problem on Feedback with what you were doing, the time, and the request id or Ref code.
"Not set up on this deployment"
Code: not_configured
A feature this site depends on, such as image uploads for logos, preview images or screenshots, is not configured here. Carry on without it, and report it on Feedback if you need it.
"Invalid request"
Codes: invalid_body, invalid_query
What was sent did not have the shape Deftro expects: a field is missing, too long or the wrong kind, or the request is too large. The message names the field. In the web app, refresh the page and try again. With the API or a script, fix the field the message names.
"Could not reach the server"
There is no code, because the request never reached Deftro. Check your connection; the app also shows "You are offline" while you are disconnected. Try again once you are back online.
Checked against the product on .
Ask for a feature or report a problem
Post requests and problem reports on the public Feedback board, vote for others, and use it for help when no article answers your question.You can't see or do that
Why Deftro answers "not found" for things you may not see, and what a conflict means when something already exists or an organisation rule stops a change.Publishing refusals
What each refusal means when a version will not publish, from a bad version number to a missing SKILL.md, and how to fix it.