Diátaxis: reference

Drop

Drop is one fast capture edge for the Wiki raw corpus. It accepts a link, text, or one file with an optional note. It writes one immutable capture bundle and returns immediately.

Drop does not fetch, classify, summarize, browse, or route work. Later Wiki and Hound workflows consume the raw record.

Surfaces

• Web form: http://atum-vps.tail6bb091.ts.net:18790/
• iOS Share Sheet endpoint: POST http://atum-vps.tail6bb091.ts.net:18790/links
• Generic endpoint: POST http://atum-vps.tail6bb091.ts.net:18790/capture
• Health: GET http://atum-vps.tail6bb091.ts.net:18790/health

Drop is available only on the scty.org tailnet. Tailscale owns access control; Drop has no second application key.

The existing iOS Shortcut remains compatible:

{
  "content": "Shortcut Input",
  "title": "Name",
  "note": "optional"
}

Send Content-Type: application/json. The device must be connected to Tailscale. HTTP is private inside Tailscale's encrypted tunnel; the service is not bound to the public interface.

Storage

Each capture is a create-only bundle under CAPTURE_DIR:

YYYY-MM-DD-<content-hash>-<title>/
├── capture.md
└── <attachment>       # only for file captures

Exact same-day retries return the first receipt without rewriting it. Drop stores no database, feed, mutable link file, or generated catalog.

Production mounts CAPTURE_DIR at /home/deploy/wiki/raw/library/captures.

Request formats

JSON accepts url, text or content, title, note, and channel.

Multipart form data accepts content, file, title, note, and channel. One file is supported.

Environment

Variable	Required	Purpose
CAPTURE_DIR	yes in production	Raw capture root; defaults to /raw
PORT	no	HTTP port; defaults to 18790

Verify

node --test test/server.test.js
docker build -t drop-test .