Reorder categories

POST/settings/categories/reorder/

write Change: creates or edits. Scopes

Saves a new display order for categories of one type, e.g. one page of the list: they swap places among themselves and the rest keep theirs. Panel operators, or staff allowed to change categories.

Body

idsstring (uuid)[]required
Categories of one type, in their new display order.

Response

200 OK

updatedintegerrequired
Categories whose place changed.

Errors

400 ids are not categories of one type (error says why).
401 No credential, or one that is wrong, expired or revoked.
403 The account, or the key's or app's scopes, may not do this.
429 Slow down: wait the seconds in the Retry-After header, then try again.

What each error means

cURL

curl -X POST 'https://panel.example.com/settings/categories/reorder/' \
  -H "Authorization: Bearer $MINIMUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "ids": [
    "3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b"
  ]
}'

Python

import os
import requests

response = requests.post(
    "https://panel.example.com/settings/categories/reorder/",
    headers={"Authorization": f"Bearer {os.environ['MINIMUS_API_KEY']}"},
    json={
        "ids": [
            "3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b"
        ]
    },
)
response.raise_for_status()
print(response.json())

JavaScript

const response = await fetch('https://panel.example.com/settings/categories/reorder/', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.MINIMUS_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "ids": [
      "3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b"
    ]
  }),
});
if (!response.ok) throw new Error(`${response.status}`);
console.log(await response.json());

Response 200

{
  "updated": 1
}

Reorder categories

Body#

Response#

200 OK

Errors#

Body

Response

Errors