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

# Create upload request

> Create upload request



## OpenAPI

````yaml https://openapi.commercengine.io/ce-admin.json post /media/files/upload-request
openapi: 3.1.0
info:
  title: CE Admin APIs
  version: '1.0'
  summary: Comprehensive admin interface for managing your e-commerce platform
  description: >-
    Complete administrative API suite for Commerce Engine, providing powerful
    tools to manage products, orders, customers, inventory, analytics, and
    system configuration. Designed for administrators and backend integrations
    requiring full platform control.
  license:
    name: All Rights Reserved
    url: https://www.commercengine.io/contact-us
  contact:
    email: support@commercengine.io
    url: https://www.commercengine.io/contact-us
    name: Support
servers:
  - url: https://staging.api.commercengine.io/api/v1/{store_id}/admin
    description: Staging Server
    variables:
      store_id:
        default: store_id
        description: Store ID
  - url: https://prod.api.commercengine.io/api/v1/{store_id}/admin
    description: Prod Server
    variables:
      store_id:
        default: store_id
        description: Store ID
security:
  - Authorization: []
tags:
  - name: Analytics
    description: Analytics
  - name: Catalog
    description: Catalog
  - name: Coupons & promotions
    description: Coupons & promotions
  - name: Customers
    description: Customers
  - name: Filter Options
    description: Filter Options
  - name: Inventories
    description: Inventories
  - name: Marketplace
    description: Marketplace
  - name: Marketplace Catalog
    description: Marketplace Catalog
  - name: Media Gallery
    description: Media Gallery
  - name: Metrics
    description: Metrics
  - name: Orders
    description: Orders
  - name: Payments
    description: Payments
  - name: Payouts
    description: Payouts
  - name: POS
    description: POS
  - name: POSAdmin
    description: Admin endpoints to be used as proxy in pos
  - name: Segments
    description: Segments
  - name: Shipping
    description: Shipping
  - name: SSE
    description: SSE
  - name: Store
    description: Store
  - name: Webhooks
    description: Webhooks
paths:
  /media/files/upload-request:
    post:
      tags:
        - Media Gallery
      summary: Create upload request
      description: Create upload request
      operationId: request-file-upload
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MediaFileUploadRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  success:
                    type: boolean
                  content:
                    properties:
                      file:
                        type: object
                        properties:
                          upload_source:
                            enum:
                              - local-storage
                              - external-url
                          file_type:
                            enum:
                              - image
                              - video
                              - document
                          id:
                            type: string
                          upload_url:
                            description: >-
                              for uploading file directly to third party server
                              from local-storage.
                            type: string
                    type: object
components:
  schemas:
    MediaFileUploadRequest:
      title: MediaFileUploadRequest
      oneOf:
        - $ref: '#/components/schemas/MediaFileUploadRequestForLocalStorage'
        - $ref: '#/components/schemas/MediaFileUploadRequestForExternalUrl'
    MediaFileUploadRequestForLocalStorage:
      title: MediaFileUploadRequestForLocalStorage
      type: object
      required:
        - upload_source
        - file_type
        - file_name
        - file_size
      properties:
        upload_source:
          enum:
            - local-storage
        file_type:
          enum:
            - image
            - video
            - document
        file_name:
          type: string
        file_size:
          description: in bytes
          type: integer
        folder_id:
          description: >-
            Optional. If provided, file will be uploaded into the specified
            folder.
          type: string
      x-tags:
        - Media Gallery
    MediaFileUploadRequestForExternalUrl:
      title: MediaFileUploadRequestForExternalUrl
      type: object
      required:
        - upload_source
        - external_url
      properties:
        upload_source:
          enum:
            - external-url
        external_url:
          type: string
        folder_id:
          description: >-
            Optional. If provided, file will be uploaded into the specified
            folder.
          type: string
      x-tags:
        - Media Gallery
  securitySchemes:
    Authorization:
      type: http
      scheme: bearer

````