Naslag

REST API

Upload bestanden, maak collecties en beheer shares via HTTP. Alle antwoorden zijn JSON; voor anonieme uploads is geen API-sleutel vereist.

Basis-URLhttps://storage.to/api

33 endpoints · JSON

Hoe uploads werken

De storage.to API vormt de basis voor onze CLI, desktopapp, web-uploader en elke third-party client die je wilt bouwen. Het uploadproces bestaat uit drie stappen:

01 · POST /upload/init

Init

laat ons weten dat je een bestand wilt uploaden. We retourneren één of meer presigned URL's die naar onze opslag-edge wijzen.

02 · PUT {upload_url}

Upload

PUT je bytes direct naar de presigned URL(s). Bytes gaan niet via onze servers.

03 · POST /upload/confirm

Bevestigen

laat ons weten dat de upload klaar is. We maken een File-record en geven je een deelbare URL.

Alle endpoints hieronder zijn relatief aan deze basis. Voorbeeld: POST /upload/init betekent POST https://storage.to/api/upload/init.

Authenticatie

Anonieme uploads werken zonder authenticatie, maar met strikte limieten. Aanroepen zonder sleutel zijn beperkt tot 50 bestanden per doorlopende 24 uur per apparaat of IP, plus de bandbreedtequota hieronder, en bestanden verlopen na 3 dagen.

Authenticeren met een gratis account ontgrendelt:

Geen dagelijkse bestandslimiet
Geen uploadbandbreedtequotum
Uploads gekoppeld aan je account (zichtbaar op /dashboard)
Premiumfuncties (permanente bestanden, meer opslag)
Mutaties op basis van eigendom (verwijderen, wachtwoord instellen, vervaldatum wijzigen) zonder dat je de visitor-token match nodig hebt

Limieten in één oogopslag

Zonder token (anoniem)

Token van gratis account

Token van betaald account

Bestanden per dag

50 / 24 uur

Onbeperkt

Uploadbandbreedte

100 GB / 24 uur (500 GB per IP)

Onbeperkt

Maximale bestandsgrootte

25 GB

100 GB

Vervaldatum bestand

Standaard 3 dagen, tot 7 via expiry_days

Nooit (bestanden zijn permanent)

Opslagruimte

Geen (bestanden verlopen)

100 GB - 1 TB permanent, per abonnement

Bekijk plannen →

Er zijn geen maandelijkse quota - alle limieten zijn voortschrijdende 24-uursvensters of limieten per minuut. Het gratis abonnement heeft geen vaste opslagruimte: elk bestand verloopt vanzelf, dus er stapelt zich niets op tegen een quotum.

Om te authenticeren, genereer je een persoonlijk API-token vanuit je account en stuur je dit als bearer token bij elke aanvraag: Je moet ingelogd zijn. Het volledige token wordt alleen één keer getoond bij het aanmaken, dus kopieer het naar een veilige plek. Je kunt een token op elk moment intrekken vanaf dezelfde pagina. Genereer API-token →

Authorization: Bearer <token>

Eigenaarschap bewijzen

Eigenaars-tokenAanbevolen

Elk endpoint dat een resource aanmaakt (/upload/init multipart, /upload/confirm, /file/reserve, /collection) retourneert een owner_token in zijn antwoord. De token is een ondertekend bewijs van eigendom dat gekoppeld is aan die specifieke resource, onafhankelijk van je IP of bezoeker-token. Tokens bestaan zolang de resource bestaat, zijn veilig om op te slaan en verlopen niet onafhankelijk. Een verloren token betekent dat je de controle over die resource (bestand/collectie/upload) verliest — behandel ze als lokale wachtwoorden.

Authorization: Owner <token>
# of, naast een Bearer-sessie
X-Owner-Token: <token>

Bezoekerstoken

Anonieme clients hebben een manier nodig om eigenaarschap van hun eigen uploads te bewijzen zonder account. We gebruiken een visitor token - een willekeurige tekenreeks die de client één keer genereert en daarna hergebruikt. Stuur deze mee met elke request: Op het web wordt de token automatisch opgeslagen in de visitor_token-cookie. De CLI slaat deze op op ~/.config/storageto/token (zie CLI-documentatie).

