---
title: "List uploads"
method: GET
path: "/api/v1/uploads"
tags: ["Uploads"]
---

# List uploads

`GET /api/v1/uploads`

## Query parameters

- `cursor` string — Cursor for pagination (from previous response nextCursor)
- `pageSize` integer — Number of results per page (1-100, integer)
- `sortDirection` 'asc' | 'desc' — Sort direction (default: desc)
- `sortField` 'createdAt' | 'fileName' | 'updatedAt' — Field to sort by (default: updatedAt)
- `connectionId` string, uuid — Filter by connection ID
- `modelId` string, uuid — Filter by model ID. Shared models return connection uploads; workbook models return their own uploads.
- `searchTerm` string — Search term to filter by file name
- `type` 'csv' | 'spreadsheet' — Filter by upload type (default: csv)

## Response `200`

List of uploads with metadata

- UploadsListResponse
  - `pageInfo` PageInfo, required
    - `hasNextPage` boolean, required — Whether more results are available
    - `nextCursor` string, nullable, required — Cursor for fetching the next page
    - `pageSize` number, required — Number of results per page
    - `totalRecords` number, required — Total number of records matching the query
  - `records` Upload[], required
    - `connection_id` string, uuid, required — Connection ID the upload is associated with
    - `created_at` string, date-time, required — When the file was uploaded
    - `file_name` string, required — Original file name
    - `id` string, uuid, required — Unique identifier for the upload
    - `in_db_as_table_name` string, nullable, required — Database table name if uploaded to database scratch schema
    - `model_id` string, uuid, nullable, required — Model ID the upload is associated with (inferred from connection's shared model if not explicitly set)
    - `size_bytes` number, nullable, required — File size in bytes
    - `updated_at` string, date-time, required — Last update timestamp
    - `uploaded_by_user` object, nullable, required — User who uploaded the file
      - `id` string, uuid, required — User ID of the uploader
      - `name` string, required — Name of the user who uploaded the file
    - `view_name` string, required — View name associated with the upload

## Other responses

- `400` — Invalid query parameters
- `401` — Authentication required
- `403` — Permission denied
- `404` — Model not found (when modelId is provided)

---

[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)