Upload a file.

Privileges: GAIA_MODIFY

Uploads a single file to the backend for on-demand dataset creation.
The file content is streamed as binary data (application/octet-stream) in the request body.
File metadata must be provided via HTTP headers:

  • X-File-Name: The original filename (required)
  • X-File-Path: The full file path preserving directory structure (optional)
  • X-File-Size: The file size in bytes (required)
  • X-Upload-Session-ID: The upload session ID to group files uploaded together (required)

The uploaded file will be stored in the configured object store (S3 or Azure Blob Storage)
and associated with the dataset.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Raw binary file content.

Headers
string
required

Original file name (e.g., abc.pdf).

string

Specifies the full file path preserving directory structure. This is only applicable for a direct folder upload. For a single file upload, this will be the same as the file name. Example: "reports/Q4/financial_report.pdf"

int64
required

File size in bytes.

uuid
required

Upload session ID to group files uploaded together in the same batch. All files uploaded with the same session ID will be grouped together.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json