POST
Upload a file

Authorizations

Authorization
string
header
required

Your Gwenlake API key, sent as Authorization: Bearer <key>.

Headers

x-user
string | null

Path Parameters

dataset_id
string
required

Query Parameters

path
string | null
mode
string
default:APPEND

Iceberg/vector write mode: APPEND, UPDATE, SNAPSHOT, or DELETE.

keys
string | null

Comma-separated key columns for the UPDATE (upsert) mode (vector datasets: default id).

delete_filter
string | null

Row-filter expression for the DELETE mode, e.g. country == 'FR'.

branch
string
default:main

Data branch to write to (default trunk 'main'): Iceberg branch or files overlay branch (created lazily on first write).

Body

multipart/form-data
file
file | null

Response

Successful Response

filename
string
required
path
string
required
file_size
integer | null
uploaded
boolean | null
default:false