// HTTP 429
Too many jobs waiting
too_many_jobs: You already have the maximum number of jobs waiting or running.
What to do
Wait for one of your jobs to finish, or cancel one, then try again.
Sending the same request again is safe and may succeed.
Common causes
- Jobs were submitted faster than they finish.
What the response looks like
{
"error": {
"code": "too_many_jobs",
"message": "You already have the maximum number of jobs waiting or running.",
"fix": "Wait for one of your jobs to finish, or cancel one, then try again.",
"retryable": true,
"docs": "https://setget.net/errors/too_many_jobs"
}
}
message often has more detail than shown here, such as the exact field, line or limit involved. fix says what to do next and retryable says whether trying again unchanged can help.
All error 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.