API Documentation

The Null Drop API allows you to programmatically manage your library, automate uploads, and integrate file sharing into your own applications.

Overview

• Base URL: https://nulldrop.xyz/api/v1
• Authentication: Bearer token via Authorization header.

Authentication

All API requests require an API key, which can be generated in your API Keys dashboard. Pass this key in the header of every request:

Authorization: Bearer <your_api_key>

---

v1 Endpoints

Upload a File

POST /upload

Uploads a raw file to Null Drop storage. This endpoint requires multipart/form-data.

Body Parameters:

• file: The binary file content (Required).

Response:

{
  "id": "file_abc123",
  "name": "document.pdf",
  "url": "https://nulldrop.xyz/f/abc123",
  "status": "success"
}

List Your Files

GET /files

Returns a list of all files in your library.

Response:

{
  "files": [
    {
      "id": "file_1",
      "name": "image.png",
      "size": 1024
    }
  ]
}

Get File Details

GET /files/{id}

Retrieves metadata for a specific file by its unique identifier.

Delete a File

DELETE /files/{id}

Permanently removes a file from your library and storage.

---

v2 Endpoints

For high-volume operations, bulk uploads, and advanced management, we offer the Null Drop API v2. This version supports:

• POST /bulk-upload
• DEL /bulk-delete
• Advanced search and filtering via metadata.

Full technical specifications for v2 are available in the Developer Portal.