Extensions

See Extensions for what is accepted and how to use one.

The extension object

{ "id": "e1e2d3c4-…", "name": "uBlock Origin Lite", "version": "2025.1", "createdAt": "2026-11-09T10:00:00.000Z" }

name and version come from the extension’s manifest.

Upload an extension

POST /extensions → 201 the extension

A multipart form with the zip in the field file:

curl -X POST https://api.datum.org/api/v4/extensions \
  -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" \
  -F file=@extension.zip

422 for a zip without manifest.json at its root, not Manifest V3, too large, with a key (prohibited_key) or a permission not allowed (prohibited_permission), or a 101st extension.

List, get and delete

• GET /extensions → a page of extensions
• GET /extensions/{id} → the extension
• DELETE /extensions/{id} → 204. Browsers running with it keep it.