X-Visitor-Token: <random-string>

Voor mutatie-endpoints (verwijderen, wachtwoord instellen, vervaldatum wijzigen) wordt eigendom bevestigd als of de bezoeker-token overeenkomt met of het verzoek afkomstig is van hetzelfde IP dat het bestand heeft aangemaakt. Beide kunnen verloren gaan (cookies gewist, netwerkwijzigingen). De owner-token is het voorkeursbewijs voor de toekomst.

Fouten

Fouten volgen een consistent patroon: { "success": false, "error": "…" }

200OK.

201Aangemaakt.

400Slecht verzoek (bijv. limiet voor collectiegrootte overschreden).

401Wachtwoord vereist of onjuist.

403Niet geautoriseerd (niet de eigenaar van de resource).

404Resource niet gevonden of verlopen.

422Validatie mislukt, of beperking door abonnement/quota.

429Snelheidslimiet bereikt of uploadquota overschreden.

500Serverfout. Controleer status.

Snelheidslimieten

Alle snelheidslimieten zijn per IP. Een 429-antwoord bevat de standaard Retry-After-, X-RateLimit-Limit- en X-RateLimit-Remaining-headers.

Upload initialiseren / bevestigen / afbreken60 / minuut

Multipart voltooiing500 / minuut

Multipart part-URL's120 / minuut

Batch initialiseren / bevestigen500 / minuut

Status-polls (bestand & collectie)120 / minuut

Instellingen (wachtwoord, vervaldatum, max-downloads)30 / minuut

Wachtwoordverificatie10 / minuut

Collectie aanmaken30 / minuut

Beheren (klaarzetten, verwijderen)60 / minuut

Thumbnail uploaden120 / minuut

ShareX uploaden20 / dag

App-analytics / fouten120 en 60 / minuut

Uploadquota: anonieme clients hebben twee limieten tegelijk actief - 100 GB / 24 u per visitor token en 500 GB / 24 u per IP (de IP-limiet vangt verkeer zonder token en gedeelde netwerken). Zodra één van beide wordt overschreden krijg je een 429 met details. Dit is alleen een upload-quota - downloads zijn onbeperkt en niet beperkt.

Upload

8 endpoints

De uploadflow in drie stappen voor elk bestand, inclusief bestanden groter dan 5 GB (automatisch multipart). Als je alleen een snelle upload in screenshot-stijl nodig hebt, kijk dan in plaats daarvan naar ShareX.

POST/upload/init60/min

Start een upload. Voor bestanden >50 MB is het antwoord een multipart-upload (type: "multipart"-veld); anders een enkele presigned PUT.

Request body

Veld	Type	Beschrijving
`filename`	string · required	Originele bestandsnaam. Maximaal 255 tekens.
`content_type`	string · required	MIME-type.
`size`	integer · required	Bestandsgrootte in bytes. Minimaal 1.

Request

curl -X POST https://storage.to/api/upload/init \
  -H "Content-Type: application/json" \
  -H "X-Visitor-Token: abc123" \
  -d '{
    "filename": "report.pdf",
    "content_type": "application/pdf",
    "size": 2202009
  }'

Response · single upload

{
  "success": true,
  "type": "single",
  "upload_url": "https://r2.cloudflarestorage.com/...signed...",
  "headers": { "Host": ["..."] },
  "r2_key": "uuid-abc123"
}

Response · multipart

{
  "success": true,
  "type": "multipart",
  "upload_id": "01HXYZ...",
  "r2_key": "uuid-abc123",
  "part_size": 33554432,
  "total_parts": 4,
  "initial_urls": {
    "1": "https://...",
    "2": "https://..."
  },
  "owner_token": "owner_v1_..."
}

POST/upload/partsAlleen eigenaar120/min

Vraag extra URL's op voor een multipart-upload die nog bezig is. Wordt gebruikt wanneer /init minder URL's teruggeeft dan je hebt (of wanneer ze zijn verlopen).

Request body

Veld	Type	Beschrijving
`upload_id`	string · required	De `upload_id` uit `/init`.
`part_numbers`	array<int> · required	Partijnummers waarvoor je URL's wilt ophalen.

