// HTTP 400

The input is not valid

invalid_input: One or more inputs are missing or not valid.

What to do

Fix the fields listed under "problems" and send the request again. Each tool page lists its inputs with examples.

Sending the same request again will give the same answer. Change the request first.

Common causes

  • A required input was left out.
  • An input has the wrong type, for example text where a number is expected.
  • An input name is misspelt.
  • The content itself could not be read, for example JSON with a missing bracket.

What the response looks like

{
  "error": {
    "code": "invalid_input",
    "message": "One or more inputs are missing or not valid.",
    "fix": "Fix the fields listed under \"problems\" and send the request again. Each tool page lists its inputs with examples.",
    "retryable": false,
    "docs": "https://setget.net/errors/invalid_input"
  }
}

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

CodeHTTPMeaningWhat 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.