Skip to main content

Delete POS Order Status (v1)

Method & Path​

DELETE /v1/workspace/:workspaceId/pos/order-statuses/:statusId

Actual backend path: /v1/workspace/:workspaceId/pos/order-statuses/:statusId

Description​

Delete a workspace-defined POS order status. Invoices that had this status will have their orderStatusId unchanged in the database (optional: backend may set to null when status is deleted; current implementation does not cascade).

Authentication​

Required: JWT in Authorization header.

Required permissions: store.orders.manage

Persona: Workspace Owner, Staff (store.orders.manage)

Path Parameters​

ParameterTypeRequiredDescription
workspaceIdstringYesWorkspace identifier
statusIdstringYesOrder status ID (MongoDB ObjectId)

Response 204 No Content​

No body.

Common Errors​

  • 401 Unauthorized: Missing or invalid authentication token
  • 403 Forbidden: Insufficient permissions
  • 404 Not Found: Workspace or order status not found
  • 500 Internal Server Error: Server error