API

Publish and manage sites from scripts.

Create a key in Settings → API keys. Send it as a Bearer token. Keys are shown once, so copy yours when you create it.

curl -X POST https://YOUR-DOMAIN/api/sites \
  -H "Authorization: Bearer vl_..." \
  -H "Content-Type: application/json" \
  -d '{"html":"<h1>Hello</h1>","ttl":"7d"}'

Sites

  • POST /api/sites creates a site. ttl is 1d, 7d, 30d or never (Pro).
  • GET /api/sites lists your sites.
  • GET /api/sites/ID reads one. PUT /api/sites/ID re-publishes it in place. DELETE /api/sites/ID removes it.

Other endpoints

  • GET /api/sites/ID/forms lists a site's form responses (add ?format=csv to download them).
  • GET /api/media lists your files and storage use. POST /api/media?name=photo.png uploads a file (send the file itself as the request body). DELETE /api/media/ID removes one.
  • GET /api/clips, POST /api/clips, PATCH /api/clips/ID and DELETE /api/clips/ID manage your clipboard.

Creating and managing API keys themselves needs a signed-in browser session; a key can't create other keys.

← Clipboard