---
title: "/uploads"
method: POST
path: "/v1/uploads"
tags: ["Uploads"]
---

# /uploads

`POST /v1/uploads`

Upload an asset to a workspace

**Body**

- fileName - the name of the file
- ext - the extension of the file
- size - the size of the file
- mime - the mime of the file
- recordedAt - when the file was created
- parentBoardId (optional) - the parent board to create the asset under
- assetId (optional) - the parent asset to create a new version for this file under
- customFields (optional) - the list of custom fields and values to assign to the asset
- tags (optional) - the list of tags to assign to the asset version

## Request body

- object
  - `fileName` string — The name of the file
  - `ext` string — The extension of the file in bytes
  - `size` number — The size of the file
  - `mime` string — The mime of the file
  - `recordedAt` string — The date and time the file was created (ISO 8601 format)
  - `parentBoardId` string — The id of the parent board to create the asset under
  - `assetId` string — The id of the parent asset to create a new version for this file under
  - `customFields` object[] — The list of custom fields and values to assign to the asset
    - `id` string
    - `values` object[] — the list of single-select or multi-select custom field values to assign to the asset
      - `id` string
    - `value` string — the plain-text or date value to assign to the asset for the custom field
  - `tags` object[]
    - `id` string

## Response `201`

Asset created successfully

- union
  - object
    - `assetId` string
    - `versionId` string
    - `uploadUrl` string, uri
  - object
    - `assetId` string
    - `versionId` string
    - `multiPartUploadId` string
    - `key` string

---

[API](https://skmtc.net/air/apis/air-api.md) · [All operations](https://skmtc.net/air/apis/air-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/air/air-api/revisions/2bd9c9fa2a0c/schema)