---
title: "Create import job"
method: POST
path: "/import/import-create"
tags: ["Document AI — Import & Migration"]
---

# Create import job

`POST /import/import-create`

## Request

- Base URL: `https://api.paperoffice.ai/latest`
- URL: `https://api.paperoffice.ai/latest/import/import-create`
- Auth: HTTP bearer

Create an import job.

## Request body

- object
  - `workspace_id` integer, required: Target workspace into which the files will be imported
  - `source_type` 'sftp' | 'local_upload' | 'watchfolder', required: Import source: sftp, local_upload, or watchfolder.
  - `source_config` object, required: Source-specific connection object (see endpoint description).
  - `include_subfolders` boolean: Include subfolders (default: true)
  - `file_pattern` string: File filter pattern, e.g. "*.pdf" (default: "*")
  - `ai_processing` boolean: Enable AI processing (derived from workspace setting if omitted)
  - `ai_tier` 'basic' | 'premium' | 'ultra': AI processing tier (basic, premium, ultra)
  - `max_file_size_mb` integer: Optional max file size in MB (default server limit).
  - `processing_lane` 'no_sla' | 'sla_24h' | 'sla_12h' | 'sla_6h' | 'sla_1h' | 'instant': Start-SLA lane (wait-to-start guarantee, not completion). Values: no_sla (fair use ×1), sla_24h (×1.5), sla_12h (×2), sla_6h (×3), sla_1h (×4), instant (×5 interactive start). Prefer this over legacy numeric priority. If omitted: workspace default_processing_lane, else no_sla.

## Response `200`

Success

- object: Import-Job erstellt
  - `status` 'success' | 'error': Request status (ok/error)
  - `message` string: Status message
  - `import` object: Import
    - `import_id` string: Import id
    - `status` 'pending' | 'scanning' | 'processing' | 'completed' | 'failed' | 'cancelled': Request status (ok/error)
    - `total_files` integer: Total number of files
    - `processed_files` integer: Processed files
    - `failed_files` integer: Failed files
    - `progress_percent` number: Progress percent
    - `created_at` string, date-time: Erstellungszeitpunkt
  - `processing_time` string: Request processing time (e.g. "123.45ms")

## Other responses

- `4XX`: Error
- `5XX`: Error

---

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