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
}
}
}