Files endpoints (Client API: game servers)

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

Get server files Retrieve directory contents for a specific server path. Lists files and directories with their properties.

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

Responses: 200 Files 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 or node not found · 500 Internal server error - Failed to fetch files

GET/api/user/servers/{uuidShort}/archive-list

List directory inside an archive Browse supported archives (zip, tar, …) on the server without extracting them.

curl -X GET "$PANEL_URL/api/user/servers/$UUID_SHORT/archive-list?file=$FILE" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json"

Responses: 200 Archive listing retrieved · 400 Bad request · 403 Forbidden · 500 Internal server error

GET/api/user/servers/{uuidShort}/search-files

Search files with advanced filters Search server files by path patterns, content text and size constraints.

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

Responses: 200 Search completed successfully · 400 Bad request · 401 Unauthorized · 403 Forbidden · 500 Internal server error

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

Get file content Retrieve the raw content of a specific file with appropriate MIME type headers.

curl -X GET "$PANEL_URL/api/user/servers/$UUID_SHORT/file?path=$PATH" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json"

Responses: 200 File content 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, node, or file not found · 500 Internal server error - Failed to fetch file

GET/api/user/servers/{uuidShort}/file-hash

Get file hashes Calculate and return hashes for a file on the server.

curl -X GET "$PANEL_URL/api/user/servers/$UUID_SHORT/file-hash?path=$PATH" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json"

Responses: 200 File hashes calculated successfully · 400 Bad request - Missing file path · 401 Unauthorized - User not authenticated · 403 Forbidden - Access denied to server · 404 Not found - Server, node, or file not found · 500 Internal server error - Failed to hash file

POST/api/user/servers/{uuidShort}/write-file

Write file content Write raw content to a file on the server. Content-Type must not be application/json. Send empty body to clear file contents.

curl -X POST "$PANEL_URL/api/user/servers/$UUID_SHORT/write-file?path=$PATH" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json"

Plugin events: featherpanel:user:server:file:saved

Responses: 200 File written successfully · 400 Bad request - Missing UUID or invalid content type · 401 Unauthorized - User not authenticated · 403 Forbidden - Access denied to server · 404 Not found - Server or node not found · 415 Unsupported media type - JSON content type not allowed · 500 Internal server error - Failed to write file

PUT/api/user/servers/{uuidShort}/rename

Rename files or folders Rename multiple files or folders on the server.

Request body: RenameRequest (application/json)

curl -X PUT "$PANEL_URL/api/user/servers/$UUID_SHORT/rename" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"files":[],"root":""}'

Plugin events: featherpanel:user:server:file:renamed

Responses: 200 Files renamed successfully · 400 Bad request - Missing UUID or invalid request body · 401 Unauthorized - User not authenticated · 403 Forbidden - Access denied to server · 404 Not found - Server or node not found · 500 Internal server error - Failed to rename files

DELETE/api/user/servers/{uuidShort}/delete-files

Delete files Delete multiple files or folders from the server. This action cannot be undone.

Request body: FileOperationRequest (application/json)

curl -X DELETE "$PANEL_URL/api/user/servers/$UUID_SHORT/delete-files" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"files":[],"root":""}'

Plugin events: featherpanel:user:server:files:deleted

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

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

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

POST/api/user/servers/{uuidShort}/trash/restore

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

POST/api/user/servers/{uuidShort}/trash/delete

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

POST/api/user/servers/{uuidShort}/trash/empty

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

POST/api/user/servers/{uuidShort}/wipe-all-files

Wipe all server files Delete all files and folders in the server root directory. This action cannot be undone.

curl -X POST "$PANEL_URL/api/user/servers/$UUID_SHORT/wipe-all-files" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json"

Plugin events: featherpanel:user:server:files:deleted

Responses: 200 All files wiped successfully · 400 Bad request - Missing UUID · 401 Unauthorized - User not authenticated · 403 Forbidden - Access denied to server or missing file.delete permission · 404 Not found - Server or node not found · 500 Internal server error - Failed to wipe files

