File Manager

Güncellendi 4 Eki 2026 Markdown

Bu sayfa henüz Türkçeye çevrilmedi. İngilizce sürüm gösteriliyor.

DELETE /api/v1/accounts/{username}/files

Delete file

Delete a single file or directory. The path query parameter is required.

Path parameters:

Name Type Required Notes
username string yes —

Query parameters:

Name Type Required Notes
path string no —

Responses:

Status Schema Description
200 ApiSuccess_dict_str__Any__ Successful Response
422 HTTPValidationError Validation Error

Response example (200):

JSON
{
  "data": {},
  "message": "",
  "status": "success",
  "warnings": [
    "string"
  ]
}

cURL example:

kabuk
curl -X DELETE \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  https://your-server:2000/api/v1/accounts/{username}/files

GET /api/v1/accounts/{username}/files

List files

List files and directories under the account's home tree.

Path parameters:

Name Type Required Notes
username string yes —

Query parameters:

Name Type Required Notes
path string no —
show_hidden boolean no —

Responses:

Status Schema Description
200 ApiSuccess_dict_str__Any__ Successful Response
422 HTTPValidationError Validation Error

Response example (200):

JSON
{
  "data": {},
  "message": "",
  "status": "success",
  "warnings": [
    "string"
  ]
}

cURL example:

kabuk
curl -X GET \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  https://your-server:2000/api/v1/accounts/{username}/files

POST /api/v1/accounts/{username}/files

Create file or directory

Create a new file (with optional content) or directory.

Path parameters:

Name Type Required Notes
username string yes —

Body fields:

Field Type Required Notes
content string no —
path string yes —
type string no default file; enum: file, directory

Request body example:

JSON
{
  "content": "string",
  "path": "string",
  "type": "file"
}

Responses:

Status Schema Description
200 ApiSuccess_dict_str__Any__ Successful Response
422 HTTPValidationError Validation Error

Response example (200):

JSON
{
  "data": {},
  "message": "",
  "status": "success",
  "warnings": [
    "string"
  ]
}

cURL example:

kabuk
curl -X POST \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  -H "Content-Type: application/json" \
  -d @body.json \
  https://your-server:2000/api/v1/accounts/{username}/files

PUT /api/v1/accounts/{username}/files

Edit file

Overwrite a file's content, optionally creating a backup beforehand.

Path parameters:

Name Type Required Notes
username string yes —

Body fields:

Field Type Required Notes
content string yes —
create_backup boolean no default False
encoding string no default utf-8; enum: utf-8, latin-1
path string yes —

Request body example:

JSON
{
  "content": "string",
  "create_backup": false,
  "encoding": "utf-8",
  "path": "string"
}

Responses:

Status Schema Description
200 ApiSuccess_dict_str__Any__ Successful Response
422 HTTPValidationError Validation Error

Response example (200):

JSON
{
  "data": {},
  "message": "",
  "status": "success",
  "warnings": [
    "string"
  ]
}

cURL example:

kabuk
curl -X PUT \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  -H "Content-Type: application/json" \
  -d @body.json \
  https://your-server:2000/api/v1/accounts/{username}/files

POST /api/v1/accounts/{username}/files/compress

Compress files

Compress one or more paths into a tar.gz or zip archive.

Path parameters:

Name Type Required Notes
username string yes —

Body fields:

Field Type Required Notes
destination string yes —
format string no default tar.gz
paths array yes —

Request body example:

JSON
{
  "destination": "string",
  "format": "tar.gz",
  "paths": [
    "string"
  ]
}

Responses:

Status Schema Description
200 ApiSuccess_dict_str__Any__ Successful Response
422 HTTPValidationError Validation Error

Response example (200):

JSON
{
  "data": {},
  "message": "",
  "status": "success",
  "warnings": [
    "string"
  ]
}

cURL example:

kabuk
curl -X POST \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  -H "Content-Type: application/json" \
  -d @body.json \
  https://your-server:2000/api/v1/accounts/{username}/files/compress

