PersistentAI API Documentation / @persistentai/fireflow-vfs / server / getPresignedUploadUrl

Function: getPresignedUploadUrl()

getPresignedUploadUrl(repoName, branch, path): Promise<PresignedUploadUrlResult>

Defined in: packages/fireflow-vfs/src/steps/lakefs-steps.ts:998

Get a presigned URL for direct object upload

This returns a temporary HTTP URL that clients can use to upload a file directly to the underlying object storage (S3/MinIO), bypassing the server completely.

After uploading via the presigned URL, call linkStagedObject to associate the uploaded content with the lakeFS path.

Benefits:

• No server memory usage for file content
• No event loop blocking
• Direct client-to-storage connection (faster)
• Works with any file size
• No base64 encoding needed (UTF-8 safe)

Parameters

repoName

string

lakeFS repository name

branch

string

Branch name

path

string

Target path in the repository

Returns

Promise<PresignedUploadUrlResult>

PresignedUploadUrlResult with URL, physical address, and expiration