Request

curl -X POST https://storage.to/api/upload/parts \
  -H "Content-Type: application/json" \
  -d '{
    "upload_id": "01HXYZ...",
    "part_numbers": [3, 4]
  }'

Response

{
  "success": true,
  "part_urls": [
    { "partNumber": 3, "url": "https://..." },
    { "partNumber": 4, "url": "https://..." }
  ]
}

POST/upload/complete-multipartAlleen eigenaar500/min

Rond een multipart-upload af zodra alle delen zijn geüpload.

Request body

Veld	Type	Beschrijving
`upload_id`	string · required	De `upload_id` uit `/init`.
`parts`	array · required	Elke entry: `{ partNumber, etag }` uit de respons van de deel-upload.

Request

curl -X POST https://storage.to/api/upload/complete-multipart \
  -H "Content-Type: application/json" \
  -d '{
    "upload_id": "01HXYZ...",
    "parts": [
      { "partNumber": 1, "etag": "\"abc...\"" },
      { "partNumber": 2, "etag": "\"def...\"" }
    ]
  }'

Response

{ "success": true }

POST/upload/abortAlleen eigenaar60/min

Annuleer een multipart-upload en ruim eventuele gedeeltelijke data op.

Request body

Veld	Type	Beschrijving
`upload_id`	string · required	De upload die moet worden afgebroken.

Request

curl -X POST https://storage.to/api/upload/abort \
  -H "Content-Type: application/json" \
  -d '{ "upload_id": "01HXYZ..." }'

POST/upload/confirm60/min

Bevestig dat de upload is voltooid. Dit is wanneer we het File-record aanmaken en de deelbare URL teruggeven.

Request body

Veld	Type	Beschrijving
`filename`	string · required	Originele bestandsnaam.
`size`	integer · required	Bestandsgrootte in bytes.
`content_type`	string · required	MIME-type.
`r2_key`	string · required	De `r2_key` uit `/init`.
`collection_id`	string · optional	Koppel aan een collectie.
`crc32`	integer · optional	CRC32-checksum voor integriteitscontrole.
`file_id`	string(9) · optional	Voldoe een eerder gereserveerd file-ID.

Request

curl -X POST https://storage.to/api/upload/confirm \
  -H "Content-Type: application/json" \
  -H "X-Visitor-Token: abc123" \
  -d '{
    "filename": "report.pdf",
    "size": 2202009,
    "content_type": "application/pdf",
    "r2_key": "uuid-abc123"
  }'

Response

{
  "success": true,
  "file": {
    "id": "FQxyz1234",
    "url": "https://storage.to/FQxyz1234",
    "filename": "report.pdf",
    "size": 2202009,
    "human_size": "2.1 MB",
    "expires_at": "2026-04-15T12:00:00Z"
  },
  "owner_token": "owner_v1_..."
}

POST/file/reserve60/min

Reserveer een file-ID en deelbare URL voor de bytes klaar zijn. Handig wanneer je eerst een link wilt doorgeven en de upload daarna wilt afronden. Eigendom is gekoppeld aan je visitor-token + IP. Rond de upload later af met /upload/init + /upload/confirm en geef file_id door om te bevestigen.

Request body

Veld	Type	Beschrijving
`filename`	string · optional	Placeholder-bestandsnaam. Standaard: `"Pending"`.
`content_type`	string · optional	Placeholder MIME-type.

Request

curl -X POST https://storage.to/api/file/reserve \
  -H "X-Visitor-Token: abc123"

Response

{
  "success": true,
  "file": {
    "id": "FQxyz1234",
    "url": "https://storage.to/FQxyz1234",
    "expires_at": "2026-04-12T18:00:00Z"
  },
  "owner_token": "owner_v1_..."
}

POST/upload/init-batch500/min

Batch-equivalent van /upload/init, geoptimaliseerd voor de web-uploader. Start tot 250 bestanden in één round-trip.

Wordt intern gebruikt door de web-uploader. De meeste clients moeten de voorkeur geven aan single-file /upload/init.

POST/upload/confirm-batch500/min

