Image Upload for GitHub

Quick reference

# Upload (multipart)
curl -s -X POST https://img402.dev/api/free -F image=@/tmp/screenshot.png

# Response
# {"url":"https://i.img402.dev/aBcDeFgHiJ.png","id":"aBcDeFgHiJ","contentType":"image/png","sizeBytes":182400,"expiresAt":"2026-02-17T..."}

Workflow

1. Get image: Use an existing file, or capture a screenshot:
   bash

   screencapture -x /tmp/screenshot.png        # macOS — full screen
   screencapture -xw /tmp/screenshot.png       # macOS — frontmost window

2. Verify size: Must be under 1MB. If larger, resize:
   bash

   sips -Z 1600 /tmp/screenshot.png  # macOS — scale longest edge to 1600px

3. Upload:
   bash

   curl -s -X POST https://img402.dev/api/free -F image=@/tmp/screenshot.png

4. Embed the returned

   url

   in GitHub markdown:
   markdown

   ![Screenshot description](https://i.img402.dev/aBcDeFgHiJ.png)

GitHub integration

gh

# Add to PR description
gh pr edit --body "$(gh pr view --json body -q .body)

![Screenshot](https://i.img402.dev/aBcDeFgHiJ.png)"

# Add as PR comment
gh pr comment --body "![Screenshot](https://i.img402.dev/aBcDeFgHiJ.png)"

# Add to issue
gh issue comment 123 --body "![Screenshot](https://i.img402.dev/aBcDeFgHiJ.png)"

Constraints

• Max size: 1MB
• Retention: 7 days — suitable for PR reviews, not permanent docs
• Formats: PNG, JPEG, GIF, WebP
• Rate limit: 1,000 free uploads/day (global)
• No auth required

Tips

• Prefer PNG for UI screenshots (sharp text). Use JPEG for photos.
• If a screenshot is too large, reduce dimensions with

  sips -Z 1600

  before uploading.
• When adding to a PR body or comment, use

  gh pr comment

  or

  gh pr edit

  with the image markdown.

Paid tier