Skip to main content

File Upload API

Uploads local data files to a named internal or external stage.


A POST to /v1/upload_to_stage uploads the file to the server stage with stream in the POST body, and returns a JSON containing the query status.

stage_name:<your-stage-name>HTTP header of the stage nameYES
upload=@<your-file-path>Path of the file you want to uploadYES


This example shows how to upload a file to a named internal stage.

  1. Create a named internal stage from MySQL client:
CREATE STAGE my_internal_stage;
  1. Download and upload the sample file:

Download books.parquet

Put books.parquet to stage
curl  -H "stage_name:my_internal_stage" -F "upload=@books.parquet" -XPUT "http://localhost:8000/v1/upload_to_stage"

Check the staged file:

LIST @my_internal_stage;
| file_name |
| books.parquet |

The file books.parquet has been uploaded to your named internal stage.