v34

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

Beta

Directory Files

Upload File To Directory

Upload a file and create its directory entry in one call; unique_id / display_name default to values derived from file metadata.

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

directory_idstring required

project_idstring uuid nullable

organization_idstring uuid nullable

sessionstring nullable

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.