Errors and limits

Status codes, rate limits, expiry, and download-limit behavior.

Status codes

400Invalid request or upload parameters
401Authentication, password, or delete key required
403Forbidden, expired limit, or download limit reached
404Resource not found
410Resource expired
413Payload exceeds the endpoint limit
429Rate limited; retry after the supplied delay
500Unexpected server failure

JSON errors retain the existing error, message, and success fields. Public API errors also expose a stable code and request ID.

Limits and defaults

  • Direct single-file and legacy uploads: 100 MB.
  • Legacy /api/upload expiry ceiling: 30 days.
  • Current upload and multipart expiry ceiling: 3650 days.
  • maxDownloads=0 means unlimited and is stored as null on files/folders.
  • Short IDs are 10 characters; UUID IDs use the full UUID format.