DokumentationAPI Reference
Subusers
Subuser erstellen, aktualisieren und entfernen. Rollen: ADMIN, DEV, CUSTOM.
GET
/servers/:id/subusersAlle 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
| Name | Type | Required | Description |
|---|---|---|---|
action | "create" | No | Standard wenn nicht angegeben |
email | string | Yes | E-Mail des Benutzers |
role | string | Yes | ADMIN, DEV, CUSTOM |
customPermissions | string[] | No | Pflicht 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
| Name | Type | Required | Description |
|---|---|---|---|
action | "update" | Yes | |
subuserId | string | Yes | Subuser ID |
role | string | No | ADMIN, DEV, CUSTOM |
customPermissions | string[] | No | Neue Berechtigungen (wenn Rolle CUSTOM) |
Subuser löschen
Body-Parameter
| Name | Type | Required | Description |
|---|---|---|---|
action | "delete" | Yes | |
subuserId | string | Yes | Subuser ID |
Fehlercodes
| HTTP | Code | Beschreibung |
|---|---|---|
| 400 | LIMIT_EXCEEDED | Subuser-Limit erreicht |
| 403 | ADDON_REQUIRED | Budget-Plan benötigt Subuser-Addon |
| 404 | USER_NOT_FOUND | Benutzer nicht gefunden |
| 409 | ALREADY_EXISTS | Subuser existiert bereits |