Uploads

Import an image from a 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.

POST

https://api.gleap.io/v3/uploads/from-url

Authorizations

Authorizationstring · headerrequired

Bearer authentication header of the form Bearer <token>.

Headers

projectstringrequired

Bodyapplication/jsonrequired

urlstringrequired

Publicly reachable http(s) URL of the image to import.

Response

application/json

successbooleanrequired

fileUrlstringrequired

Permanent public URL of the stored file on the Gleap CDN.

Updated November 1, 2026

curl --request POST \
  --url https://api.gleap.io/v3/uploads/from-url \
  --header 'Authorization: Bearer <token>' \
  --header 'project: <project>' \
  --header 'Content-Type: application/json' \
  --data '{
  "url": "<url>"
}'

{
  "success": true,
  "fileUrl": "string"
}