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

# Upload file

> Upload a file that can be attached to a shipment.



## OpenAPI

````yaml /openapi.json post /shipments/attachments/upload
openapi: 3.0.1
info:
  title: Connector
  version: 80f7edc, 2026-01-23T12:01:00Z
  description: Enhanced Quivo API documentation with additional descriptions and examples
  contact:
    name: Quivo Support
    email: support@quivo.co
    url: https://quivo.co
  license:
    name: Proprietary
    url: https://quivo.co/terms
  termsOfService: https://quivo.co/terms
servers:
  - url: https://api.quivo.co/
    description: Production API server for Quivo Connector
security: []
tags:
  - name: addresses
    description: Manage stored addresses in the seller's address book
  - name: apiKeyRequests
    description: Request and manage API keys
  - name: articles
    description: Create and manage product articles
  - name: audits
    description: Access audit logs and history
  - name: bundles
    description: Manage product bundles
  - name: carriers
    description: Get carrier information
  - name: contacts
    description: Manage contact information
  - name: countries
    description: Get country information
  - name: currencies
    description: Get currency information
  - name: customerInquiries
    description: Manage customer inquiries
  - name: dashboards
    description: Access dashboard data
  - name: files
    description: Manage file uploads and downloads
  - name: fulfillmentPlans
    description: Manage fulfillment plans
  - name: inbounds
    description: Manage inbound shipments
  - name: items
    description: Monitor and manage inventory items
  - name: languages
    description: Get language information
  - name: notifications
    description: Manage notifications
  - name: orders
    description: Create and manage fulfillment orders
  - name: ping
    description: Health check endpoint
  - name: returnApp
    description: Manage return applications
  - name: returnLinks
    description: Manage return links
  - name: returns
    description: Manage returns
  - name: sellers
    description: Get seller information
  - name: shipments
    description: Book and manage shipments
  - name: shippingServiceGroups
    description: Get shipping service groups
  - name: shopOrders
    description: Manage shop orders
  - name: shops
    description: Manage shops
  - name: status
    description: Get system status
  - name: storedAddresses
    description: Manage stored addresses
  - name: subscriptionPackages
    description: Manage subscription packages
  - name: subscriptions
    description: Manage webhook subscriptions
  - name: track
    description: Track shipments
  - name: transports
    description: Manage transport services
  - name: users
    description: Manage users
  - name: warehouses
    description: Get warehouse information
paths:
  /shipments/attachments/upload:
    post:
      tags:
        - shipments
      summary: Upload file
      description: Upload a file that can be attached to a shipment.
      operationId: newShipmentPostAttachmentLink
      parameters:
        - name: mimeType
          in: query
          description: Mime type of the attachment
          schema:
            type: string
      responses:
        '200':
          description: >-
            Returns the newly created ShipmentAttachmentUpload with assigned
            identifiers and current state.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ShipmentAttachmentUpload'
        '400':
          description: >-
            Bad request - the request payload is invalid, missing required
            fields, or contains invalid data.
        '401':
          description: >-
            Unauthorized - authentication credentials are missing, invalid, or
            expired.
        '404':
          description: >-
            Not found - the requested resource does not exist or is not
            accessible.
        '500':
          description: Internal server error - an unexpected error occurred on the server.
components:
  schemas:
    ShipmentAttachmentUpload:
      type: object
      properties:
        fileKey:
          type: string
          description: >-
            File key which should be used for uploading the file and adding the
            attachment
        uploadUrl:
          type: string
          description: URL for uploading the attachment
        mimeType:
          type: string
          description: Mimetype of the attachment
      description: >-
        Result of uploading a shipment attachment. Contains attachment
        identifier and file reference.

````