---
name: Format Converter
description: Convert files between formats using direct conversion or AI-bridged fallback via the Nexus content job API
---

# Format Converter

Convert an existing asset to a different file format. Supports direct converter paths (ffmpeg, sharp, pandoc) with AI-bridged fallback for all format pairs.

## Usage

Submit a content job via `POST /api/companies/{companyId}/content-jobs`:

```json
{
  "jobType": "convert",
  "input": {
    "sourceAssetId": "asset-uuid-here",
    "targetFormat": "pdf"
  }
}
```

**Fields:**
- `sourceAssetId` (required): UUID of the source asset already stored in Nexus
- `targetFormat` (required): Target format extension — e.g. `pdf`, `png`, `mp4`, `docx`, `svg`

## Output

The job returns a `ConvertBundle` with:
- `assetId`: ID of the converted output asset
- `targetFormat`: Format that was applied
- `method`: Conversion path used — `direct` or `ai-bridge`
