Skip to content

graft inventory

Bookable pools, availability, holds and allocations.

Command Does
graft inventory allocations delete Release an allocation.
graft inventory allocations list The allocations the master schedule reads.
graft inventory allocations update Confirm a hold, release it, or cancel a confirmed booking.
graft inventory pools availability get What is free in a time window, after buffers and existing allocations.
graft inventory pools create Make a record bookable.
graft inventory pools delete Delete a pool.
graft inventory pools get One pool.
graft inventory pools holds Place a time-limited hold on capacity so two customers can’t book the same slot.
graft inventory pools list List bookable pools.
graft inventory pools update Change quantity, buffer or auto-lock.

graft inventory allocations delete <allocationId>

Section titled “graft inventory allocations delete <allocationId>”

Release an allocation.

Endpoint: DELETE /api/v1/inventory/allocations/:allocationId · Arguments: <allocationId>

Terminal window
graft inventory allocations delete <allocationId>

Asks for confirmation; pass --yes to skip it (required in scripts).

The allocations the master schedule reads. Cursor-paginated: pass limit (default 25, max 100) and cursor from the previous response’s meta.cursor.

Endpoint: GET /api/v1/inventory/allocations

Terminal window
graft inventory allocations list

Add --all to fetch every page.

graft inventory allocations update <allocationId>

Section titled “graft inventory allocations update <allocationId>”

Confirm a hold, release it, or cancel a confirmed booking.

Endpoint: PATCH /api/v1/inventory/allocations/:allocationId · Arguments: <allocationId>

Terminal window
graft inventory allocations update <allocationId>

graft inventory pools availability get <poolId>

Section titled “graft inventory pools availability get <poolId>”

What is free in a time window, after buffers and existing allocations.

Endpoint: GET /api/v1/inventory/pools/:poolId/availability · Arguments: <poolId>

Terminal window
graft inventory pools availability get <poolId>

Make a record bookable. strategy is individual_asset (one unique unit), pooled_quantity (stock of N) or time_slot (concurrent capacity). bufferMinutes blocks turnaround time between bookings.

Endpoint: POST /api/v1/inventory/pools

Terminal window
graft inventory pools create -d '{"entityId":"000000000000000000000015","recordId":"000000000000000000000039","strategy":"pooled_quantity","totalQuantity":50,"bufferMinutes":30}'

Delete a pool.

Endpoint: DELETE /api/v1/inventory/pools/:poolId · Arguments: <poolId>

Terminal window
graft inventory pools delete <poolId>

Asks for confirmation; pass --yes to skip it (required in scripts).

One pool.

Endpoint: GET /api/v1/inventory/pools/:poolId · Arguments: <poolId>

Terminal window
graft inventory pools get <poolId>

Place a time-limited hold on capacity so two customers can’t book the same slot. A hold that would overbook is 409 CONFLICT.

Endpoint: POST /api/v1/inventory/pools/:poolId/holds · Arguments: <poolId>

Terminal window
graft inventory pools holds <poolId>

List bookable pools. Cursor-paginated: pass limit (default 25, max 100) and cursor from the previous response’s meta.cursor. Filter with entityId.

Endpoint: GET /api/v1/inventory/pools

Terminal window
graft inventory pools list

Add --all to fetch every page.

Change quantity, buffer or auto-lock.

Endpoint: PATCH /api/v1/inventory/pools/:poolId · Arguments: <poolId>

Terminal window
graft inventory pools update <poolId> -d '{"totalQuantity":60}'