Create a staff user

POST/auth/staff-users/

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

Create an account with dashboard access, in the groups and with the permissions given. You can give only permissions you hold, and a reseller creates resellers only.

Body

usernamestringrequired
emailstring (email)can be null
passwordstringrequired
password_confirmstringrequired
first_namestring
last_namestring
phone_numberstringcan be null
phone_country_codestringcan be null
is_staffboolean
Designates whether the user can log into this admin site.
is_activeboolean
groupsinteger[]
permissionsinteger[]

Response

201 OK

idstring (uuid)requiredread-only
usernamestringrequired
emailstring (email)can be null
first_namestring
last_namestring
phone_numberstringcan be null
phone_country_codestringcan be null
is_staffboolean
Designates whether the user can log into this admin site.
is_activeboolean
groupsinteger[]
permissionsinteger[]

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.
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/auth/staff-users/' \
  -H "Authorization: Bearer $MINIMUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "username": "alice",
  "password": "a-long-password",
  "password_confirm": "a-long-password"
}'

Python

import os
import requests

response = requests.post(
    "https://panel.example.com/auth/staff-users/",
    headers={"Authorization": f"Bearer {os.environ['MINIMUS_API_KEY']}"},
    json={
        "username": "alice",
        "password": "a-long-password",
        "password_confirm": "a-long-password"
    },
)
response.raise_for_status()
print(response.json())

JavaScript

const response = await fetch('https://panel.example.com/auth/staff-users/', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.MINIMUS_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "username": "alice",
    "password": "a-long-password",
    "password_confirm": "a-long-password"
  }),
});
if (!response.ok) throw new Error(`${response.status}`);
console.log(await response.json());

Response 201

{
  "id": "3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b",
  "username": "alice",
  "email": "[email protected]",
  "first_name": "Alice",
  "last_name": "Smith",
  "phone_number": "string",
  "phone_country_code": "string",
  "is_staff": true,
  "is_active": true,
  "groups": [
    1
  ],
  "permissions": [
    1
  ]
}

Create a staff user

Body#

Response#

201 OK

Errors#

Body

Response

Errors