Assignment

Update assignee for Inventory

post

Authorizations

ApiKey

AuthorizationstringRequired

Prefix the value with "ApiKey" to indicate the custom authorization type

Path parameters

inventoryIdstring · uuidRequired

Id of SKU

Example: 203a5df2-423a-43a9-bb19-1ccaf3434b91

Query parameters

assigneeTypestring · enumRequired

Keyword to search for

Example: PERSON,OFFICEPossible values:

targetIdstring · uuidRequired

The ID of the person/office to assign the item to

Example: 00000000-0000-0000-0000-000000000000

Responses

200

OK

application/json

Information about the inventory assignment

idstring · uuidRequired

The assigned object's id

Example: 371da231-5878-45b1-80a3-9113f8795c29

typestring · enumRequired

The assigned object's type

Example: PERSONPossible values:

labelstringRequired

The assigned person's email, or the assigned warehouse's name, or the assigned office's name

Example: San Francisco's office

assignedAtstring · date-timeOptional

When was this object assigned

400

Bad request

application/json

403

Forbidden

*/*

404

Not Found

*/*

post

/api/inventory/{inventoryId}/assignment

HTTPcURLJavaScriptPython

POST /api/inventory/{inventoryId}/assignment?assigneeType=PERSON&targetId=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: apipub.firstbasehq.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": "371da231-5878-45b1-80a3-9113f8795c29",
  "type": "PERSON",
  "label": "San Francisco's office",
  "assignedAt": "2026-03-06T22:16:31.914Z"
}