Files

List, read, write, copy, delete, compress files and more.

GET/servers/:id/files

List directory contents.

Query Parameters

Name	Type	Required	Description
`directory`	string	No	Directory path (default: /)

curl "https://www.mado-hosting.com/api/v1/servers/srv_abc123/files?directory=/plugins" \
  -H "Authorization: Bearer rsk_your_key"

POST/servers/:id/files

Execute file operations. Action is passed as the action field in the body.

Available actions: read, write, delete, bulk_delete, copy, mkdir, rename, compress, decompress, download_url, upload_url

Read File

Body Parameters

Name	Type	Required	Description
`action`	"read"	Yes
`file`	string	Yes	File path

curl -X POST "https://www.mado-hosting.com/api/v1/servers/srv_abc123/files" \
  -H "Authorization: Bearer rsk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "action": "read", "file": "/server.properties" }'

Write File

Body Parameters

Name	Type	Required	Description
`action`	"write"	Yes
`file`	string	Yes	File path
`content`	string	Yes	File content

curl -X POST "https://www.mado-hosting.com/api/v1/servers/srv_abc123/files" \
  -H "Authorization: Bearer rsk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "action": "write", "file": "/motd.txt", "content": "Welcome!" }'

Delete File

Body Parameters

Name	Type	Required	Description
`action`	"delete"	Yes
`file`	string	Yes	File path

Bulk Delete

Body Parameters

Name	Type	Required	Description
`action`	"bulk_delete"	Yes
`root`	string	Yes	Root directory
`files`	string[]	Yes	File paths (max 100)

curl -X POST "https://www.mado-hosting.com/api/v1/servers/srv_abc123/files" \
  -H "Authorization: Bearer rsk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "action": "bulk_delete", "root": "/logs", "files": ["latest.log", "debug.log"] }'

Copy File

Body Parameters

Name	Type	Required	Description
`action`	"copy"	Yes
`location`	string	Yes	Source file path

Create Directory

Body Parameters

Name	Type	Required	Description
`action`	"mkdir"	Yes
`directory`	string	Yes	Parent directory
`name`	string	Yes	New directory name

Rename

Body Parameters

Name	Type	Required	Description
`action`	"rename"	Yes
`root`	string	Yes	Root directory
`from`	string	Yes	Current name
`to`	string	Yes	New name

Compress

Body Parameters

Name	Type	Required	Description
`action`	"compress"	Yes
`root`	string	Yes	Root directory
`files`	string[]	Yes	Files to compress
`name`	string	No	Archive name
`extension`	string	No	Format (default: zip)

Decompress

Body Parameters

Name	Type	Required	Description
`action`	"decompress"	Yes
`root`	string	Yes	Root directory
`file`	string	Yes	Archive file

Download URL

Body Parameters

Name	Type	Required	Description
`action`	"download_url"	Yes
`file`	string	Yes	File path

Upload URL

Body Parameters

Name	Type	Required	Description
`action`	"upload_url"	Yes

The upload URL is temporary. Upload the file with a PUT request to the URL.