Delete

[POST] .../v1/region/delete

Deletes region. Soft-delete a region that is no longer used by retail customers or other active workflows. The method validates id, checks region delete permission 447, verifies that the region exists, rejects deletion when retail customers still reference the region, marks the record as deleted, sends the RegionDeleted webhook and returns row_affected. The request body is required and id must be a positive region id; the operation changes catalog state and should be treated as destructive by clients. Missing body, invalid id, unknown region, existing customer references, denied permission, no changed row and storage errors are returned as HTTP 200 ErrorResult.

Request Parameters

Name Type Required Description
id Int64 Required Region ID.

Request Example

{
  "id": 12
}

Response Parameters

Name Type Description
ok Boolean Indicates whether the request completed successfully.
result Update Update operation result.

Response Example

{
  "ok": true,
  "result": {
    "row_affected": 1,
    "ids": null
  }
}