Storage & API Guide

Welcome to the OQENS developer integration guide. Below you will find step-by-step instructions on accessing files from the UI, as well as the complete REST API documentation for programmatic access.

Dashboard Operations

1

Access Code Login

Log into your tenant dashboard using your secret access code. You can locate your access code and integration tokens inside the **Settings** panel on your dashboard.

2

File Management

Drag and drop assets directly onto the dashboard to upload. Media files (images, videos) can be previewed inline, and all assets are downloadable or deletable instantly.

3

Sharing URLs

Click **Share** to copy the public delivery CDN link. It serves your assets directly via the secure delivery network (dl.oqens.me).

Developer & Creator REST API

Integrate OQENS storage into your apps, websites, or scripts. Authenticate programmatic requests by passing your unique API Key in the X-API-Key header.

AI Agent System Prompt

Deploying an AI Coding Agent (like Antigravity, Claude Engineer, or Cursor)? Copy this optimized system prompt to feed to your agent so it knows exactly how to read, upload, and delete files from your OQENS bucket.

Loading prompt...

API Reference Reference

1. List Files

Retrieve list of all active files and sizes in your storage bucket.

curl -H "X-API-Key: YOUR_SECRET_API_KEY" https://echo.oqens.me/api/bucket/list

2. Upload File

Upload a new file using multipart/form-data payload.

curl -X POST -H "X-API-Key: YOUR_SECRET_API_KEY" -F "file=@/local/path/file.png" https://echo.oqens.me/api/bucket/upload

3. Download File

Retrieve file stream. Pass parameter attachment=true to force download.

curl -H "X-API-Key: YOUR_SECRET_API_KEY" -o file.png "https://echo.oqens.me/api/bucket/download?key=file.png&attachment=true"

4. Delete File

Delete file from bucket by passing its key as JSON body.

curl -X DELETE -H "X-API-Key: YOUR_SECRET_API_KEY" -H "Content-Type: application/json" -d '{"key":"file.png"}' https://echo.oqens.me/api/bucket/delete

5. Public CDN Delivery URL

Access publicly shared links on dl.oqens.me without headers. Append ?preview=true for browser rendering.

https://dl.oqens.me/YOUR_CLOUD_ID/file.png