OV
Developer Tools

API Documentation

Integrate with the Omniscient Vault programmatically. All endpoints return JSON responses unless retrieving raw files.

Base URL

https://yourdomain.com

All API endpoints are relative to this base URL. No authentication is required for uploads.

Overview

The Omniscient Vault API provides 4 endpoints for file management:

  • 1.File Upload — Upload files via multipart form-data
  • 2.URL Upload — Upload files from remote URLs
  • 3.Delete Files — Remove uploaded files by filename
  • 4.Retrieve File — Get raw file content by filename

Limits

Max File Size

200 MB

URL Timeout

30 seconds

Supported

All file types

Endpoints

Quick Examples

Upload a file with cURL

bash
curl -F "[email protected]" https://yourdomain.com/api/upload

Upload from URL with cURL

bash
curl -X POST https://yourdomain.com/api/upload-url \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/image.png"}'

Upload with JavaScript (fetch)

javascript
const formData = new FormData();
formData.append("file", fileInput.files[0]);

const res = await fetch("https://yourdomain.com/api/upload", {
  method: "POST",
  body: formData,
});

const data = await res.json();
console.log(data.url); // Direct link to file

Upload with Python (requests)

python
import requests

with open("photo.jpg", "rb") as f:
    res = requests.post(
        "https://yourdomain.com/api/upload",
        files={"file": f}
    )

print(res.json()["url"])

Delete files with cURL

bash
curl -X POST https://yourdomain.com/api/delete \
  -H "Content-Type: application/json" \
  -d '{"files": "a1b2c3d4.png e5f6g7h8.jpg"}'