Developer Portal
Breadcrumbs

Editing of Product

Update Product

Modify details of an existing product. You can update fields such as SKUs, name, description, and HS codes.

 

Request structure

Endpoint:

PUT /api/product/{id}

URL (prod):

https://app.mailship.eu/api/product/{id}

Headers:

Authorization: Bearer YOUR_ACCESS_TOKEN
Accept: application/json

Request body:

For detailed request body specifications, please refer to our API doc.

Please note that some fields cannot be updated directly, or may require contacting our customer support.

What can be freely edited on a product:

  • Name

  • HS Code

  • Country of origin

  • Product Group

  • E-shops

  • Description

  • Customs description

  • Dimensions (your data)

  • Languages on the cover

  • Images

  • Serial number evidence flag

  • Additional work on receiving flag

  • Qualitative receiving flag


What cannot be edited:

Certain fields cannot be modified, or can only be changed under specific conditions.

We do not recommend updating the following fields.

  • Primary EAN

  • Internal SKU

  • Active flag

  • Packaging type

  • Reference numbers

  • LOT evidence flag

Request Example (cURL):

curl --location --request PUT "https://app.mailship.eu/api/product/8235e453-c520-47e6-b36c-67a93ecbbf8f6" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--header "Authorization: Bearer {{token}}" \
--data "{
    \"name\": \"test Virtual Product Dev Portal\",
    \"description\": \"test product\"
}"

Path parameter:

Parameter

Type

Required

Description

id

string

The unique product identifier. Example: 8235e453-c520-47e6-b36c-67a93ecbbf8f


Response

If successful, the API returns the updated product entity in JSON format.

See more details in the API Doc.