// when something goes wrong
Error codes
Every error says what happened, why, and what to do next. The code is stable and safe to branch on; the message is written for a person to read.
Codes
| Code | HTTP | Meaning | What to do |
|---|---|---|---|
unknown_tool |
404 | No tool has that name | Check the spelling, or search the catalogue at https://setget.net/tools or GET /v1/tools/search?q=... |
invalid_input |
400 | The input is not valid | Fix the fields listed under "problems" and send the request again. Each tool page lists its inputs with examples. |
tool_timeout |
422 | The tool took too long | Try a smaller input, or a simpler pattern or expression. |
tool_memory |
422 | The tool ran out of memory | Try a smaller input, or split it into parts and process each part separately. |
output_too_large |
422 | The result is too large to return | Ask for less output, for example fewer items or a smaller count, or split the input. |
tool_busy |
503 | All tool workers are busy | Wait a second and try again. Nothing was changed, so retrying is safe. |
tool_disabled |
503 | This tool is switched off | Try again later, or look for a related tool at https://setget.net/tools. |
tool_failed |
500 | The tool hit an unexpected problem | Try again. If it keeps happening, send the request_id to https://setget.net/feedback so we can find the cause. |
tool_daily_limit |
429 | Daily tool limit reached | Wait for the limit to reset. The message says when that is. |
storage_off |
503 | File tools are not switched on | Use the tools that work on text input for now, or try again later. |
storage_unavailable |
503 | File storage is temporarily unavailable | Try again in a few seconds. Uploads that already finished are not affected. |
file_too_large |
413 | The file is too large | Make the file smaller first, for example by compressing or trimming it, then upload it again. |
too_many_files |
400 | Too many files | Split the files across more than one drop, or zip them into one file first. |
file_not_found |
404 | That file reference does not point at a file | Use the "ref" value returned when the file was uploaded, for example "DROP_ID/f1". Files expire, so upload it again if it is gone. |
upload_incomplete |
409 | The upload has not arrived yet | Send the file to its upload URL with PUT first, then try again. |
file_refused |
422 | This kind of file is not accepted | Upload documents, images, audio, video, archives or text instead. |
unsupported_file |
422 | This tool cannot read that file | Check the tool page for the file types it accepts, and convert the file first if needed. |
upload_daily_limit |
429 | Daily upload limit reached | Wait for the limit to reset. The message says when that is. |
job_not_found |
404 | No job has that ID | Check the ID. Jobs and their results expire, so run the tool again if it is gone. |
job_daily_limit |
429 | Daily job limit reached | Wait for the limit to reset. The message says when that is. |
too_many_jobs |
429 | Too many jobs waiting | Wait for one of your jobs to finish, or cancel one, then try again. |
jobs_paused |
503 | File jobs are paused | Try again later. Tools that work on text input are not affected. |
job_timeout |
422 | The job took too long | Try a smaller or shorter file, or ask for smaller output. |
job_out_of_memory |
422 | The job ran out of memory | Try a smaller file. For images, reduce the pixel dimensions first. |
job_output_too_large |
422 | The result is too large | Ask for smaller output, for example lower quality, smaller dimensions or fewer files. |
worker_lost |
503 | The worker stopped unexpectedly | Run the tool again. If it fails the same way, the file itself may be triggering the problem. |
job_cancelled |
409 | The job was cancelled | Run the tool again if you still need the result. |
job_failed |
500 | The job hit an unexpected problem | Try again. If it keeps happening, send the job ID to https://setget.net/feedback so we can find the cause. |
tool_unavailable |
503 | This tool is not available on this server | Try again later, or look for a related tool at https://setget.net/tools. |
invalid_json |
400 | The request body is not valid JSON | Send a JSON object, for example {"input": {"text": "hello"}}, with Content-Type: application/json. |
too_large |
413 | The request is too large | Send a smaller request. For big files, upload the file and pass a reference instead of the content. |
rate_limited |
429 | Too many requests | Slow down and try again after the number of seconds in the Retry-After header. |
daily_limit |
429 | Daily write limit reached | Wait until tomorrow, or reduce how often you write. Reading is not affected. |
not_found |
404 | Nothing is stored there | Check the name. Everything on SetGet expires, so create it again if it is gone. |
forbidden |
403 | This credential does not allow that | Use the write token for changes, or the password the key was protected with. |
unavailable |
503 | Storage is temporarily unavailable | Try again shortly. For a write, check the current state first so the change is not applied twice. |
Older routes (/set, /get) and some storage errors use codes that are not listed here yet; their messages are described in the errors and limits section of the docs.