---
title: "[cloud-only] Import published assets into the caller's library"
method: POST
path: "/api/assets/import"
tags: ["assets"]
---

# [cloud-only] Import published assets into the caller's library

`POST /api/assets/import`

[cloud-only] Imports the specified published assets into the caller's asset library. New DB records reference the same storage objects; no file copying occurs. Assets the caller already owns (by hash) are deduplicated. The `id` field on each returned `AssetInfo` is the caller's newly-created private asset ID, not the published asset ID supplied in the request.

## Request body

- ImportPublishedAssetsRequest — [cloud-only] Request body for importing published assets into the caller's library.
  - `published_asset_ids` string[], required — IDs of published assets (inputs and models) to import.
  - `share_id` string, nullable — Optional. Share ID of the published workflow these assets belong to. When provided (non-null, non-empty): all `published_asset_ids` must belong to this share's workflow version; returns 400 if the share is not found or any asset does not belong to it. When omitted, null, or empty string: no share-scoped validation is performed and the assets are validated only against global rules (preserved for clients that have not yet adopted `share_id`).

## Response `200`

Successfully imported assets

- ImportPublishedAssetsResponse — [cloud-only] Response after importing published assets. Each returned `AssetInfo.id` is the caller's newly-created private asset ID, not the published asset ID supplied in the request.
  - `assets` AssetInfo[], required
    - `id` string, required
    - `filename` string, required
    - `mime_type` string
    - `size_bytes` integer

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Internal server error

## Changes

- **2026-05-22** `09a5075587c8` — 1 info
  - added the non-success response with the status `500`
- **2026-05-21** `e71f9e4d7947` — 6 breaking, 12 warning, 5 info
  - added the new required request property `published_asset_ids`
  - the `assets/items/id` response's property type/format changed from `string`/`uuid` to `string`/`` for status `200`
  - removed the required property `assets/items/created_at` from the response with the `200` status
  - removed the required property `assets/items/name` from the response with the `200` status
  - …19 more
- **2026-05-19** `751ce8e3ddf2` — 2 warning
  - removed the optional property `assets/items/height` from the response with the `200` status
  - removed the optional property `assets/items/width` from the response with the `200` status
- **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/c4db9e1283df/schema)