Common API Errors

Null Drop uses standard HTTP response codes to indicate the success or failure of an API request.

Error Code Reference

401 Unauthorized

  • Cause: Your API key is missing, invalid, or has been revoked.
  • Solution: Check your API Keys dashboard to verify your token. Ensure it is passed in the Authorization: Bearer <key> header.

403 Forbidden

  • Cause: You are attempting to access a resource (like a specific bucket or upload) that your account does not have permissions for.
  • Solution: Verify the ownership and sharing settings of the target resource.

404 Not Found

  • Cause: The requested file, library item, or endpoint does not exist.
  • Solution: Double-check the ID or the API path (e.g., /library vs /uploads).

413 Payload Too Large

  • Cause: The file you are trying to upload exceeds your current account tier limit.
  • Solution: Check Storage and Limits for your quota. You may need to upgrade via Null Pass.

429 Too Many Requests

  • Cause: You have exceeded the rate limit for your tier (typically 100 requests per minute for Pro).
  • Solution: Implement exponential backoff in your integration or upgrade your tier for higher limits.