Reorder a parameter table (tenant:settings:write)
PATCH /api/masterdata/lookups/{kind}
Module: Master data · operationId: reorderLookupEntries · Tag: Lookups · Auth: access token (Authorization: Bearer <accessToken>)
order must name every code of the table exactly once, first to last; the entries get the
sort orders 10, 20, …. When the table changed meanwhile nothing is written and the answer is
409. Emits masterdata.lookup.updated.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
kind |
path | LookupKind | yes | Parameter table (one of address-statuses, currencies, industries, payment-methods, payment-terms, salutations, shipping-types, tax-keys, units) |
Request body
application/json (required)
order(array of string, required): Every code of the table in the new order
Example:
{
"order": [
"NETTO30",
"NETTO14",
"SKONTO2_14",
"SOFORT"
]
}
Responses
- 204 Reordered
- 400 Malformed body or query parameter (
application/json) - 401 Missing, invalid or expired token (empty body)
- 403 The token lacks the permission or carries no tenant (
application/json) - 404 Not found in the caller's tenant (or merged, see
code) (application/json) - 409 Stale version or conflict with existing data (
application/json)
Example request
curl -X PATCH 'https://api.mbcom.cloud/api/masterdata/lookups/address-statuses' \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
--data '{"order":["NETTO30","NETTO14","SKONTO2_14","SOFORT"]}'