v34

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-09194386949.7 KB

Beta

Directory Files

Update Directory File

Update directory-file metadata by directory_file_id; set directory_id to move the file to a different directory. To resolve from unique_id, list with a filter first.

patch/api/v1/beta/directories/{directory_id}/files/{directory_file_id}

Path parameters

directory_idstring required

directory_file_idstring required

Query parameters

project_idstring uuid nullable

organization_idstring uuid nullable

Cookies

sessionstring nullable

Request body

unique_idstring nullable

Updated unique identifier.

display_namestring nullable

Updated display name.

target_directory_idstring nullable

Move file to a different directory.

metadataMetadataDict

Response

Successful Response

idstring required

Unique identifier for the directory file.

created_atstring date-time nullable

Creation datetime

updated_atstring date-time nullable

Update datetime

project_idstring required

Project the directory file belongs to.

directory_idstring required

Directory the file belongs to.

unique_idstring required

Unique identifier for the file in the directory

display_namestring required

Display name for the file.

file_idstring nullable

File ID for the storage location.

metadataMetadataDict

deleted_atstring date-time nullable

Soft delete marker when the file is removed upstream or by user action.