Skip to content

0.1.11 - speak the Icedrive desktop API

Latest

Choose a tag to compare

@kurobeats kurobeats released this 26 Oct 00:25

The mobile API is gone; ColdSnake now speaks the desktop one

Icedrive retired /v3/mobile on 2026-10-26. Every request there - proof-of-work,
listing, even a still-cached bearer token - now answers:

{"error": true, "code": 3000, "message": "Please update app to latest version"}

and it does so for any version in the iOS User-Agent (2.3.1 through 99.0), so a
version bump cannot fix it. A non-mobile User-Agent is refused with code 5001.

0.1.11 talks to https://apis.icedrive.net/v3/desktop the way Icedrive's own CLI
does, with User-Agent: icedrive-linux-cli/3.62 and
X-Icedrive-Api-Version: 2 on every request.

What changed

  • Login - POST /pow-new then POST /login (multipart; the device id carries a
    ::m suffix on the login call). The proof-of-work answer is unchanged, so no
    change to the solver.
  • Stats - /stats-storage replaces /user-stats and answers a flat document;
    it is normalised back to the nested shape callers already used. No bandwidth
    figures any more.
  • Routes - /move, /file-rename, /trash-add, /restore-trash. /move
    takes items=file-<id>; the app's nitems JSON field is refused with HTTP 400.

Verified live (2026-10-26)

Login, stats, pre-flight, listing, folder creation, whole-file and chunked upload
(20 MB round-tripped with a matching sha256), post-upload verification, idempotent
re-runs, move, rename, version history, download, trash, batch erase and scrub -
all re-run against a real account, and again end to end through the CLI on a
production host.

Known gap

coldsnake restore --id does not work on the desktop API yet. The route the
Icedrive app builds, POST /restore-trash?itemId=<id>&type=file, answers
2003 Invalid request, and every other spelling tried on the live account does
the same. Trashing, listing the trash and erasing all work; use the Icedrive app
to bring an item back until the route is found.

Upgrading

pip install --upgrade .        # or: pipx upgrade coldsnake
coldsnake login                # the cached token from 0.1.10 is not valid here

180 unit tests, no dependencies beyond the standard library.