Fast, persistent image storage and CDN endpoint for apps, web frontends, and LLMs.
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. |
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'])
{
"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"
}
}
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"}'