Cập nhật File / Thư mục

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

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.manage và cũng không phải owner, API trả về lỗi error_not_permission.

Validation bổ sung

Khi edit thư mục (is_directory = 1)

title không được để trống → error_directory_name_required
title khô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)

title không được để trống → error_file_name_required

Error Codes

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

Cập nhật File / Thư mục

On this page