---
title: "Import assets from external URLs"
method: POST
path: "/api/assets/import"
tags: ["assets"]
---

# Import assets from external URLs

`POST /api/assets/import`

[cloud-only] Imports one or more assets from external URLs into the cloud asset store.

## Request body

- object
  - `imports` AssetImportRequest[], required — Assets to import
    - `url` string, uri, required — URL of the asset to import
    - `name` string — Display name for the imported asset
    - `tags` string[]

## Response `200`

Import initiated

- object
  - `assets` Asset[]
    - `id` string, uuid, required — Unique identifier for the asset
    - `name` string, required — Name of the asset file
    - `hash` string, nullable — Blake3 content hash of the asset (preferred over asset_hash)
    - `asset_hash` string, nullable — Deprecated: use `hash` instead. Blake3 hash of the asset content.
    - `size` integer, required — Size of the asset in bytes
    - `width` integer, nullable — Original image width in pixels. Null for non-image assets or assets ingested before dimension extraction.
    - `height` integer, nullable — Original image height in pixels. Null for non-image assets or assets ingested before dimension extraction.
    - `mime_type` string — MIME type of the asset
    - `tags` string[] — Tags associated with the asset
    - `user_metadata` object — Custom user metadata
    - `metadata` object — System-managed metadata (read-only)
    - `preview_url` string, uri — URL for asset preview/thumbnail
    - `preview_id` string, uuid — ID of the preview asset if available
    - `prompt_id` string, uuid, nullable — Deprecated: use job_id instead. ID of the prompt that created this asset.
    - `job_id` string, uuid, nullable — ID of the job that created this asset
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `last_access_time` string, date-time
    - `is_immutable` boolean — Whether this asset is immutable

## Other responses

- `400` — Bad request
- `401` — Unauthorized

## Changes

- **2026-05-08** `c9640fded659` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/comfy-org/apis/comfyui-api/changes/api/assets/import/post.md)

---

[API](https://skmtc.dev/comfy-org/apis/comfyui-api.md) · [All operations](https://skmtc.dev/comfy-org/apis/comfyui-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/comfy-org/comfyui-api/revisions/2f69d843959c/schema)