POST/api/user/servers/{uuidShort}/copy-files

Copy files Copy multiple files or folders to a new location on the server.

Request body: CopyRequest (application/json)

curl -X POST "$PANEL_URL/api/user/servers/$UUID_SHORT/copy-files" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"files":[],"location":"","name":"","overwrite":false}'

Plugin events: featherpanel:server:files:copy

Responses: 200 Files copied successfully · 400 Bad request - Missing UUID or invalid request body · 401 Unauthorized - User not authenticated · 403 Forbidden - Access denied to server · 404 Not found - Server or node not found · 500 Internal server error - Failed to copy files

POST/api/user/servers/{uuidShort}/create-directory

Create directory Create a new directory on the server.

Request body: CreateDirectoryRequest (application/json)

curl -X POST "$PANEL_URL/api/user/servers/$UUID_SHORT/create-directory" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"name":"","path":""}'

Plugin events: featherpanel:user:server:directory:created

Responses: 200 Directory created successfully · 400 Bad request - Missing UUID or invalid request body · 401 Unauthorized - User not authenticated · 403 Forbidden - Access denied to server · 404 Not found - Server or node not found · 500 Internal server error - Failed to create directory

POST/api/user/servers/{uuidShort}/compress-files

Compress files Compress multiple files or folders into an archive.

Request body: CompressRequest (application/json)

curl -X POST "$PANEL_URL/api/user/servers/$UUID_SHORT/compress-files" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"files":[],"root":"","name":"","extension":""}'

Plugin events: featherpanel:server:file:compress

Responses: 200 Files compressed successfully · 400 Bad request - Missing UUID or invalid request body · 401 Unauthorized - User not authenticated · 403 Forbidden - Access denied to server · 404 Not found - Server or node not found · 500 Internal server error - Failed to compress files

POST/api/user/servers/{uuidShort}/decompress-archive

Decompress archive Decompress an archive file on the server.

Request body: DecompressRequest (application/json)

curl -X POST "$PANEL_URL/api/user/servers/$UUID_SHORT/decompress-archive" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"file":"","root":""}'

Plugin events: featherpanel:server:file:decompress

Responses: 200 Archive decompressed successfully · 400 Bad request - Missing UUID or invalid request body · 401 Unauthorized - User not authenticated · 403 Forbidden - Access denied to server · 404 Not found - Server or node not found · 500 Internal server error - Failed to decompress archive

POST/api/user/servers/{uuidShort}/extract-archive-selection

Extract selected paths from an archive Extract specific files or directories from an on-disk archive into a destination folder without unpacking the whole archive.

curl -X POST "$PANEL_URL/api/user/servers/$UUID_SHORT/extract-archive-selection" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"root":"","file":"","destination":"","entries":[]}'

Responses: 200 Extraction started or completed successfully · 400 Bad request · 403 Forbidden · 500 Internal server error

POST/api/user/servers/{uuidShort}/change-permissions

Change file permissions Change permissions for multiple files or folders on the server.

Request body: FileOperationRequest (application/json)

curl -X POST "$PANEL_URL/api/user/servers/$UUID_SHORT/change-permissions" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"files":[],"root":""}'

Plugin events: featherpanel:server:file:permissions

Responses: 200 File permissions changed successfully · 400 Bad request - Missing UUID or invalid request body · 401 Unauthorized - User not authenticated · 403 Forbidden - Access denied to server · 404 Not found - Server or node not found · 500 Internal server error - Failed to change permissions

POST/api/user/servers/{uuidShort}/pull-file

Pull file from URL Download a file from a URL to the server. Can run in foreground or background.

Request body: PullFileRequest (application/json)

curl -X POST "$PANEL_URL/api/user/servers/$UUID_SHORT/pull-file" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"url":"","root":"","fileName":"","foreground":false,"useHeader":false}'

Responses: 200 File pull initiated successfully · 400 Bad request - Missing UUID or invalid request body · 401 Unauthorized - User not authenticated · 403 Forbidden - Access denied to server · 404 Not found - Server or node not found · 500 Internal server error - Failed to pull file

