View .md

Power endpoints (Client API: game servers)

1 FeatherPanel Client API: game servers endpoint from user/server/power.php: methods, paths, auth, permissions, rate limits, parameters and responses.

Last synced from FeatherPanel 15b94e9 on .

On this page

Defined in backend/app/routes/user/server/power.php. Authentication used here: Server access. Read Authentication for how to send credentials and Rate limits and errors for the response envelope.

Paths, methods, permissions and rate limits come from the route file. Summaries, parameters and response codes come from the OpenAPI annotations on the controllers; endpoints without annotations show only what the route file declares.

Endpoints

POST/api/user/servers/{uuidShort}/power/{action}

Auth: Server accessDefault rate limit: 2 / minute (user-server-power)Route name: session-server-powerController: ServerPowerController::sendPowerActionroute source

Send power action to server Send a power action (start, stop, restart, kill) to a server through the Wings daemon.

ParameterInTypeRequiredDescription
uuidShortpathstringyesServer short UUID
actionpathstringyesPower action to perform

Response data: PowerActionResponse

Response data fieldTypeDescription
responseobjectResponse from Wings daemon
curl -X POST "$PANEL_URL/api/user/servers/$UUID_SHORT/power/$ACTION" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json"

Plugin events: featherpanel:server:power:action

Responses: 200 Power action sent successfully · 400 Bad request - Invalid server configuration or invalid power action · 401 Unauthorized - User not authenticated or Wings daemon unauthorized · 403 Forbidden - Access denied to server or Wings daemon · 404 Not found - Server or node not found · 422 Unprocessable entity - Invalid server data · 500 Internal server error - Failed to send power action