Finalize attachment

curl --request PATCH \
  --url https://api.managem.co.uk/seller/orders/{id}/shipments/{shipmentId}/attachments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "<string>",
  "hidden": true
}
'

{
  "id": "<string>",
  "url": "<string>",
  "hidden": true
}

Shipment attachments

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

Finalize attachment

curl --request PATCH \
  --url https://api.managem.co.uk/seller/orders/{id}/shipments/{shipmentId}/attachments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "<string>",
  "hidden": true
}
'

{
  "id": "<string>",
  "url": "<string>",
  "hidden": true
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string

required

Order ID

shipmentId

string

required

Shipment ID

Body

application/json

Image identifier to finalize upload

string

required

Image identifier

hidden

boolean

Hide attachment from the buyer

Response

Attachment saved

Image attachment linked to a shipment

string

required

Image identifier

url

string<uri>

required

Public URL for the attachment

hidden

boolean

required

True when the attachment is hidden from the buyer

Create attachment Overview