Upload a file to a Dataset

post

https://{fqdn}/apis/rackai.rackspace.com/v1alpha1/namespaces/{namespace}/datasets/{name}/{filePath}

Uploads a single file to the Dataset's storage directory in SeaweedFS.
The front proxy routes this request based on the x-upload-target header.

To upload an entire directory, call this endpoint once per file, preserving
the relative path in the {filePath} parameter.

After all files are uploaded, the Dataset controller verifies file presence
and (if configured) MD5 integrity, then sets status.ready = true.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

namespace

string

required

Kubernetes namespace of the resource.

name

string

required

Name of the resource.

filePath

string

required

Remote file path within the artifact's storage directory. When uploading
a directory tree, this preserves the relative path structure (e.g.
subdir/data.parquet). May contain forward slashes for nested paths;
the Envoy front proxy handles the full path via regex routing.

Body Params

Single-file upload as multipart/form-data. The file part carries the
raw file content.

file

required

The file content to upload.

Headers

x-upload-target

string

enum

required

Must be set to datasets for dataset file uploads.

Allowed:

Content-MD5

string

Hex-encoded MD5 digest of the file being uploaded. When provided, the
server verifies the uploaded file's integrity against this value during
upload. For Model and Dataset uploads, corresponds to the
spec.integrity.md5 field on the resource.

Responses

200

File uploaded successfully.

201

File created successfully.

401

Unauthorized — no or invalid bearer token provided.

403

Forbidden — the authenticated principal lacks permission.

404

Not Found — the resource does not exist.

Language

Credentials

Bearer

URL

Loading…

Response

Click Try It! to start a request and see the response here!