---
title: "Import a ComfyUI file"
method: POST
path: "/api/v1/import/comfyui"
tags: ["Assets"]
---

# Import a ComfyUI file

`POST /api/v1/import/comfyui`

## Request

- Base URL: `https://numonic.ai`
- URL: `https://numonic.ai/api/v1/import/comfyui`
- Auth: API key in header `x-api-key`

Upload a ComfyUI output (PNG, video or audio, up to 500 MB) as multipart form data and create an asset from it. Workflow metadata embedded in the file is extracted. Requires the `write` scope. For large files, use the signed-URL flow with POST /import/comfyui/confirm-upload instead.

## Response `200`

Asset created

- object
  - `success` boolean, required
  - `warning` string, nullable, required
  - `asset` object, required
    - `assetH` string, required
    - `filename` string, required
    - `fileSize` integer, required
    - `toolName` string, required
    - `storagePath` string, required
  - `metadata` object, nullable, required
  - `isVideo` boolean, required

## Other responses

- `400`: Missing file, unsupported file type, malformed body, or invalid metadata JSON
- `401`: Missing or invalid credentials
- `413`: File too large
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/numonic/apis/numonic-api.md) · [All operations](https://skmtc.dev/numonic/apis/numonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/numonic/apis/numonic-api/revisions/6c559bef1e35?raw)