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

# Update inbound shipment

> Update an existing inbound shipment.



## OpenAPI

````yaml /openapi.json put /inbounds/{inboundId}
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:
  /inbounds/{inboundId}:
    put:
      tags:
        - inbounds
      summary: Update inbound shipment
      description: Update an existing inbound shipment.
      operationId: putInbound
      parameters:
        - name: inboundId
          in: path
          required: true
          schema:
            type: integer
            format: int64
          description: The unique identifier for an inbound shipment or delivery.
      requestBody:
        content:
          application/json:
            schema:
              type: string
        required: false
        description: Complete resource data to update at /inbounds/{inboundId}
      responses:
        '200':
          description: Returns the updated inbound shipment with current state.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InboundGet'
        '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:
    InboundGet:
      required:
        - deliverySlipNumber
        - estimatedArrivalTime
        - sellerId
        - shipFrom
        - shopId
        - warehouseId
      type: object
      properties:
        sellerId:
          type: integer
          description: Seller ID.
          format: int64
        warehouseId:
          type: integer
          description: >-
            Warehouse ID. <br>A list of warehouse identifiers and names can be
            obtained by executing GET /warehouses
          format: int64
        shipFrom:
          $ref: '#/components/schemas/AddressDetail'
        estimatedArrivalTime:
          type: string
          description: Estimated date of arrival
          format: date-time
        deliverySlipNumber:
          type: string
          description: Delivery slip number
        customAttributes:
          type: object
          additionalProperties:
            type: string
          description: Optional custom attributes of this inbound.
          example: '{"attr1":"val1"}'
        movementReferenceNumber:
          maxLength: 1024
          minLength: 0
          type: string
          description: >-
            Optional movement reference number. Unique identifier assigned to
            customs declarations within the UK and EU
        id:
          type: integer
          format: int64
          description: The unique identifier for the id
        created:
          type: string
          format: date-time
          description: Timestamp when the item was created
        inboundIdentifier:
          type: string
          description: The unique identifier for the inboundentifier
        exportedAt:
          type: string
          format: date-time
          description: The exported at timestamp
        completedAt:
          type: string
          format: date-time
          description: The completed at timestamp
        cancelledAt:
          type: string
          format: date-time
          description: The cancelled at timestamp
        inboundStatus:
          type: string
          enum:
            - PENDING
            - CREATED
            - PROCESSING
            - COMPLETED
            - CANCELLED
          description: The current status of the inbound
        requestId:
          type: string
          description: The unique identifier for the request
        inboundShipments:
          type: array
          items:
            $ref: '#/components/schemas/InboundShipmentDetail'
          description: Shipment identifier or information
        createdByLogsta:
          type: boolean
          description: Timestamp when the item was created
        trackingNumber:
          type: string
          description: Tracking information or tracking enabled status
        comments:
          type: string
          description: Comment or notes
        deliverySlipDate:
          type: string
          format: date-time
          description: The delivery slip date date
        externalIdentifier:
          type: string
          description: The unique identifier for the externalentifier
        tags:
          type: array
          items:
            type: string
          description: Tags or labels
        inboundReference:
          type: string
          description: Reference number or identifier for the inbound
        shopId:
          type: integer
          description: Shop ID.
          format: int64
        carrier:
          type: string
          description: Carrier identifier or information
        trackingLink:
          type: string
          description: Tracking information or tracking enabled status
        inboundPositions:
          type: array
          items:
            $ref: '#/components/schemas/InboundPositionDetailGet'
          description: Array of inbound position
        deliveryInfo:
          $ref: '#/components/schemas/InboundDeliveryInfoDetail'
      description: >-
        Complete inbound shipment information. Contains expected items,
        quantities, warehouse destination, delivery dates, and processing
        status.
    AddressDetail:
      type: object
      properties:
        name1:
          type: string
          description: The name of the item
        name2:
          type: string
          description: The name of the item
        company:
          type: string
          description: Company name
        address1:
          type: string
          description: Address information
        address2:
          type: string
          description: Address information
        address3:
          type: string
          description: Address information
        zip:
          type: string
          description: ZIP or postal code
        city:
          type: string
          description: City name
        state:
          type: string
          description: State or province
        country:
          type: string
          description: Country code or name
        phone:
          type: string
          description: Phone number
        email:
          type: string
          description: Email address
      description: Detailed address information
    InboundShipmentDetail:
      type: object
      properties:
        inboundShipmentIdentifier:
          type: string
          description: The unique identifier for the inboundshipmententifier
        arrivedAt:
          type: string
          format: date-time
          description: The arrived at timestamp
        inboundShipmentPositions:
          type: array
          items:
            $ref: '#/components/schemas/InboundShipmentPositionDetail'
          description: Shipment identifier or information
        comments:
          type: string
          description: Comment or notes
        reasonToAddImages:
          type: string
          description: Image reference
        totalGrossWeight:
          type: number
          description: Weight value
        inboundComments:
          type: array
          items:
            $ref: '#/components/schemas/InboundCommentGet'
          description: Comment or notes
        images:
          type: array
          items:
            $ref: '#/components/schemas/InboundImageGet'
          description: Image reference
        groupedInboundShipmentPositions:
          type: array
          items:
            $ref: '#/components/schemas/GroupedInboundShipmentPosition'
          description: Shipment identifier or information
      description: Detailed information for inboundshipment
    InboundPositionDetailGet:
      required:
        - quantity
        - sku
      type: object
      properties:
        quantity:
          minimum: 1
          type: integer
          description: Number of units of the position.
          format: int32
        sku:
          type: string
          description: Position SKU.
        lot:
          type: string
          description: Optional position lot.
        location:
          type: string
          description: Optional position location.
        expirationDate:
          type: string
          description: Optional position expiration date.
          format: date
        serialNumbers:
          type: array
          description: Optional position serial numbers.
          items:
            type: string
        positionNumber:
          maxLength: 25
          minLength: 0
          type: string
          description: Optional position number or identifier
        customAttributes:
          type: object
          additionalProperties:
            type: string
          description: Custom attributes or data
        inboundPositionId:
          type: integer
          format: int64
          description: The unique identifier for the inboundposition
        warehouseSku:
          type: string
          description: Stock Keeping Unit (SKU) identifier
        articleIdentifier:
          type: string
          description: The unique identifier for the articleentifier
        productIdentifier:
          type: string
          description: The unique identifier for the productentifier
      description: Response object containing inboundpositiondetail details
    InboundDeliveryInfoDetail:
      required:
        - cargoType
        - quantity
      type: object
      properties:
        cargoType:
          type: string
          description: Cargo type.
          enum:
            - CARTON
            - PALLET
            - CONTAINER
        quantity:
          minimum: 1
          type: integer
          description: Cargo quantity.
          format: int32
      description: Detailed information for inbounddeliveryinfo
    InboundShipmentPositionDetail:
      type: object
      properties:
        quantity:
          type: integer
          format: int32
          description: Quantity or amount
        warehouseSku:
          type: string
          description: Stock Keeping Unit (SKU) identifier
        sellerSku:
          type: string
          description: Stock Keeping Unit (SKU) identifier
        lot:
          type: string
          description: The lot value
        location:
          type: string
          description: The location value
        positionIdentifier:
          type: string
          description: The unique identifier for the positionentifier
        totalGrossWeight:
          type: number
          description: Weight value
        barcode:
          type: string
          description: Code or identifier
        storageCode:
          type: string
          description: Code or identifier
        storageBlocked:
          type: boolean
          description: Boolean flag indicating storage blocked
        expirationDate:
          type: string
          format: date
          description: The expiration date date
      description: Detailed information for inboundshipmentposition
    InboundCommentGet:
      type: object
      properties:
        commentText:
          type: string
          description: Comment or notes
        reasonToAddImages:
          type: string
          description: Image reference
        images:
          type: array
          items:
            $ref: '#/components/schemas/InboundImageGet'
          description: Image reference
      description: Response object containing inboundcomment details
    InboundImageGet:
      type: object
      properties:
        id:
          type: string
          description: The unique identifier for the id
        url:
          $ref: '#/components/schemas/Link'
      description: Response object containing inboundimage details
    GroupedInboundShipmentPosition:
      type: object
      properties:
        warehouseSku:
          type: string
          description: Stock Keeping Unit (SKU) identifier
        sellerSku:
          type: string
          description: Stock Keeping Unit (SKU) identifier
        quantity:
          type: integer
          format: int32
          description: Quantity or amount
        lot:
          type: string
          description: The lot value
        expirationDate:
          type: string
          format: date-time
          description: The expiration date date
      description: 'The '
    Link:
      type: object
      properties:
        link:
          type: string
          description: Link or URL reference
      description: URL link reference. Contains link URL and optional metadata.

````