---
title: "/imports"
method: POST
path: "/v1/imports"
tags: ["Imports"]
---

# /imports

`POST /v1/imports`

Create an import of an asset or asset version from a public URL

## Request body

- object
  - `sourceUrl` string — The URL to get the file content. The URL needs to be publicly accessible.
  - `fileName` string — The name of the file
  - `description` string — The description of the file
  - `ext` string — The extension of the file in bytes
  - `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 `200`

Default

- object
  - `id` string
  - `assetId` string
  - `versionId` 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)