---
title: "Upload CSV file"
method: POST
path: "/api/v1/uploads"
tags: ["Uploads"]
---

# Upload CSV file

`POST /api/v1/uploads`

## Response `201`

CSV uploaded successfully

- UploadCreateResponse
  - `fileName` string, required — Original file name
  - `id` string, uuid, required — Unique identifier for the upload
  - `inDbAsTableName` string, required — Database table name in the scratch schema
  - `modelId` string, uuid, required — Model ID the view was created in
  - `rowCount` integer, required — Number of rows in the uploaded file
  - `truncated` boolean, required — Whether the file was truncated due to row limit
  - `viewCreated` boolean, required — Whether a view was created in the model
  - `viewName` string, required — Name of the view created

## Other responses

- `400` — Invalid request (missing fields, invalid file type, or CSV parsing failed)
- `401` — Authentication required
- `403` — Permission denied
- `404` — Model or branch not found

---

[API](https://skmtc.net/omniapp/apis/omni-api.md) · [All operations](https://skmtc.net/omniapp/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omniapp/omni-api/versions/de7cac8b5983/schema)