Batch-equivalent van /upload/confirm. Bevestigt veel bestanden in één round-trip.

Collecties

9 endpoints

Een collectie groepeert meerdere bestanden onder één deelbare URL (/c/{id}). Tot 10.000 bestanden en 25 GB totaal.

POST/collection30/min

Maak een nieuwe collectie. Koppel bestanden achteraf door collection_id door te geven op /upload/confirm.

Request body

Veld	Type	Beschrijving
`expected_file_count`	integer · optional	Tip voor automatisch markeren van de collectie als klaar zodra alle verwachte bestanden zijn bevestigd.

Request

curl -X POST https://storage.to/api/collection \
  -H "Content-Type: application/json" \
  -H "X-Visitor-Token: abc123" \
  -d '{ "expected_file_count": 3 }'

Response

{
  "success": true,
  "collection": {
    "id": "ABC123xyz",
    "url": "https://storage.to/c/ABC123xyz",
    "expires_at": "2026-04-15T12:00:00Z"
  },
  "owner_token": "owner_v1_..."
}

GET/collection/{id}/status120/min

Controleer de status van een collectie. Markeert de collectie ook automatisch als klaar als alle verwachte bestanden zijn bevestigd.

Request

curl https://storage.to/api/collection/ABC123xyz/status

Response

{
  "success": true,
  "files": [
    /* file objects: id, url, filename, size, ... */
  ],
  "is_uploading": false,
  "file_count": 3,
  "expected_file_count": 3,
  "total_size": 6291456,
  "human_total_size": "6 MB"
}

POST/collection/{id}/readyAlleen eigenaar60/min

Markeer de collectie als klaar om te downloaden. Meestal niet nodig — collecties worden automatisch klaar zodra expected_file_count is bereikt.

DELETE/collection/{id}Alleen eigenaar60/min

Verwijder een collectie en al haar bestanden.

POST/collection/{id}/passwordAlleen eigenaar30/min

Stel een wachtwoord in voor de collectie. Vereist 4–100 tekens.

Request body

Veld	Type	Beschrijving
`password`	string · required	4–100 tekens.

Request

curl -X POST https://storage.to/api/collection/ABC123xyz/password \
  -H "X-Visitor-Token: abc123" \
  -d '{ "password": "hunter22" }'

DELETE/collection/{id}/passwordAlleen eigenaar30/min

Verwijder het wachtwoord uit een collectie.

POST/collection/{id}/verify-password10/min

Controleer een wachtwoord. Geeft 200 terug bij succes, 401 bij een onjuist wachtwoord.

Request body

Veld	Type	Beschrijving
`password`	string · required

POST/collection/{id}/expiryAlleen eigenaarPermanent: betaald30/min

Wijzig de vervaldatum van een collectie.

Request body

Veld	Type	Beschrijving
`days`	integer · optional	Over 1–7 dagen, maar nooit later dan 7 dagen na de upload (of de huidige vervaldatum, als die later is). Weglaten of `null` voor permanent (alleen premium).

POST/collection/{id}/max-downloadsAlleen eigenaar30/min

Stel een downloadlimiet in (burn-after-N-downloads). De collectie wordt automatisch verwijderd zodra de limiet is bereikt.

Request body

Veld	Type	Beschrijving
`max_downloads`	integer · optional	1–1000. Moet hoger zijn dan het huidige aantal downloads. `null` om de limiet te verwijderen.

Bestanden

8 endpoints

Alle instellingen op bestandsniveau (wachtwoord, vervaldatum, max-downloads) spiegelen de collectie-endpoints. Alleen voor de eigenaar.

GET/file/{id}/status120/min

Controleer of een bestand nog wacht op de upload.

Response

{ "pending": false }

DELETE/file/{id}Alleen eigenaar60/min

Verwijder een bestand direct.

POST/file/{id}/thumbnailAlleen eigenaar120/min

Upload een thumbnail-afbeelding voor een video- of afbeeldingsbestand (wordt gebruikt op de downloadpagina). Max 2 MB.

Request body

Veld	Type	Beschrijving
`thumbnail`	image · required	Multipart-upload. Max 2 MB.

Response

{
  "success": true,
  "thumbnail_url": "https://..."
}

