iotoms Docs

Delete a unit of measure

DELETE
/api/v1/catalog/uom/{id}

Deletes a unit of measure. Returns 409 UOM_IN_USE if any item still references it.

How to use it

  1. Get the unit ID from List units of measure and check inUse is false.
  2. The unit is removed permanently; if any item still uses it the call returns 409 UOM_IN_USE, so deactivate it with Update a unit of measure instead.

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Path Parameters

id*string

ID of the record (UUID).

Formatuuid

Header Parameters

X-TenantID*string

Your merchant's tenant code — the value typed in the Domain field on the iotoms login screen. See Concepts.

Response Body

OK

*/*
  1. response
status*string

Outcome of the call: SUCCESS when it worked, ERROR when it failed.

message*string

Short human-readable message describing the outcome, for example "Vendor created". Do not parse it.

data?|

Endpoint-specific payload: null when there is nothing to return (e.g. after removing a unit); for credit note PDFs it holds returnId, creditNoteNumber, templateId, templateVersion, pdfUrl and generatedAt.

Example Request
curl -X DELETE 'https://beta.iotoms.com/api/v1/catalog/uom/497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'X-TenantID: your-tenant-code'
Example Response
{  "status": "string",  "message": "string",  "data": {}}