ConnectCloud Developers

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"]}'

View as Markdown · Interactive reference · OpenAPI