← Back to Home

API Documentation

How to use Vortex API for file hosting

Upload Files

Upload files to Vortex using a POST request to the upload endpoint.

POST /api/upload
Content-Type: multipart/form-data

Example (cURL)

curl -X POST \
  -F "file=@/path/to/your/image.png" \
  https://vortexcheatz.win/api/upload

Response

{
  "id": "uuid-here",
  "filename": "uuid.png",
  "originalName": "image.png",
  "size": 1024,
  "uploadedAt": "2025-10-21T...",
  "url": "/api/files/uuid.png"
}

Discord Bot Integration

Upload images from Discord bot and get shareable links.

Node.js Example

const FormData = require('form-data');
const fetch = require('node-fetch');

async function uploadToVortex(fileBuffer, filename) {
  const formData = new FormData();
  formData.append('file', fileBuffer, filename);
  
  const response = await fetch('https://vortexcheatz.win/api/upload', {
    method: 'POST',
    body: formData
  });
  
  const result = await response.json();
  return `https://vortexcheatz.win${result.url}`;
}

client.on('messageCreate', async (message) => {
  if (message.attachments.size > 0) {
    const attachment = message.attachments.first();
    const response = await fetch(attachment.url);
    const buffer = await response.buffer();
    
    const hostedUrl = await uploadToVortex(buffer, attachment.name);
    message.reply(`Hosted: ${hostedUrl}`);
  }
});

Python Integration

Python Example

import requests

def upload_to_vortex(file_path):
    url = "https://vortexcheatz.win/api/upload"
    
    with open(file_path, 'rb') as file:
        files = {'file': file}
        response = requests.post(url, files=files)
        
    if response.status_code == 200:
        data = response.json()
        return f"https://vortexcheatz.win{data['url']}"
    else:
        raise Exception(f"Upload failed: {response.text}")

# Usage
hosted_url = upload_to_vortex("image.png")
print(f"File hosted at: {hosted_url}")

Access Files

Access uploaded files using the direct link.

GET /api/files/[filename]

Example

https://vortexcheatz.win/api/files/uuid.png

Limits & Guidelines

• Maximum file size: 25 MB

• No authentication required (for now)

• Files are stored permanently until manually deleted

• Please don't abuse the service

• Inappropriate content will be removed

Error Handling

Common Errors

400 - No file provided
Make sure to include a file in your request
400 - File too large
File exceeds the 25MB limit
404 - File not found
The requested file doesn't exist