Remove POS Invoice Item (v1)
Method & Path
DELETE /v1/workspace/:workspaceId/pos/invoices/:invoiceId/items/:itemIndex
Actual backend path: /v1/workspace/:workspaceId/pos/invoices/:invoiceId/items/:itemIndex
Description
Remove a line item from a draft POS invoice. itemIndex is the zero-based index of the item in the invoice's items array. Only draft invoices can be modified.
Authentication
Required: JWT in Authorization header.
Required permissions: store.orders.manage
Persona: Workspace Owner, Staff (store.orders.manage)
Headers
| Header | Type | Required | Description |
|---|---|---|---|
Authorization | string | Yes | Bearer token: Bearer <token> |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
workspaceId | string | Yes | Workspace identifier |
invoiceId | string | Yes | POS invoice ID |
itemIndex | number | Yes | Zero-based index of the item in items |
Response 200 OK
Returns the updated invoice without the removed item and recalculated subtotal and total.
Common Errors
- 400 Bad Request: Invoice not in draft
- 401 Unauthorized: Missing or invalid authentication token
- 403 Forbidden: Insufficient permissions (requires
store.orders.manage) - 404 Not Found: Workspace, invoice, or item index not found
- 500 Internal Server Error: Server error