Quản lý File
Cập nhật File / Thư mục
Đổi tên file (edit title) hoặc đổi tên thư mục (rename folder)
Endpoint
PUT /v1/files/:id
API này dùng để cập nhật thông tin file hoặc thư mục:
- File: Đổi
title(tên file) vàdescription. - Thư mục: Đổi
title(rename folder) vàdescription.
Request Body
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
title | string | Có | Tên mới cho file hoặc thư mục |
description | string | Không | Mô tả mới (không gửi sẽ ghi đè thành rỗng) |
Ví dụ JSON (Edit title cho file)
{
"title": "logo-moi-2026.png",
"description": "Logo công ty phiên bản mới"
}Ví dụ JSON (Rename thư mục)
{
"title": "Hình ảnh chiến dịch Q2-2026",
"description": ""
}Response Schema
HTTP 200 - OK
Trả về File Object sau khi cập nhật.
Ví dụ Response
{
"id": 1234,
"company_id": 1,
"creator_id": 10,
"directory_id": 0,
"object_type": 10,
"object_id": 0,
"md5_hash": "d41d8cd98f00b204e9800998ecf8427e",
"file_path": "1/202603/1234-1234567890-1741234567.jpg",
"width": 1920,
"height": 1080,
"randomcode": "1234567890",
"title": "logo-moi-2026.png",
"description": "Logo công ty phiên bản mới",
"extension": "jpg",
"size_in_byte": 204800,
"origin": "company",
"customer_id": 0,
"status": 1,
"is_directory": 0,
"ip_address": "192.168.1.1",
"date_created": 1741234567,
"date_modified": 1741234999,
"url": "https://file.example.com/1/202603/1234-1234567890-1741234567.jpg"
}Quyền hạn (Permissions)
| Điều kiện | Mô tả |
|---|---|
file.manage | Có quyền edit bất kỳ file/thư mục nào trong công ty |
| Owner (người upload) | Nếu không có file.manage, chỉ người upload mới được edit (không giới hạn thời gian) |
Lưu ý: Nếu user không có role
file.managevà cũng không phải owner, API trả về lỗierror_not_permission.
Validation bổ sung
Khi edit thư mục (is_directory = 1)
titlekhông được để trống →error_directory_name_requiredtitlekhông được trùng tên thư mục khác trong cùng thư mục cha →error_directory_name_existed
Khi edit file (is_directory = 0)
titlekhông được để trống →error_file_name_required
Error Codes
Các lỗi validate trả HTTP 422 với body {"error": ["error_..."]}.
| Mã lỗi | Mô tả |
|---|---|
error_not_permission | Không có quyền edit file/thư mục này (không phải owner và không có role file.manage) |
error_directory_name_required | Tên thư mục không được để trống |
error_directory_name_existed | Tên thư mục đã tồn tại trong cùng thư mục cha |
error_file_name_required | Tên file không được để trống |
error_not_found | (HTTP 404) Không tìm thấy file/thư mục trong công ty hiện tại |