Sync Server

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/pterodactyl/wings/llms.txt

Use this file to discover all available pages before exploring further.

​

Authentication

Authorization: Bearer <token>

​

Path Parameters

​

Response

​

Error Responses

​

Behavior

1. Fetches the latest server configuration from the Panel
2. Updates the local configuration with Panel data
3. Updates disk space limits
4. Syncs environment variables and resource limits
5. If server is suspended, disconnects all websocket and SFTP clients

​

What Gets Synced

• Server configuration (build settings, limits, allocations)
• Process configuration (startup command, environment variables)
• Container configuration (Docker image)
• Suspension status
• Resource limits (memory, CPU, disk, swap)
• Environment variables
• Crash detection settings

​

Automatic Disconnection

• All open websocket connections are closed
• All SFTP connections are terminated
• JWTs remain valid but connections are refused

​

Example Request

curl -X POST https://wings.example.com/api/servers/8d3f9a2e-5c7b-4f1e-9d2a-6e8f1c3b5a7d/sync \
  -H "Authorization: Bearer your-wings-token" \
  -H "Accept: application/json"

​

Example Response

HTTP/1.1 204 No Content

​

Notes

• Sync is automatically triggered before server starts
• Manual sync can be used to update configuration without restarting
• If the server no longer exists on the Panel, a 404 error is returned
• Changes to environment variables take effect on next server start
• Resource limit changes are applied to the environment immediately
• Disk limit changes are applied to the filesystem immediately

​

Use Cases

• Apply configuration changes made in the Panel without restarting
• Update server after allocation changes
• Refresh server state after Panel modifications
• Synchronize after updating environment variables

​

Source Reference