Inventory

Inventory management endpoints

Update Product Inventory

patch

Updates inventory quantities for product variants. Use external_id for synced products or product_id for unsynced products.

Authorizations

ApiKeyAuth

X-MaisonSafqa-Api-KeystringRequired

API key authentication. Pass your API key directly in the X-MaisonSafqa-Api-Key header (e.g., 'ms_test_your_api_key_here' for test environment or 'ms_live_your_api_key_here' for production environment)

Path parameters

idstringRequired

Product identifier - external_id (Shopify ID) for synced products, or product_id for unsynced products

Body

application/json

Responses

200

Inventory updated successfully

application/json

400

Validation errors

application/json

401

Unauthorized

application/json

403

Access denied

application/json

404

Product not found

application/json

429

Rate limit exceeded

application/json

patch

/products/{id}/inventory

HTTPcURLJavaScriptPython

PATCH /api/v1/products/{id}/inventory HTTP/1.1
Host: api.maisonsafqa.com
X-MaisonSafqa-Api-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 65

{
  "variants": [
    {
      "sku": "COTTON-TEE-001-S",
      "inventory_quantity": 15
    }
  ]
}

{
  "error": null,
  "results": [
    {
      "sku": "text",
      "success": true,
      "old_quantity": 1,
      "new_quantity": 1,
      "error": "text"
    }
  ],
  "message": "Inventory updated successfully"
}