Dumpt Developer API

Simple, powerful file sharing API for developers. Perfect for CI/CD artifacts, temporary data sharing, and quick file transfers.

Endpoints

Max Files

Max Size

1GB

Max Hours

POST /api/quick-dump

Upload

Create a new dump with files and/or text. Super simple one-liner uploads.

Parameters

files(File[]) - Files to upload (max 10)

text(string, optional) - Text message

password(string, optional) - Password protection

hours(number, optional) - Expiration (1-24, default: 24)

Code Examples

cURL Example

# Upload files with text
curl -X POST https://dum.pt/api/quick-dump \
  -F "files=@build.zip" \
  -F "files=@config.json" \
  -F "text=Build #123 artifacts" \
  -F "hours=12"

# Upload with password protection
curl -X POST https://dum.pt/api/quick-dump \
  -F "files=@sensitive-data.txt" \
  -F "password=secret123" \
  -F "hours=2"

Response

Success Response

{
  "success": true,
  "dump": {
    "id": "217341ff-2f61-4c5e-9df2-3f2d744ac190",
    "url": "/dump/217341ff-2f61-4c5e-9df2-3f2d744ac190",
    "rawUrl": "/api/raw/217341ff-2f61-4c5e-9df2-3f2d744ac190",
    "downloadUrl": "/api/download/217341ff-2f61-4c5e-9df2-3f2d744ac190",
    "createdAt": "2025-01-01T00:00:00Z",
    "expiresAt": "2025-01-01T12:00:00Z",
    "hasPassword": false,
    "fileCount": 2,
    "hasText": true
  }
}

GET /api/raw/{dumpId}

JSON

Get dump data as JSON. Includes files, text, metadata, and zip file URLs.

Query Parameters

password(string, optional) - Required if dump is password-protected

Code Examples

cURL Example

# Get full dump data
curl "https://dum.pt/api/raw/abc123..."

# With password
curl "https://dum.pt/api/raw/abc123...?password=secret123"

Response

JSON Response

{
  "id": "217341ff-2f61-4c5e-9df2-3f2d744ac190",
  "text": "Build #123 artifacts",
  "files": [
    {
      "originalName": "build.zip",
      "url": "https://blob.vercel-storage.com/...",
      "size": 1024000,
      "type": "application/zip"
    },
    {
      "originalName": "config.json",
      "url": "https://blob.vercel-storage.com/...",
      "size": 512,
      "type": "application/json"
    }
  ],
  "zipFile": "https://blob.vercel-storage.com/...",
  "createdAt": "2025-01-01T00:00:00Z",
  "expiresAt": "2025-01-01T12:00:00Z",
  "hasPassword": false
}

GET /api/download/{dumpId}

Download

Download files directly. Smart redirects: single file → direct URL, multiple files → zip.

Query Parameters

password(string, optional) - Required if dump is password-protected

file(string, optional) - Download specific file by name

zip(boolean, optional) - Force zip download

Code Examples

cURL Example

# Download all files (auto-zip if multiple)
wget https://dum.pt/api/download/abc123...

# Download specific file
wget "https://dum.pt/api/download/abc123...?file=config.json"

# Download with password
wget "https://dum.pt/api/download/abc123...?password=secret123"

Response

Single file: Redirects to direct file URL (302)

Multiple files: Redirects to zip file URL (302)

Error: Returns JSON error response (4xx/5xx)

GET /api/text/{dumpId}

Text

Get just the text content from a dump. Returns plain text by default, JSON with ?format=json.

Query Parameters

password(string, optional) - Required if dump is password-protected

format(string, optional) - Set to "json" for JSON response

Code Examples

cURL Example

# Get plain text
curl "https://dum.pt/api/text/abc123..."

# Get text as JSON
curl "https://dum.pt/api/text/abc123...?format=json"

# Get text with password
curl "https://dum.pt/api/text/abc123...?password=secret123"

Response

Plain Text (default):

Plain Text Response

Build #123 artifacts

This is the text content from the dump.

JSON format (?format=json):

JSON Response

{
  "text": "Build #123 artifacts\n\nThis is the text content from the dump.",
  "id": "217341ff-2f61-4c5e-9df2-3f2d744ac190",
  "createdAt": "2025-01-01T00:00:00Z",
  "expiresAt": "2025-01-01T12:00:00Z"
}

Error Handling

Common error responses and status codes

Status Codes

400Bad request

401Password required / Invalid password

404Dump not found / Tunnel not found

410Dump expired / Tunnel expired

500Server error

Error Response

Error Example

{
  "error": "Password required for this tunnel"
}

Tunnel Error Messages

"Password required for this tunnel" - Missing Authorization header

"Invalid password" - Wrong password provided

"Tunnel not found" - Invalid tunnel ID

"Tunnel has expired" - Tunnel older than 25 seconds

Built with ❤️ for developers who need simple file sharing

← Back to Dumpt