GET /api/v1/accounts/{username}/files/content

Read file content

Return the textual content and metadata of a file.

Path parameters:

Name Type Required Notes
username string yes —

Query parameters:

Name Type Required Notes
path string yes —

Responses:

Status Schema Description
200 ApiSuccess_dict_str__Any__ Successful Response
422 HTTPValidationError Validation Error

Response example (200):

JSON
{
  "data": {},
  "message": "",
  "status": "success",
  "warnings": [
    "string"
  ]
}

cURL example:

kabuk
curl -X GET \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  https://your-server:2000/api/v1/accounts/{username}/files/content

POST /api/v1/accounts/{username}/files/copy

Copy file

Copy a file or directory (single via source, batch via sources).

Path parameters:

Name Type Required Notes
username string yes —

Body fields:

Field Type Required Notes
destination string yes —
overwrite boolean no default False
source string no —
sources array no —

Request body example:

JSON
{
  "destination": "string",
  "overwrite": false,
  "source": "string",
  "sources": [
    "string"
  ]
}

Responses:

Status Schema Description
200 ApiSuccess_Any_ Successful Response
422 HTTPValidationError Validation Error

Response example (200):

JSON
{
  "data": null,
  "message": "",
  "status": "success",
  "warnings": [
    "string"
  ]
}

cURL example:

kabuk
curl -X POST \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  -H "Content-Type: application/json" \
  -d @body.json \
  https://your-server:2000/api/v1/accounts/{username}/files/copy

POST /api/v1/accounts/{username}/files/delete

Batch delete

Delete multiple files or directories in one request; returns per-path results.

Path parameters:

Name Type Required Notes
username string yes —

Body fields:

Field Type Required Notes
paths array yes —

Request body example:

JSON
{
  "paths": [
    "string"
  ]
}

Responses:

Status Schema Description
200 ApiSuccess_Any_ Successful Response
422 HTTPValidationError Validation Error

Response example (200):

JSON
{
  "data": null,
  "message": "",
  "status": "success",
  "warnings": [
    "string"
  ]
}

cURL example:

kabuk
curl -X POST \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  -H "Content-Type: application/json" \
  -d @body.json \
  https://your-server:2000/api/v1/accounts/{username}/files/delete

GET /api/v1/accounts/{username}/files/download

Download File

Path parameters:

Name Type Required Notes
username string yes —

Query parameters:

Name Type Required Notes
path string yes —

Responses:

Status Schema Description
200 — Successful Response
422 HTTPValidationError Validation Error

cURL example:

kabuk
curl -X GET \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  https://your-server:2000/api/v1/accounts/{username}/files/download

POST /api/v1/accounts/{username}/files/download

Download Multi

Path parameters:

Name Type Required Notes
username string yes —

Body fields:

Field Type Required Notes
paths array yes —

Request body example:

JSON
{
  "paths": [
    "string"
  ]
}

Responses:

Status Schema Description
200 — Successful Response
422 HTTPValidationError Validation Error

cURL example:

kabuk
curl -X POST \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  -H "Content-Type: application/json" \
  -d @body.json \
  https://your-server:2000/api/v1/accounts/{username}/files/download

POST /api/v1/accounts/{username}/files/extract

Extract archive

Extract a tar/zip archive into the account's home tree.

Path parameters:

Name Type Required Notes
username string yes —

Body fields:

Field Type Required Notes
destination string no default .
path string yes —

Request body example:

JSON
{
  "destination": ".",
  "path": "string"
}

Responses:

Status Schema Description
200 ApiSuccess_dict_str__Any__ Successful Response
422 HTTPValidationError Validation Error

Response example (200):

JSON
{
  "data": {},
  "message": "",
  "status": "success",
  "warnings": [
    "string"
  ]
}

cURL example:

kabuk
curl -X POST \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  -H "Content-Type: application/json" \
  -d @body.json \
  https://your-server:2000/api/v1/accounts/{username}/files/extract

GET /api/v1/accounts/{username}/files/info

File info

