Set the permissions given to a user

PUT/auth/users/{id}/permissions/

manage Delete and money: deletes, credits, servers or panel settings. Scopes

Replace the permissions given to the account itself (its groups' stay) and answer the full list again. You can give only permissions you hold. Needs the permission to change users.

Path parameters

idstring (uuid)required

Body

permission_idsinteger[]required
Every permission given to the account itself (not through a group). An empty list clears them.

Response

200 OK

categorystringrequired
The area the permission belongs to, as app.model.
modelstringrequired
appstringrequired
permissionsobject[]required
- idintegerrequired
- namestringrequired
- codenamestringrequired
- sourcestringrequired
  Where the account gets it: only a direct one can be taken away here.
  - group - From a group
  - direct - Given to the account
  - both - Both

Errors

400 Something sent is not valid. Each field that is wrong is named with what is wrong.
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.
404 Nothing with this id, or nothing the account can see.
429 Slow down: wait the seconds in the Retry-After header, then try again.

What each error means

cURL

curl -X PUT 'https://panel.example.com/auth/users/1/permissions/' \
  -H "Authorization: Bearer $MINIMUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "permission_ids": [
    1
  ]
}'

Python

import os
import requests

response = requests.put(
    "https://panel.example.com/auth/users/1/permissions/",
    headers={"Authorization": f"Bearer {os.environ['MINIMUS_API_KEY']}"},
    json={
        "permission_ids": [
            1
        ]
    },
)
response.raise_for_status()
print(response.json())

JavaScript

const response = await fetch('https://panel.example.com/auth/users/1/permissions/', {
  method: 'PUT',
  headers: { Authorization: `Bearer ${process.env.MINIMUS_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "permission_ids": [
      1
    ]
  }),
});
if (!response.ok) throw new Error(`${response.status}`);
console.log(await response.json());

Response 200

[
  {
    "category": "string",
    "model": "string",
    "app": "string",
    "permissions": [
      {
        "id": 1,
        "name": "Channel A",
        "codename": "string",
        "source": {
          "0": "g",
          "1": "r",
          "2": "o",
          "3": "u",
          "4": "p"
        }
      }
    ]
  }
]

Set the permissions given to a user

Path parameters#

Body#

Response#

200 OK

Errors#

Path parameters

Body

Response

Errors