Decompress Archive

​

Endpoint

POST /api/servers/:server/files/decompress

​

Authentication

​

Path Parameters

​

Request Body

​

Response

​

Example Request

curl -X POST "https://wings.example.com/api/servers/d3aac109-f0fc-4674-b5bc-199bb50e6b88/files/decompress" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "root": "/",
    "file": "backup.tar.gz"
  }'

​

Supported Archive Formats

• .tar.gz, .tgz - Gzip-compressed tar archives
• .tar - Uncompressed tar archives
• .zip - ZIP archives
• .rar - RAR archives
• .7z - 7-Zip archives
• .tar.bz2, .tbz2 - Bzip2-compressed tar archives
• .tar.xz, .txz - XZ-compressed tar archives
• .tar.lz - Lzip-compressed tar archives

​

Behavior

• Archive format is automatically detected by file extension
• Files are extracted to the same directory as the archive
• Existing files with the same name are overwritten
• Directory structure within the archive is preserved
• File permissions and timestamps are preserved
• Archive file is automatically deleted after successful extraction
• Path traversal is prevented (archives cannot extract outside server directory)

​

Error Responses

​

Use Cases

• Restore world backups
• Install plugin packs
• Extract uploaded archives
• Restore server snapshots
• Deploy pre-packaged configurations

​

Source Reference