Update Order

PUT

https://v3.mangoteeprints.com/api/public/v1/orders/{order_id}

Last modified:2025-09-17 09:06:54

Update order.

Required permission: update:orders

Only allows updating certain fields and when order is not processed yet.
When updating items, label_url or shipping_method, will automatically:

Recalculate cost

Convert print files (if needed)

Convert label (if needed)

Request

Path Params

Header Params

Body Params application/json

Example

{
    "address_line_1": "456 Broadway",
    "city": "Los Angeles",
    "country": "United States",
    "email": "janesmith@example.com",
    "facility": "SJ",
    "first_name": "Jane",
    "items": [
        {
            "inserts": [],
            "preview_files": [
                {
                    "key": "",
                    "url": "https://example.com/updated_preview_file"
                }
            ],
            "print_files": [
                {
                    "key": "front",
                    "url": "https://example.com/updated_print_file"
                }
            ],
            "production_config": "large",
            "quantity": 1,
            "sku": "SKU002"
        }
    ],
    "label_url": "https://example.com/label/express-priority.pdf",
    "last_name": "Smith",
    "note": "Customer satisfied",
    "phone": "+1-555-987-6543",
    "shipping_method": "express",
    "state": "CA",
    "tracking_number": "1Z999AA1234567890",
    "zip": "90001"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://v3.mangoteeprints.com/api/public/v1/orders/' \
--header 'X-API-Key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "address_line_1": "456 Broadway",
    "city": "Los Angeles",
    "country": "United States",
    "email": "janesmith@example.com",
    "facility": "SJ",
    "first_name": "Jane",
    "items": [
        {
            "inserts": [],
            "preview_files": [
                {
                    "key": "",
                    "url": "https://example.com/updated_preview_file"
                }
            ],
            "print_files": [
                {
                    "key": "front",
                    "url": "https://example.com/updated_print_file"
                }
            ],
            "production_config": "large",
            "quantity": 1,
            "sku": "SKU002"
        }
    ],
    "label_url": "https://example.com/label/express-priority.pdf",
    "last_name": "Smith",
    "note": "Customer satisfied",
    "phone": "+1-555-987-6543",
    "shipping_method": "express",
    "state": "CA",
    "tracking_number": "1Z999AA1234567890",
    "zip": "90001"
}'

Responses

🟢200Successful Response

application/json

Body

Example

{
    "code": "ORDER_UPDATED",
    "data": {
        "address_line_1": "456 New Street",
        "address_line_2": "Apt 200",
        "city": "Los Angeles",
        "country": "US",
        "email": "john.updated@example.com",
        "first_name": "John Updated",
        "id": "2bf824c3-7f14-41a1-a523-0972c18bd119",
        "last_name": "Doe Updated",
        "note": "Updated delivery instructions",
        "order_id": "ORD005",
        "phone": "+1-555-999-8888",
        "state": "CA",
        "status": "new_order",
        "updated_at": "2025-08-20T17:00:00.000000",
        "zip": "90001"
    },
    "message": "Order updated successfully",
    "request_id": "770fa600-a49d-63f6-c938-668877662222",
    "status": true,
    "timestamp": "2025-08-20T17:00:00.000000"
}

🟠422Validation Error

Modified at 2025-09-17 09:06:54

Get Order Detail

Delete Order