whamlink for agents

Publish one file — HTML, Markdown, PDF, image, or text — to a clean, permanent link. API-first.

1. Register (with the user's consent + real email)

POST https://whamlink.com/v1/auth/register
{"email":"user@example.com","name":"Their Name"}
→ 201 { user, apiKey: "wl_...", _setup }

Store the apiKey — it's shown once. The verification link is emailed to that address.

2. Publish

POST https://whamlink.com/v1/publish   (header: x-api-key: wl_...)
{"mode":"markdown","content":"# hi","title":"Notes"}
→ 201 { url: "https://whamlink.com/<slug>" }

Modes: sandboxed_html, sanitized_html, markdown, pdf, image, text. Set allowNetwork:true to let HTML load https CDN assets.

Limits

Unverified accounts publish 3 links, then 403 verification_required — the user verifies via the emailed link to unlock full quota. Files: 5 MB unverified, 25 MB verified.

Rules

Links are public (unlisted) by default and permanent until deleted — or make any link private, password-protected, or shared with specific people (pass visibility on publish, or change it later). Never publish secrets or private data. Machine-readable reference: /llms.txt.

Use it from your agent

Install the whamlink Claude skill and your agent can publish on your behalf — with your consent and real email.

FAQ

What is whamlink?

whamlink is an API-first service that turns a single file — HTML, Markdown, PDF, image, or text — into a clean, permanent, shareable link. It's built for AI agents to publish on a user's behalf, but anyone can use the API or dashboard.

How does an AI agent publish a file to a shareable link?

The agent calls POST https://whamlink.com/v1/publish with an API key and the file content, and gets back a permanent https://whamlink.com/<slug> URL. The simplest path is to install the whamlink skill; see /llms.txt for the full machine-readable reference.

Is whamlink free?

Yes. whamlink is free, with one generous tier (25 MB per file, 1 GB storage, 100 links/day). See pricing.

Can whamlink links be private or password-protected?

Yes. Links are public (unlisted) by default, or you can make any link private (owner only), password-protected, or shared with specific email addresses — set visibility when publishing or change it later.

What file types can I publish?

HTML (sandboxed or sanitized), Markdown, PDF, images (PNG/JPEG/GIF/WebP), and plain text. HTML renders in a sandboxed iframe on an isolated origin.

How is whamlink different from a GitHub Gist or pastebin?

whamlink is API-first and built for agents: one call returns a rendered, permanent link (HTML actually renders, PDFs and images display), with built-in access control (private/password/email) and no UI step required.