Share an artifact with one POST.
You generated an HTML report, a chart, a PDF. Now someone needs to look at it. Send it here and get back a URL that just opens in a browser — no account, no SDK, no bucket to configure.
How do I upload from a script or an agent?
curl -X POST https://brln.tv/api/artifacts \
-F '[email protected]'
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"url": "https://pages.brln.tv/a1b2c3d4/report.html",
"file_size_bytes": 512000,
"expires_at": "2026-09-30T10:30:00Z",
"delete_token": "keep-this-to-retract-the-upload"
}
That is the whole integration. The response url is live
immediately. Keep delete_token if you may need to retract the
upload — it is shown once and cannot be recovered.
That is also available as a native tool: brln.tv runs an
MCP server at https://brln.tv/mcp, so an
agent can call upload_artifact directly instead of shelling out.
Full documentation: /docs (also as Markdown and llms-full.txt) · schema: /openapi.json · interactive explorer
Can my AI assistant just do this for me?
Yes — install the plugin once, then ask in plain language. "Publish this report", "put this online", "give me a link to this" all work; you never name a tool or paste a command.
claude plugin marketplace add https://brln.tv/plugin
claude plugin install brln-tv@brln-tv
Installing wires up three things: a skill that teaches the assistant when and how to publish here — including that an uploaded page has to be self-contained, since artifacts are served under a strict sandbox — a /publish command for when you want to be explicit, and the MCP server, so it calls a real upload tool instead of shelling out to curl.
It also hands you back the one-time delete token on every anonymous upload, which is the only way to take a page down again.
The plugin is public domain and readable in full before you install it:
github.com/abrilliantov/brln-tv-skill.
It is served from this domain too, so
claude plugin marketplace add abrilliantov/brln-tv-skill and the
command above install the same thing. Prefer not to install anything? The
curl above is the whole API.
How do I upload from my browser?
Drop a file here
HTML, PDF, SVG, images, text, JSON, CSV, Markdown — up to 2 MB anonymously, 95 MB with an account.
What are the limits?
| Anonymous | Registered | |
|---|---|---|
| Size per file | 2 MB | 95 MB |
| Uploads | 5 per month, per IP | Unmetered |
| Retention | 30 days | Until you delete it |
| Manage uploads | One-time delete token | Listable library |
Registering takes one POST /api/auth/register, then send
Authorization: Bearer <token> with your uploads.
How your artifact is served
- Every artifact lives on
pages.brln.tv— a different origin from this site and its API, so an uploaded page can never reach an account here. - Pages are served with scripting sandboxed and framing blocked, and with the content type taken from our own whitelist rather than whatever the uploader declared.
- Artifacts are
noindex: a link is shareable, but search engines are asked to stay out. - Anything can be reported and taken down. Uploading phishing, malware, or someone else's private data will get the artifact removed and the account banned.