GET/api/user/servers/{uuidShort}/downloads-list

Get downloads list Retrieve the list of active download processes for the server.

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

Responses: 200 Downloads list 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 or node not found · 500 Internal server error - Failed to get downloads list

DELETE/api/user/servers/{uuidShort}/delete-pull-process/{pullId}

Delete pull process Cancel and delete an active download process.

curl -X DELETE "$PANEL_URL/api/user/servers/$UUID_SHORT/delete-pull-process/$PULL_ID" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json"

Plugin events: featherpanel:user:server:pull:deleted

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

POST/api/user/servers/{uuidShort}/share-file

Share a server file via temp uploads Uploads a server file from Wings as a temp upload (multipart) and returns a public share URL and delete key. Large files may return a background job identifier; poll share-jobs until complete.

curl -X POST "$PANEL_URL/api/user/servers/$UUID_SHORT/share-file" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"file":"","ttl_days":0,"password":"","delete_key":"","background":false}'

Responses: 200 File shared successfully · 202 Background share started · 400 Bad request · 401 Unauthorized · 403 Forbidden · 404 Not found · 500 Internal server error

GET/api/user/servers/{uuidShort}/share-jobs

List temp upload share jobs Retrieve active temp upload share jobs for the server.

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

Responses: 200 Share jobs retrieved successfully · 401 Unauthorized · 403 Forbidden · 500 Internal server error

DELETE/api/user/servers/{uuidShort}/share-jobs/{shareId}

Cancel a temp upload share job Cancels an in-progress temp upload share job.

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

Responses: 200 Share job cancelled · 401 Unauthorized · 403 Forbidden · 500 Internal server error

GET/api/user/servers/{uuidShort}/upload-file

Get file upload URL Generate a secure one-time Wings upload URL with JWT token authentication. The browser uploads directly to Wings (multipart), avoiding PHP body/memory limits and panel proxy timeouts.

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

Responses: 200 Upload URL generated successfully · 400 Bad request - Missing UUID · 401 Unauthorized - User not authenticated · 403 Forbidden - Access denied to server · 404 Not found - Server or node not found · 500 Internal server error - Failed to generate upload URL

POST/api/user/servers/{uuidShort}/upload-file

Upload file Upload a file to the server. Content-Type must not be application/json.

curl -X POST "$PANEL_URL/api/user/servers/$UUID_SHORT/upload-file?path=$PATH" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json"

Plugin events: featherpanel:user:server:file:uploaded

Responses: 200 File uploaded successfully · 400 Bad request - Missing UUID, empty content, or invalid content type · 401 Unauthorized - User not authenticated · 403 Forbidden - Access denied to server · 404 Not found - Server or node not found · 415 Unsupported media type - JSON content type not allowed · 500 Internal server error - Failed to upload file

GET/api/user/servers/{uuidShort}/download-file

Get file download URL Generate a secure one-time Wings download URL for a server file with JWT token authentication (same pattern as backup downloads).

curl -X GET "$PANEL_URL/api/user/servers/$UUID_SHORT/download-file?path=$PATH" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json"

Responses: 200 Download URL generated successfully · 400 Bad request - Missing UUID or file path · 401 Unauthorized - User not authenticated · 403 Forbidden - Access denied to server · 404 Not found - Server, node, or file not found · 500 Internal server error - Failed to generate download URL

GET/api/user/servers/{uuidShort}/download-directory

Get directory download URL Generate a secure Wings download URL that archives and streams a directory (Calagopus).

curl -X GET "$PANEL_URL/api/user/servers/$UUID_SHORT/download-directory?path=$PATH" \
  -H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
  -H "Accept: application/json"

Responses: 200 Download URL generated successfully · 400 Bad request - Missing UUID or directory path · 401 Unauthorized - User not authenticated · 403 Forbidden - Access denied to server · 404 Not found - Server or node not found · 500 Internal server error - Failed to generate download URL · 501 Daemon feature unsupported

GET/api/user/servers/{uuidShort}/file-fingerprints

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