MANGOTEEPRINTS
  1. Orders
MANGOTEEPRINTS
  • Overview
  • Change log
  • Production Lines
    • List Production Lines
      GET
  • Catalog
    • Get Catalogs
      GET
    • Get Catalog Detail
      GET
  • Products
    • Get Products
      GET
    • Get Product Detail
      GET
    • Get Product Variations
      GET
  • Orders
    • Create Order
      POST
    • List Orders
      GET
    • Get Order Detail
      GET
    • Update Order
      PUT
    • Delete Order
      DELETE
    • Cancel Order
      POST
  • Webhooks
    • Create Webhook
      POST
    • List Webhooks
      GET
    • Get Webhook
      GET
    • Update Webhook
      PUT
    • Delete Webhook
      DELETE
  • Schemas
    • Schemas
      • ShippingMethod Copy
      • CancelOrderData
      • CancelOrderResponse
      • CatalogsListData
      • CreateOrderResponse
      • FacilityType
      • GenericWebhookRequest
      • GetOrderResponse
      • GetProductionLineResponse
      • HTTPValidationError
      • InsertSchema
      • ListOrdersResponse
      • ListProductionLinesResponse
      • OrderCancelSchema
      • OrderCreateSchema
      • OrderItemResponseSchema
      • OrderItemSchema
      • OrderListData
      • OrderResponseSchema
      • OrderStatus
      • OrderUpdateSchema
      • PaginationInfo
      • PrintFileSchema
      • ProductionLineListData
      • ProductionLineSchema
      • ProductsListData
      • PublicBaseResponse
      • PublicCatalogDetailResponse
      • PublicCatalogResponse
      • PublicCatalogsListResponse
      • PublicProductDetailResponse
      • PublicProductResponse
      • PublicProductsListResponse
      • PublicVariationResponse
      • PublicVariationsListResponse
      • ShippingMethod
      • SpeedType
      • TrackingEventSchema
      • UpdateOrderResponse
      • ValidationError
      • VariationsListData
      • WebhookCreate
      • WebhookEvent
      • WebhookListResponse
      • WebhookUpdate
      • WebhookResponse
      • WebhookResponse
  1. Orders

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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
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
Previous
Get Order Detail
Next
Delete Order
Built with