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

---

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