> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gleap.io/llms.txt
> Use this file to discover all available pages before exploring further.

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



## OpenAPI

````yaml https://api.gleap.io/api-docs.json post /uploads/from-url
openapi: 3.0.0
info:
  title: gleap-server
  version: 14.0.0
  contact: {}
servers:
  - url: https://api.gleap.io/v3
security: []
paths:
  /uploads/from-url:
    post:
      tags:
        - Uploads
      summary: Import an image from a URL
      description: >-
        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.
      operationId: UploadImageFromUrl
      parameters:
        - in: header
          name: project
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UploadFromUrlRequest'
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UploadedFileResponse'
      security:
        - jwt: []
components:
  schemas:
    UploadFromUrlRequest:
      properties:
        url:
          type: string
          description: Publicly reachable http(s) URL of the image to import.
      required:
        - url
      type: object
      additionalProperties: false
    UploadedFileResponse:
      properties:
        success:
          type: boolean
        fileUrl:
          type: string
          description: Permanent public URL of the stored file on the Gleap CDN.
      required:
        - success
        - fileUrl
      type: object
      additionalProperties: false
  securitySchemes:
    jwt:
      type: http
      scheme: bearer
      bearerFormat: JWT

````