v34

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

Beta

Directory Files

Add Directory File

Create a new file within the specified directory; the directory must exist in the project and file_id must reference an existing file.

post/api/v1/beta/directories/{directory_id}/files

directory_idstring required

project_idstring uuid nullable

organization_idstring uuid nullable

sessionstring nullable

file_idstring required

File ID for the storage location (required).

unique_idstring nullable

Unique identifier for the file in the directory. If not provided, will use the file's external_file_id or name.

display_namestring nullable

Display name for the file. If not provided, will use the file's name.

metadataMetadataDict

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.