echodrop.link

List Drops

List drops owned by the authenticated user. Optional status filter: ready, pending, revoked, consumed.

Get Drop

Fetch full metadata for a single drop owned by the user.

Get Drop Events

Audit timeline for a drop owned by the user (unlock attempts, downloads, etc.).

Get Drop Receipts

Cryptographically-signed download receipts for a drop owned by the user.

Create Upload Drop

USE THIS tool whenever the user wants to share a file via EchoDrop and the bytes are available to you (a file the user attached to the conversation, a file you generated, a file you downloaded for them). The bytes are uploaded directly to EchoDrop's own object storage over this tool call — you do NOT need to host the file anywhere first. Pass each file's raw bytes as standard base64 in `files[].data`. Limits: max 25 files per drop, max 5 MB per file, max 50 MB total. Never upload the user's file

Create Link Drop

Create a drop that gates one or more URLs that are ALREADY hosted somewhere the user controls (Google Drive, Dropbox, S3, their own website). EchoDrop does not copy the bytes — pickup_drop will fetch them at delivery time. DO NOT use this tool to share a file the user just attached or that you generated: that requires uploading the bytes first, which this tool does not do. For attached or generated files, call `create_upload_drop` instead. Never upload a user's file to a third-party file host (f

Revoke Drop

Permanently revoke a drop. The pickup code stops working immediately.

Inspect Pickup

Pre-flight a pickup. Returns drop metadata, file list with sizes, and whether each file fits the inline byte cap. Does NOT consume a download slot, does NOT require the password, does NOT generate a receipt. Always call this before pickup_drop.

Pickup Drop

Receive files for a pickup code. Validates password (if any), reserves one download slot, signs a receipt, and returns the file bytes inline (per-file cap ~5 MB). Files exceeding the cap come back as { tooLarge: true, sourceUrl, sizeBytes } so you can fall back to the source URL. Optional fileIndices selects a subset. One call = one transfer.