Subusers endpoints (Client API: game servers)

GET/api/user/servers/{uuidShort}/subusers

Get server subusers Retrieve all subusers for a specific server that the user owns or has subuser access to.

curl -X GET "$PANEL_URL/api/user/servers/$UUID_SHORT/subusers" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json"

Responses: 200 Server subusers retrieved successfully · 400 Bad request - Missing or invalid UUID short · 401 Unauthorized - User not authenticated · 403 Forbidden - Access denied to server · 404 Not found - Server not found · 500 Internal server error - Failed to retrieve subusers

POST/api/user/servers/{uuidShort}/subusers

Create subuser Create a new subuser for a server by email address. The user must exist in the system and not already be a subuser for this server.

Request body: SubuserCreateRequest (application/json) · Response data: SubuserWithDetails

curl -X POST "$PANEL_URL/api/user/servers/$UUID_SHORT/subusers" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"email":""}'

Plugin events: featherpanel:user:server:subuser:created

Responses: 201 Subuser created successfully · 400 Bad request - Missing required fields, invalid email format, user not found, cannot add self, or subuser already exists · 401 Unauthorized - User not authenticated · 403 Forbidden - Access denied to server · 404 Not found - Server or user not found · 500 Internal server error - Failed to create subuser

GET/api/user/servers/{uuidShort}/subusers/permissions

Get valid permissions Retrieve the list of valid permissions that can be assigned to subusers.

Response data: PermissionsResponse

curl -X GET "$PANEL_URL/api/user/servers/$UUID_SHORT/subusers/permissions" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json"

Responses: 200 Valid permissions retrieved successfully · 400 Bad request - Missing or invalid UUID short · 401 Unauthorized - User not authenticated · 403 Forbidden - Access denied to server · 404 Not found - Server not found · 500 Internal server error - Failed to retrieve permissions

GET/api/user/servers/{uuidShort}/subusers/details

Get all subusers with details Retrieve all subusers for a server with detailed user information.

curl -X GET "$PANEL_URL/api/user/servers/$UUID_SHORT/subusers/details" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json"

Responses: 200 Subusers with details retrieved successfully · 400 Bad request - Missing or invalid UUID short · 401 Unauthorized - User not authenticated · 403 Forbidden - Access denied to server · 404 Not found - Server not found · 500 Internal server error - Failed to retrieve subusers

GET/api/user/servers/{uuidShort}/subusers/search-users

Search users for subuser Search for users by email or username to add as subusers. Excludes users who are already subusers for this server.

Response data: UserSearchResponse

curl -X GET "$PANEL_URL/api/user/servers/$UUID_SHORT/subusers/search-users?search=$SEARCH" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json"

Responses: 200 Users found successfully · 400 Bad request - Missing UUID short or search query · 401 Unauthorized - User not authenticated · 403 Forbidden - Access denied to server · 404 Not found - Server not found · 500 Internal server error - Failed to search users

GET/api/user/servers/{uuidShort}/subusers/{subuserId}

Get specific subuser Retrieve details of a specific subuser for a server that the user owns or has subuser access to.

Response data: Subuser

curl -X GET "$PANEL_URL/api/user/servers/$UUID_SHORT/subusers/$SUBUSER_ID" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json"

Responses: 200 Subuser details retrieved successfully · 400 Bad request - Missing or invalid parameters · 401 Unauthorized - User not authenticated · 403 Forbidden - Access denied to server · 404 Not found - Server or subuser not found · 500 Internal server error - Failed to retrieve subuser

DELETE/api/user/servers/{uuidShort}/subusers/{subuserId}

Delete subuser Remove a subuser from a server.

curl -X DELETE "$PANEL_URL/api/user/servers/$UUID_SHORT/subusers/$SUBUSER_ID" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json"

Plugin events: featherpanel:user:server:subuser:deleted

Responses: 200 Subuser deleted successfully · 400 Bad request - Missing or invalid parameters · 401 Unauthorized - User not authenticated · 403 Forbidden - Access denied to server · 404 Not found - Server or subuser not found · 500 Internal server error - Failed to delete subuser

GET/api/user/servers/{uuidShort}/subusers/{subuserId}/details

Get subuser with details Retrieve detailed information about a specific subuser including user and server information.

Response data: SubuserWithDetails

curl -X GET "$PANEL_URL/api/user/servers/$UUID_SHORT/subusers/$SUBUSER_ID/details" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json"

Responses: 200 Subuser details retrieved successfully · 400 Bad request - Missing or invalid parameters · 401 Unauthorized - User not authenticated · 403 Forbidden - Access denied to server · 404 Not found - Server or subuser not found · 500 Internal server error - Failed to retrieve subuser details

PATCH/api/user/servers/{uuidShort}/subusers/{subuserId}

curl -X PATCH "$PANEL_URL/api/user/servers/$UUID_SHORT/subusers/$SUBUSER_ID" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json"

Plugin events: featherpanel:user:server:subuser:updated