Creates an inventory level record for a specified product variant at a specific location.

POST

/api/inventoryLevels

Authorization Policies Required:

md_inventory: Ensures the tenant has purchased or subscribed to the inventory module.

manage_inventory: Ensures the user has the necessary permissions to manage inventory.

Request

Header Params

Body Params application/json

Example

{
    "productVariantId": "d873c66c-df69-4ba6-8cce-d127adaee9a0",
    "productId": "50fca37a-f6ab-4131-bcd6-f660cfabc242",
    "locationId": "70015911-5aee-4516-bd9f-168a1807445c",
    "quantity": 10
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://platform.shopranos.eu/api/inventoryLevels' \
--header 'x-companyId: b3e68ad4-06c8-4e70-965b-c02b38f66ef2' \
--header 'Content-Type: application/json' \
--data-raw '{
    "productVariantId": "d873c66c-df69-4ba6-8cce-d127adaee9a0",
    "productId": "50fca37a-f6ab-4131-bcd6-f660cfabc242",
    "locationId": "70015911-5aee-4516-bd9f-168a1807445c",
    "quantity": 10
}'

Responses

🟢200OK

application/json

Body

Example

{
    "id": "string"
}

🟢201The inventory level record was successfully created.

🟠400Missing or invalid `x-companyId` header, malformed request.

🟠401Unauthorized. The user is not authenticated.

🟠403Forbidden. Either the module is not purchased or the user lacks necessary permissions.

🟠404The specified `variantId` does not exist

Modified at 2025-07-08 13:29:55

Retrieve a list of inventory levels with optional cursor-based pagination.

Retrieves the inventory level of the first location for a specified product variant.