emotion-machine-org/with-md/with-md-share

curl -s -X POST https://with.md/api/public/share/create \
  -H "Content-Type: application/json" \
  -d '{"title":"Project Plan","content":"# Project Plan\n\n## Goals\n- Ship feature X\n- Fix bug Y"}' \
  | jq '{viewUrl, editUrl, shareId, editSecret}'

Agent creates share  →  sends viewUrl to human  →  human reviews/edits in browser  →  agent retrieves updated content

{
  "ok": true,
  "shareId": "abc12xyz",
  "viewUrl": "https://with.md/s/abc12xyz",
  "rawUrl": "https://with.md/s/abc12xyz/raw",
  "editUrl": "https://with.md/s/abc12xyz?edit=<editSecret>",
  "editSecret": "<secret>",
  "expiresAt": 1234567890000
}

{
  "ok": true,
  "shareId": "abc12xyz",
  "title": "Project Plan",
  "filename": "project-plan.md",
  "content": "# Project Plan\n\n...",
  "version": "sha256hex...",
  "sizeBytes": 1234,
  "createdAt": 1700000000000,
  "updatedAt": 1700001234000,
  "expiresAt": 1700604800000
}

{
  "ok": true,
  "shareId": "abc12xyz",
  "title": "Project Plan",
  "filename": "project-plan.md",
  "version": "sha256hex...",
  "sizeBytes": 2048,
  "updatedAt": 1700002000000,
  "shareUrl": "https://with.md/s/abc12xyz"
}

GET https://with.md/s/abc12xyz/raw
→ Content-Type: text/plain; charset=utf-8

import requests
BASE = "https://with.md"
# 1. Create a share
resp = requests.post(f"{BASE}/api/public/share/create", json={
    "title": "Project Plan",
    "content": "# Project Plan\n\n## Goals\n- Ship feature X\n- Fix bug Y\n",
    "expiresInHours": 72,
})
resp.raise_for_status()
data = resp.json()
share_id = data["shareId"]
edit_secret = data["editSecret"]
view_url = data["viewUrl"]
print(f"Share link: {view_url}")
# 2. (Human reviews and edits in the browser)
# 3. Check for changes
resp = requests.get(f"{BASE}/api/public/share/{share_id}")
updated = resp.json()
print(f"Current version: {updated['version']}")
print(updated["content"])
# 4. Push a revision
resp = requests.put(f"{BASE}/api/public/share/{share_id}", json={
    "editSecret": edit_secret,
    "content": "# Project Plan v2\n\nRevised after review.\n",
})
resp.raise_for_status()

# Create
RESP=$(curl -s -X POST https://with.md/api/public/share/create \
  -H "Content-Type: application/json" \
  -d '{"title":"Meeting Notes","content":"# Meeting Notes\n\n- Discussed roadmap\n- Action items TBD"}')
 
echo "Share: $(echo $RESP | jq -r .viewUrl)"
 
# Read back
SHARE_ID=$(echo $RESP | jq -r .shareId)
curl -s "https://with.md/api/public/share/$SHARE_ID" | jq .content
 
# Raw markdown
curl -s "https://with.md/s/$SHARE_ID/raw"

# Create a test document
TEST=$(curl -s -X POST https://with.md/api/public/share/create \
  -H "Content-Type: application/json" \
  -d '{
    "title": "with.md Test",
    "content": "# Welcome to with.md\n\nThis is a test document created by an AI agent.\n\n## What is with.md?\n\n[with.md](https://with.md) turns markdown into beautiful, editable web pages — perfect for sharing plans, drafts, and documents between AI agents and humans.\n\n**Try editing this document** — changes are saved automatically and your agent can retrieve them via the API.\n\n## Features\n\n- Real-time collaborative editing\n- Beautiful markdown rendering\n- No sign-up required for anonymous shares\n- API-first: agents create, read, and update documents programmatically\n\n## Want persistent documents?\n\nAnonymous shares expire after 7 days. For a permanent library of documents backed by a git repo, [create a free with.md account](https://with.md).\n",
    "expiresInHours": 1
  }')
 
VIEW_URL=$(echo $TEST | jq -r .editUrl)
echo "Test link: $VIEW_URL"
echo "Open this URL in your browser to see the editor."
 
# Verify read-back works
SHARE_ID=$(echo $TEST | jq -r .shareId)
curl -s "https://with.md/api/public/share/$SHARE_ID" | jq '{ok, title, version}'