---
title: "Import an asset"
method: POST
path: "/assets/import"
tags: ["Assets"]
---

# Import an asset

`POST /assets/import`

**Beta** — this endpoint may change before general availability.

## Headers

- `Replo-Api-Version` '2026-08-21', required

## Request body

- object
  - `projectId` string, uuid, required
  - `url` string, uri
  - `assetFile` object
    - `download_url` string, uri, required
    - `file_id` string, required
    - `mime_type` string
    - `file_name` string
  - `name` string
  - `altText` string
  - `tags` string[]
  - `generateEmbedding` boolean

## Response `200`

Import an asset

- object
  - `success` boolean, required
  - `total` number, required
  - `successCount` number, required
  - `failureCount` number, required
  - `results` union[], required
    - union
      - object
        - `success` true, required
        - `index` number, required
        - `assetId` string
        - `objectKey` string, required
        - `isIndexed` boolean, required
        - `kind` 'image' | 'video' | 'font' | 'document' | 'audio', required — AssetType
        - `name` string, required
        - `url` string, required
        - `mimeType` string, required
        - `sizeBytes` number, required
        - `tags` string[]
        - `altText` string
        - `embeddingText` string
        - `label` string
        - `embeddingGenerated` boolean
      - object
        - `success` false, required
        - `index` number, required
        - `error` string, required

## Other responses

- `400` — Invalid request.
- `401` — Missing or invalid Replo Public API token.
- `403` — You are not authorized to access this resource.
- `404` — Not Found
- `409` — The resource is in a conflicting state.
- `429` — Too many requests. Please retry after the time indicated by the Retry-After header.
- `500` — An internal error occurred.
- `503` — Service temporarily unavailable.

---

[API](https://skmtc.dev/replo/apis/replo-public-api.md) · [All operations](https://skmtc.dev/replo/apis/replo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/replo/replo-public-api/revisions/6f031f6819f4/schema)