---
title: "Document processing (asynchronous)"
method: POST
path: "/documents/process"
tags: ["Documents"]
---

# Document processing (asynchronous)

`POST /documents/process`

Creates an asynchronous ingestion job with embedding generation.

## Request body

- DocumentProcessRequest
  - `files` union[]
    - union
      - string
      - object
        - `file_path` string
        - `enable_ocr` boolean
  - `directories` string[]
  - `d_app_id` string, required
  - `project_id` string, required
  - `chunk_size` integer
  - `chunk_overlap` integer
  - `enable_ocr` boolean
  - `batch_processing` boolean
  - `duplicate_strategy` 'skip' | 'update' | 'add' | 'sync'
  - `force_update` boolean

## Response `202`

Job created successfully

- JobAccepted
  - `job_id` string
  - `status` 'queued' | 'processing' | 'completed' | 'failed'
  - `message` string
  - `status_url` string
  - `created_at` string, date-time

## Other responses

- `400` — Invalid request
- `500` — Internal server error

## Changes

- **2026-07-14** `27f7c6c98b23` — 1 info
  - endpoint added
- **2025-11-08** `e742b1a46470` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/j-aic/apis/ib-link-apis/changes/documents/process/post.md)

---

[API](https://skmtc.dev/j-aic/apis/ib-link-apis.md) · [All operations](https://skmtc.dev/j-aic/apis/ib-link-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/j-aic/ib-link-apis/revisions/27f7c6c98b23/schema)