Ethernovia Upload - File API

openapi: 3.2.0
info:
  version: 1.0.0
  title: DOCUMENTATION Upload - File API
  description: ''
  termsOfService: YOUR_TERMS_OF_SERVICE_URL
  contact:
    name: TEAM
    email: contact-email@something.io
    url: mywebsite.io
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  x-generation-date: '2026-07-07T06:23:13.532Z'
servers:
- url: http://localhost:1337/api
  description: Development server
security:
- bearerAuth: []
tags:
- name: Upload - File
paths:
  /upload:
    post:
      description: Upload files
      responses:
        '200':
          description: response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/UploadFile'
      summary: ''
      tags:
      - Upload - File
      requestBody:
        description: Upload files
        required: true
        content:
          multipart/form-data:
            schema:
              required:
              - files
              type: object
              properties:
                path:
                  type: string
                  description: The folder where the file(s) will be uploaded to (only supported on strapi-provider-upload-aws-s3).
                refId:
                  type: string
                  description: The ID of the entry which the file(s) will be linked to
                ref:
                  type: string
                  description: The unique ID (uid) of the model which the file(s) will be linked to (api::restaurant.restaurant).
                field:
                  type: string
                  description: The field of the entry which the file(s) will be precisely linked to.
                files:
                  type: array
                  items:
                    type: string
                    format: binary
  /upload?id={id}:
    post:
      parameters:
      - name: id
        in: query
        description: File id
        required: true
        schema:
          type: string
      description: Upload file information
      responses:
        '200':
          description: response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/UploadFile'
      summary: ''
      tags:
      - Upload - File
      requestBody:
        description: Upload files
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                fileInfo:
                  type: object
                  properties:
                    name:
                      type: string
                    alternativeText:
                      type: string
                    caption:
                      type: string
                files:
                  type: string
                  format: binary
  /upload/files:
    get:
      tags:
      - Upload - File
      responses:
        '200':
          description: Get a list of files
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/UploadFile'
  /upload/files/{id}:
    get:
      parameters:
      - name: id
        in: path
        description: ''
        deprecated: false
        required: true
        schema:
          type: string
      tags:
      - Upload - File
      responses:
        '200':
          description: Get a specific file
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UploadFile'
    delete:
      parameters:
      - name: id
        in: path
        description: ''
        deprecated: false
        required: true
        schema:
          type: string
      tags:
      - Upload - File
      responses:
        '200':
          description: Delete a file
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UploadFile'
components:
  schemas:
    UploadFile:
      properties:
        id:
          type: number
        name:
          type: string
        alternativeText:
          type: string
        caption:
          type: string
        width:
          type: number
          format: integer
        height:
          type: number
          format: integer
        formats:
          type: number
        hash:
          type: string
        ext:
          type: string
        mime:
          type: string
        size:
          type: number
          format: double
        url:
          type: string
        previewUrl:
          type: string
        provider:
          type: string
        provider_metadata:
          type: object
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
externalDocs:
  description: Find out more
  url: https://docs.strapi.io/developer-docs/latest/getting-started/introduction.html
x-strapi-config:
  plugins:
  - upload
  - users-permissions