5ed45d6a9e2f

OpenAPI 3.1.02026-08-08122113375.9 KB
seller-orders

Finalize attachment

Finalize a shipment attachment after direct upload.

This is step 2 of the shipment attachment workflow.

Validation pipeline:

  • Validates that imageId matches the expected shipment attachment URN.
  • Confirms shipment ownership and time-window eligibility.
  • Ensures image upload is complete (not draft).
  • Runs moderation and rejects unsuitable content.

Responses:

  • 451 when moderation rejects the image.
  • 400/403/404 for invalid ID, disabled uploads, or missing shipment.
  • Returns saved attachment metadata on success.
patch/seller/orders/{id}/shipments/{shipmentId}/attachments

Path parameters

idstring required

Order ID

Order ID

shipmentIdstring required

Shipment ID

Shipment ID

Request body

idstring required

Image identifier

hiddenboolean

Hide attachment from the buyer

Response

Attachment saved

idstring required

Image identifier

urlstring uri required

Public URL for the attachment

hiddenboolean required

True when the attachment is hidden from the buyer