# sto.care

> Free large-file sharing. Web app at https://sto.care (up to 5 GB, 7-day
> links, email-verified). Open HTTP API at https://ul.sto.care (up to 100 MB,
> 72-hour links, no auth, no signup).

## API — upload a file

One call, no authentication:

    curl -T yourfile.mp4 https://ul.sto.care

Response (JSON):

    {"url": "https://dl.sto.care/<id>", "expiresAt": "2026-07-24T15:00:00.000Z"}

- Method: PUT or POST to https://ul.sto.care/<filename>. The filename in the
  path is preserved for the download; `curl -T` sets it automatically.
- Max size: 100 MB. Content-Length header is required (curl -T sets it);
  chunked transfer encoding is not supported.
- Rate limit: 10 uploads per IP per UTC day.
- Files expire 72 hours after upload.

## API — download a file

    curl -LO https://dl.sto.care/<id>

Returns the file bytes with the original filename in Content-Disposition.

## API — errors

All errors are JSON `{"message": "..."}`:

- 411 — missing Content-Length (use `curl -T`, not chunked encoding)
- 413 — file over 100 MB (a bare Cloudflare 413 page means the same thing);
  use the web app at https://sto.care for files up to 5 GB
- 429 — daily per-IP upload limit reached; resets at UTC midnight
- 404 — unknown file id (may have expired)
- 410 — file expired (files live 72 hours)

GET https://ul.sto.care with no body returns this usage help as plain text.

## Larger files

For files up to 5 GB with 7-day links, use the web app: https://sto.care