v1.0.0 API Docs

Image Bucket Service

Fast, persistent image storage and CDN endpoint for apps, web frontends, and LLMs.

POST /upload.php

Uploads an image file to the bucket and returns the persistent public HTTPS URL.

Parameter Type Required Description
image (or file) File (Binary) Yes Image file (.jpg, .png, .webp, .gif, .svg, .ico). Max 15MB.
folder String No Custom category folder (e.g. avatars, tattoos). Defaults to YYYY/MM.

Code Examples:

cURL
Node.js / JS
Python
curl -X POST https://images.tegegn.com.et/upload.php \
  -F "image=@/path/to/image.jpg" \
  -F "folder=tattoos"
const formData = new FormData();
formData.append('image', file);
formData.append('folder', 'tattoos');

const res = await fetch('https://images.tegegn.com.et/upload.php', {
  method: 'POST',
  body: formData
});
const data = await res.json();
console.log(data.data.url); // "https://images.tegegn.com.et/uploads/tattoos/..."
import requests

files = {'image': open('my_image.jpg', 'rb')}
data = {'folder': 'tattoos'}

response = requests.post('https://images.tegegn.com.et/upload.php', files=files, data=data)
print(response.json()['data']['url'])

Response (201 Created):

{
  "success": true,
  "data": {
    "url": "https://images.tegegn.com.et/uploads/tattoos/1726754000_photo_a1b2c3d4.jpg",
    "relative_path": "uploads/tattoos/1726754000_photo_a1b2c3d4.jpg",
    "filename": "1726754000_photo_a1b2c3d4.jpg",
    "original_name": "photo.jpg",
    "size_bytes": 142050,
    "mime_type": "image/jpeg",
    "extension": "jpg",
    "uploaded_at": "2026-09-19T13:48:00+00:00"
  }
}
POST / DELETE /delete.php

Permanently deletes an image from disk using its URL or relative path.

Parameter Type Required Description
url String Yes The full public image URL or relative path to delete.
curl -X POST https://images.tegegn.com.et/delete.php \
  -H "Content-Type: application/json" \
  -d '{"url": "https://images.tegegn.com.et/uploads/tattoos/1726754000_photo_a1b2c3d4.jpg"}'

๐Ÿงช Live Upload Sandbox

Test the upload endpoint directly from your browser:

Uploaded image