FastCopy 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.