Update Inventory Count

PUT

/api/v1/inventory-counts/:id

Updates fields on an existing inventory count session. Only fields included in the request body are modified.

Requires scope: inventory_counts:write

Authentication

API_KEYstring

API Key authentication via header

Path parameters

idUUIDRequired

Inventory count ID.

Request

This endpoint expects an object.

statusenumOptional

Updated status for the count session.

startDatedateOptional

Updated start date (ISO 8601).

dueDatedateOptional

Updated due date (ISO 8601).

assignedUserIdslist of UUIDsOptional

Replacement list of assigned user IDs. Replaces all existing assignments.

Response

This endpoint returns an object.

idUUID

Unique identifier for the inventory count.

statusenum

Current status of the count session.

periodinteger

Count period number (e.g. cycle or iteration index).

activeboolean

Whether the count session is currently active.

canceledboolean

Whether the count session has been cancelled.

assignedUserIdslist of UUIDs

IDs of users assigned to this count session.

createdAtdatetime

ISO 8601 timestamp when the session was created.

updatedAtdatetime

ISO 8601 timestamp when the session was last updated.

locationobject

Reference to the location being counted.

startDatedate

Scheduled start date for the count (ISO 8601 date, e.g. 2026-03-15).

dueDatedate

Due date for completing the count (ISO 8601 date, e.g. 2026-03-22).

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

$	curl -X PUT https://api.getply.com/api/v1/inventory-counts/a3b4c5d6-e7f8-9012-abcd-ef3456789012 \
>	-H "API_KEY: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"status": "IN_PROGRESS"
>	}'

1	{
2	"id": "a3b4c5d6-e7f8-9012-abcd-ef3456789012",
3	"status": "IN_PROGRESS",
4	"period": 1,
5	"active": true,
6	"canceled": false,
7	"assignedUserIds": [
8	"e1f2a3b4-c5d6-7890-efab-901234567890"
9	],
10	"createdAt": "2026-03-15T07:00:00Z",
11	"updatedAt": "2026-03-20T15:00:00Z",
12	"location": {
13	"id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
14	"name": "Main Warehouse"
15	},
16	"startDate": "2026-03-15",
17	"dueDate": "2026-03-22"
18	}