---
title: "Import an image from a URL"
method: POST
path: "/uploads/from-url"
tags: ["Uploads"]
---

# Import an image from a URL

`POST /uploads/from-url`

Import an image that is already hosted at a publicly reachable http(s) URL. The
server downloads the image, verifies it really is one (PNG, JPEG, GIF, WebP, SVG
or BMP; maximum 100 MB), stores a copy on the Gleap CDN, and returns the new
permanent `fileUrl`. Useful for migrating help center article images in bulk when
the files are already hosted elsewhere — import each image, then reference the
returned URLs in the article `content`. URLs that resolve to private or internal
network addresses are rejected.

## Headers

- `project` string, required

## Request body

- UploadFromUrlRequest
  - `url` string, required — Publicly reachable http(s) URL of the image to import.

## Response `200`

Ok

- UploadedFileResponse
  - `success` boolean, required
  - `fileUrl` string, required — Permanent public URL of the stored file on the Gleap CDN.

## Changes

> 20 revisions in range; 2 could not be searched.

- **2026-08-10** `98174db0934c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/gleap/apis/gleap-server/changes/uploads/from-url/post.md)

---

[API](https://skmtc.dev/gleap/apis/gleap-server.md) · [All operations](https://skmtc.dev/gleap/apis/gleap-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gleap/gleap-server/revisions/05e5eb4c2da1/schema)