POST/file/{id}/passwordAlleen eigenaar30/min

Stel een wachtwoord in voor een bestand. Vereist 4–100 tekens.

DELETE/file/{id}/passwordAlleen eigenaar30/min

Verwijder het wachtwoord van een bestand.

POST/file/{id}/verify-password10/min

Controleer het wachtwoord van een bestand.

POST/file/{id}/expiryAlleen eigenaarPermanent: betaald30/min

Wijzig de vervaldatum van een bestand.

Request body

Veld	Type	Beschrijving
`days`	integer · optional	Over 1–7 dagen, maar nooit later dan 7 dagen na de upload (of de huidige vervaldatum, als die later is). Weglaten of `null` voor permanent (alleen premium).

POST/file/{id}/max-downloadsAlleen eigenaar30/min

Beperk het totale aantal downloads van een bestand. Wordt automatisch verwijderd zodra de limiet is bereikt.

ShareX uploaden

1 endpoint

One-shot upload-endpoint — stuur een multipart-bestand en je krijgt een deelbare URL terug. Geen gedoe met init/confirm. Ideaal voor screenshot-tools. Volledige setup-gids op /docs/sharex.

POST/sharex/upload20/day

Upload een afbeelding of bestand direct (multipart-formulier, file-veld). Max 25 MB.

Request

curl -X POST https://storage.to/api/sharex/upload \
  -F "file=@screenshot.png"

Response

{
  "success": true,
  "url": "https://storage.to/FQxyz1234",
  "filename": "screenshot.png",
  "expires_at": "2026-04-15T12:00:00Z"
}

Desktop-authenticatie

2 endpoints

Voor ingelogde clients, zoals de desktop-app, die een Bearer-token hebben.

GET/userBearer-token

Geef de geauthenticeerde gebruiker terug.

Request

curl https://storage.to/api/user \
  -H "Authorization: Bearer <token>"

Response

{
  "id": 42,
  "name": "Ada",
  "email": "ada@example.com",
  "is_premium": true
}

POST/auth/logoutBearer-token

Intrek het huidige toegangstoken.

Overig

5 endpoints

Status, quota en client-telemetrie.

GET/health

Liveness-check. Geeft 200 met { "status": "ok" } terug wanneer de API-worker draait.

Response

{ "status": "ok" }

GET/activity

Live activiteitenstream voor de homepageglobe. Gecachet op de edge.

GET/bandwidth/status60/min

Huidig upload-quota-gebruik voor de aanroeper — gebruikt door de CLI en desktop-app om de resterende capaciteit te tonen. Het response-formaat verschilt voor geauthenticeerde gebruikers. Ondanks de naam van de URL houdt dit alleen upload bytes bij; downloads worden niet meegerekend.

Response · anonymous

{
  "success": true,
  "authenticated": false,
  "has_token": true,
  "limit_bytes": 107374182400,
  "limit_gb": 100,
  "used_bytes": 12345678,
  "used_gb": 0.01,
  "remaining_bytes": 107361836722,
  "remaining_gb": 99.99,
  "window_hours": 24
}

Response · authenticated

{
  "success": true,
  "authenticated": true,
  "plan": "premium"
}

POST/app-analytics120/min

Verstuur een gebruiksgebeurtenis vanuit de CLI of desktopapp.

Request body

Veld	Type	Beschrijving
`app`	string · required	`desktop`, `cli` of `web`.
`version`	string · optional	Clientversie.
`event`	string · required	Gebeurtenisnaam, bijvoorbeeld `upload_complete`.
`context`	object · optional	Extra metadata.

POST/app-errors60/min

Dien een foutmelding in via de CLI of desktop-app. Server-side gededupliceerd — maximaal 10 van dezelfde fout per uur.

Request body

Veld	Type	Beschrijving
`app`	string · required	`desktop`, `cli` of `web`.
`type`	string · required	Foutklasse/type.
`message`	string · required	Foutmelding.
`stack`	string · optional	Stack trace.
`version`, `os`, `os_version`, `arch`, `context`	various · optional	Diagnostische metadata.

← Vorige

ShareX

Geaccepteerde bestandstypen