Error Handling

All errors return a JSON object with an error field:

{
  "error": "not enough storage, please upgrade your plan"
}

Status codes

Code	Meaning	Common causes
400	Bad Request	Missing or invalid parameters, unsupported content type, invalid JSON body.
401	Unauthorized	Missing or invalid API key.
402	Payment Required	Storage limit exceeded — upgrade your plan or wait for monthly reset.
404	Not Found	File CID or user not found.
429	Too Many Requests	Gateway bandwidth limit exceeded — wait for monthly reset.
500	Internal Error	Unexpected server error — retry or contact support.