---
title: "Export a single asset"
method: POST
path: "/api/v1/export"
tags: ["Export"]
---

# Export a single asset

`POST /api/v1/export`

## Request

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

Export an asset with optional format conversion and privacy-aware metadata handling. Apply a disclosure preset to control what metadata is included in the exported file, matching the same presets used for publishing.

## Request body

- SingleExportRequest
  - `assetH` string, required
  - `options` ExportOptions, required
    - `preset` 'share' | 'portfolio' | 'client' | 'archive' | 'custom', required
    - `customOptions` CustomExportOptions
      - `stripWorkflow` boolean
      - `stripPrompt` boolean
      - `stripModels` boolean
      - `stripSeeds` boolean
      - `stripGPS` boolean
      - `stripPersonal` boolean
      - `stripA1111Parameters` boolean
    - `format` 'png' | 'jpeg' | 'webp' | 'preserve'
    - `iptcOptions` IptcAiOptions
      - `addIptcAi` boolean

## Response `200`

Export completed, download URL returned

- SignedUrlResponse
  - `signedUrl` string, required: Pre-signed URL for direct upload/download to storage
  - `path` string: Storage path for the file
  - `token` string: Upload token (for upload URLs)

## Other responses

- `404`: Asset not found

---

[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)