Return detailed file/directory metadata (stat, permissions, owner) without reading content.

Path parameters:

Name Type Required Notes
username string yes —

Query parameters:

Name Type Required Notes
path string yes —

Responses:

Status Schema Description
200 ApiSuccess_dict_str__Any__ Successful Response
422 HTTPValidationError Validation Error

Response example (200):

JSON
{
  "data": {},
  "message": "",
  "status": "success",
  "warnings": [
    "string"
  ]
}

cURL example:

kabuk
curl -X GET \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  https://your-server:2000/api/v1/accounts/{username}/files/info

POST /api/v1/accounts/{username}/files/move

Move file

Move/rename a file or directory (single via source, batch via sources).

Path parameters:

Name Type Required Notes
username string yes —

Body fields:

Field Type Required Notes
destination string yes —
overwrite boolean no default False
source string no —
sources array no —

Request body example:

JSON
{
  "destination": "string",
  "overwrite": false,
  "source": "string",
  "sources": [
    "string"
  ]
}

Responses:

Status Schema Description
200 ApiSuccess_Any_ Successful Response
422 HTTPValidationError Validation Error

Response example (200):

JSON
{
  "data": null,
  "message": "",
  "status": "success",
  "warnings": [
    "string"
  ]
}

cURL example:

kabuk
curl -X POST \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  -H "Content-Type: application/json" \
  -d @body.json \
  https://your-server:2000/api/v1/accounts/{username}/files/move

POST /api/v1/accounts/{username}/files/permissions

Set permissions

Change file or directory permissions (chmod), optionally recursively.

Path parameters:

Name Type Required Notes
username string yes —

Body fields:

Field Type Required Notes
mode string yes —
path string yes —
recursive boolean no default False

Request body example:

JSON
{
  "mode": "string",
  "path": "string",
  "recursive": false
}

Responses:

Status Schema Description
200 ApiSuccess_dict_str__Any__ Successful Response
422 HTTPValidationError Validation Error

Response example (200):

JSON
{
  "data": {},
  "message": "",
  "status": "success",
  "warnings": [
    "string"
  ]
}

cURL example:

kabuk
curl -X POST \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  -H "Content-Type: application/json" \
  -d @body.json \
  https://your-server:2000/api/v1/accounts/{username}/files/permissions

Search files

Search the account's home tree by filename, extension, or file content.

Path parameters:

Name Type Required Notes
username string yes —

Query parameters:

Name Type Required Notes
query string no —
path string no —
type string no —
extension string no —
case_sensitive boolean no —
max_depth integer no minimum=1; maximum=50
content_query string no —

Responses:

Status Schema Description
200 ApiSuccess_dict_str__Any__ Successful Response
422 HTTPValidationError Validation Error

Response example (200):

JSON
{
  "data": {},
  "message": "",
  "status": "success",
  "warnings": [
    "string"
  ]
}

cURL example:

kabuk
curl -X GET \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  https://your-server:2000/api/v1/accounts/{username}/files/search

POST /api/v1/accounts/{username}/files/upload

Upload file

Upload a single file (multipart/form-data) to the account's home tree.

Path parameters:

Name Type Required Notes
username string yes —

Query parameters:

Name Type Required Notes
path string yes —

Body fields:

Field Type Required Notes
file string yes —

Request body example:

JSON
{
  "file": "string"
}

Responses:

Status Schema Description
200 ApiSuccess_dict_str__Any__ Successful Response
422 HTTPValidationError Validation Error

Response example (200):

JSON
{
  "data": {},
  "message": "",
  "status": "success",
  "warnings": [
    "string"
  ]
}

cURL example:

kabuk
curl -X POST \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  -H "Content-Type: application/json" \
  -d @body.json \
  https://your-server:2000/api/v1/accounts/{username}/files/upload
Hâlâ Yardıma mı İhtiyacınız Var?

Yukarıda bulamadığınız her şey için destek ekibimiz her zaman yanınızda.

Bize Ulaşın Destek Talebi Oluştur