API reference

Account

The account, its plan limits and the key's abilities.

Get the account

GET /v1/me

The account the key belongs to, the plan's limits and how much is used, and what the key can do. Any key can call it, so it's a good way to check a key works.

name, emailstring The account.
prefixstring The account's folder in every file link.
abilitiesstring[] What this key can do.
filesinteger Files in the library now.
limits.planstring free, standard or pro.
limits.max_upload_mbinteger The largest file through POST /files.
limits.max_expiry_daysinteger The furthest away an expiry can be.
limits.files_always_expireboolean True on the free plan, where every file gets an expiry.
limits.uploads_limit, uploads_remaininginteger | null On the free plan, the total number of uploads and how many are left.
limits.storage_mb, storage_used_mbnumber | null Storage allowed (null when unlimited) and used.
limits.file_typesstring[] Extensions that can be uploaded.
limits.max_link_ttl_daysinteger The longest a private file's link can last.
$ curl https://drop.media/api/v1/me -H "Authorization: Bearer YOUR_API_KEY"
Response
{
    "data": {
        "name": "Acme Studio",
        "email": "ops@acme.example",
        "prefix": "acme",
        "abilities": [
            "files:read",
            "files:write"
        ],
        "files": 214,
        "limits": {
            "plan": "standard",
            "max_upload_mb": 100,
            "max_expiry_days": 365,
            "files_always_expire": false,
            "uploads_limit": null,
            "uploads_remaining": null,
            "storage_mb": 10240,
            "storage_used_mb": 1832.4,
            "file_types": [
                "png",
                "jpg",
                "gif",
                "webp",
                "svg",
                "pdf",
                "mp4",
                "\u2026"
            ],
            "max_link_ttl_days": 7
        }
    }
}