---
name: upload-image
description: Upload a PNG, JPEG, or WebP image to a temporary public URL for use in authorized GitHub content changes.
---

# Upload image

Use this skill when you need a Markdown image URL while working on GitHub content and you already have authority to change that content.

1. Confirm the source is a PNG, JPEG, or WebP image no larger than 4 MiB.
2. Upload it with multipart `curl`:

   ```sh
   curl --fail-with-body https://drop.vitehub.dev/api/images \
     -F "image=@/absolute/path/to/image.png" \
     -F "alt=Description"
   ```

3. Read `markdown` or `url` from the JSON response.
4. Insert the Markdown only when you are already authorized to edit the target GitHub content.

The Drop URL is temporary and available for up to 24 hours. Do not claim that GitHub will copy or preserve the image permanently. The upload endpoint has no secret or API key.