Developer flow

Online Clipboard API

Use the API to create temporary text, image, and small file clips from scripts, tools, and terminal workflows. Anonymous API usage is intentionally simple and short lived.

Create a text clip

POST /api/v1/clips
Content-Type: application/json

{
  "kind": "text",
  "content": "hello world",
  "code_length": 4,
  "ttl_minutes": 15,
  "expire_mode": "sliding",
  "burn_after_read": true
}

Create an image or file clip

File and image clips use the same JSON API. Send base64 file data in file.data. The current low-cost MVP limit is 1 MB per file.

POST /api/v1/clips
Content-Type: application/json

{
  "kind": "image",
  "content": "optional caption",
  "file": {
    "name": "screenshot.png",
    "type": "image/png",
    "size": 123456,
    "data": "iVBORw0KGgoAAAANSUhEUg..."
  },
  "code_length": 6,
  "ttl_minutes": 15,
  "expire_mode": "sliding",
  "burn_after_read": true
}

Use "kind": "file" for non-image files. For image clips, the MIME type must start with image/.

Read a clip

GET /api/v1/clips/A7K2

{
  "code": "A7K2",
  "content": "optional caption or text",
  "kind": "image",
  "file": {
    "name": "screenshot.png",
    "type": "image/png",
    "size": 123456,
    "data": "iVBORw0KGgoAAAANSUhEUg..."
  },
  "burn_after_read": true,
  "expires_at": "2026-06-04T12:00:00.000Z",
  "access_count": 1
}

If burn-after-read is enabled, a successful read deletes the clip.

Delete a clip

Send DELETE /api/v1/clips/<code> with Authorization: Bearer <delete-token> to remove an active clip before it expires.