Update Purchase order

Updates an existing purchase order.

PUThttps://api.tracksales.co/api/v1/purchase-orders/{uuid}

Required scope: purchase_orders:update

Path Params

uuidstringrequired

Purchase order UUID

Body Params

vendorIdstringrequired

Vendor UUID

itemsarrayrequired

Line items

Responses

200OK

Request succeeded.

401Unauthorized

API key is missing or invalid.

403Forbidden

API key lacks the required scope.

404Not Found

Purchase order was not found.

422Validation Error

Request validation failed.

curl -X PUT 'https://api.tracksales.co/api/v1/purchase-orders/{uuid}' \
  -H 'Authorization: Bearer ts_live_YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"vendorId":8,"date":"2026-07-01","items":[{"itemId":101,"quantity":10,"unitPrice":800}]}'

{
    "success": true,
    "data": {
        "purchase_order_id": 501,
        "vendorId": 8,
        "total": 8000,
        "status": "open"
    }
}

{
    "success": false,
    "error": {
        "code": "unauthenticated",
        "message": "Invalid or revoked API key."
    }
}

{
    "success": false,
    "error": {
        "code": "forbidden",
        "message": "API key lacks required scope."
    }
}

{
    "success": false,
    "message": "Purchase order not found"
}

{
    "success": false,
    "message": "Validation failed",
    "errors": {
        "field": [
            "The field is required."
        ]
    }
}