Skip to main content

Files

Input files (attached to the run) and output files (published by the execution).

CommandHTTPDescription
files listGET /v1/filesList files
files createPOST /v1/filesStart an input file upload
files getGET /v1/files/{id}Get file details
files confirmPOST /v1/files/{id}/confirmConfirm the upload (pending → uploaded)
files downloadGET /v1/files/{id}/downloadTemporary download URL

Examples​

--params carries query and path parameters (id, page, filters); --json carries the request body; --fields limits the fields that come back — worth using on every list/get to save context. See Global flags for the full reference.

# List files
kobana kadu files list --fields "id"

# Start an input file upload
kobana kadu files create \
--json '{"task_id": "TASK_ID", "filename": "FILENAME", "size_bytes": 0}'

# Get file details
kobana kadu files get --params '{"id": "FILE_ID"}'

# Confirm the upload (pending → uploaded)
kobana kadu files confirm --params '{"id": "FILE_ID"}'

# Temporary download URL
kobana kadu files download --params '{"id": "FILE_ID"}'

Next steps​