DokumentationAPI Reference

Subusers

Subuser erstellen, aktualisieren und entfernen. Rollen: ADMIN, DEV, CUSTOM.

GET/servers/:id/subusers

Alle Subuser des Servers auflisten.

curl "https://www.mado-hosting.com/api/v1/servers/srv_abc123/subusers" \
  -H "Authorization: Bearer rsk_your_key"

Subuser erstellen

Limit-checked: Subuser-Limit je nach Plan
Requires extra_subusers (Budget benötigt Addon) or Premium plan

Body-Parameter

NameTypeRequiredDescription
action"create"NoStandard wenn nicht angegeben
emailstringYesE-Mail des Benutzers
rolestringYesADMIN, DEV, CUSTOM
customPermissionsstring[]NoPflicht wenn Rolle CUSTOM (Berechtigungs-Scopes)
curl -X POST "https://www.mado-hosting.com/api/v1/servers/srv_abc123/subusers" \
  -H "Authorization: Bearer rsk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "role": "DEV"
  }'

Subuser aktualisieren

Body-Parameter

NameTypeRequiredDescription
action"update"Yes
subuserIdstringYesSubuser ID
rolestringNoADMIN, DEV, CUSTOM
customPermissionsstring[]NoNeue Berechtigungen (wenn Rolle CUSTOM)

Subuser löschen

Body-Parameter

NameTypeRequiredDescription
action"delete"Yes
subuserIdstringYesSubuser ID

Fehlercodes

HTTPCodeBeschreibung
400LIMIT_EXCEEDEDSubuser-Limit erreicht
403ADDON_REQUIREDBudget-Plan benötigt Subuser-Addon
404USER_NOT_FOUNDBenutzer nicht gefunden
409ALREADY_EXISTSSubuser existiert bereits