Skip to main content

Create Stock Take

POST 
/api/stock-takes

Create a new stock take.

Authentication: Requires Bearer token.

status: defaults to draft if not provided.

date_count: defaults to today if not provided.

mode: full_count (default) or adjustment.

is_initial_count: marks this as the first ever count for the warehouse.

condition: optional condition label (e.g., 'new', 'used').

items: optional array of stock take line items. Can be added later. Each item: product_id (required, must exist), qty_counted (numeric, min 0), unit_cost (optional numeric, min 0 — an explicit 0 is valid and preserved, it does not fall back to the existing cost).

warehouse_id must be a standard (non-virtual) warehouse.

Response includes deletable (boolean) and delete_blocked_reasons (string[]): a draft/open stock take is always deletable; a closed stock take is deletable only when none of its FIFO cost layers have been consumed (otherwise deletable is false and delete_blocked_reasons lists the blocking stock take items).

Request​

Responses​

Successful response