---
title: "Create Extract Task"
method: POST
path: "/tasks/extract"
tags: ["Tasks"]
---

# Create Extract Task

`POST /tasks/extract`

Queues a document/parsed task for extraction and returns a `TaskResponse` with the
assigned `task_id`, initial configuration, file metadata, and timestamps.
The initial status is `Starting`.

Creates an extract task and returns its metadata immediately.

## Request body

- CreateExtractForm
  - `parse_configuration` ParseConfiguration
    - `chunk_processing` ChunkProcessing — Controls the setting for the chunking and post-processing of each chunk.
      - `ignore_headers_and_footers` boolean, nullable — DEPRECATED: use `segment_processing.ignore` instead
      - `target_length` integer — The target number of words in each chunk. If 0, each chunk will contain a single segment.
      - `tokenizer` union — Specifies which tokenizer to use for the chunking process. This type supports two ways of specifying a tokenizer: 1. Using a predefined tokenizer from the `Tokenizer` enum 2. Using any Hugging Face tokenizer by providing its model ID as a string (e.g. "facebook/bart-large", "Qwen/Qwen-tokenizer", etc.) When using a string, any valid Hugging Face tokenizer ID can be specified, which will be loaded using the Hugging Face tokenizers library.
        - object — Use one of the predefined tokenizer types
          - `Enum` 'Word' | 'Cl100kBase' | 'XlmRobertaBase' | 'BertBaseUncased', required — Common tokenizers used for text processing. These values represent standard tokenization approaches and popular pre-trained tokenizers from the Hugging Face ecosystem.
        - object — Use any Hugging Face tokenizer by specifying its model ID Examples: "Qwen/Qwen-tokenizer", "facebook/bart-large"
          - `String` string, required — Use any Hugging Face tokenizer by specifying its model ID Examples: "Qwen/Qwen-tokenizer", "facebook/bart-large"
    - `error_handling` 'Fail' | 'Continue' — Controls how errors are handled during processing: - `Fail`: Stops processing and fails the task when any error occurs - `Continue`: Attempts to continue processing despite non-critical errors (eg. LLM refusals etc.)
    - `ocr_strategy` 'All' | 'Auto' — Controls the Optical Character Recognition (OCR) strategy. - `All`: Processes all pages with OCR. (Latency penalty: ~0.5 seconds per page) - `Auto`: Selectively applies OCR only to pages with missing or low-quality text. When text layer is present the bounding boxes from the text layer are used.
    - `pipeline` 'Azure' | 'Chunkr'
    - `segment_processing` SegmentProcessing — Configuration for how each document segment is processed and formatted. Each segment has sensible defaults, but you can override specific settings: - `format`: Output as `Html` or `Markdown` - `strategy`: `Auto` (rule-based), `LLM` (AI-generated), or `Ignore` (skip) - `crop_image`: Whether to crop images to segment bounds - `extended_context`: Use full page as context for LLM processing - `description`: Generate descriptions for segments **Defaults per segment type:** Check the documentation for more details. Only specify the fields you want to change - everything else uses the defaults.
      - `Caption` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
        - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
        - `description` boolean, nullable — Generate LLM descriptions for this segment
        - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
        - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
        - `llm` string, nullable
        - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
      - `Footnote` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
        - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
        - `description` boolean, nullable — Generate LLM descriptions for this segment
        - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
        - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
        - `llm` string, nullable
        - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
      - `FormRegion` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
        - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
        - `description` boolean, nullable — Generate LLM descriptions for this segment
        - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
        - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
        - `llm` string, nullable
        - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
      - `Formula` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
        - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
        - `description` boolean, nullable — Generate LLM descriptions for this segment
        - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
        - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
        - `llm` string, nullable
        - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
      - `GraphicalItem` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
        - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
        - `description` boolean, nullable — Generate LLM descriptions for this segment
        - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
        - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
        - `llm` string, nullable
        - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
      - `Legend` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
        - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
        - `description` boolean, nullable — Generate LLM descriptions for this segment
        - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
        - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
        - `llm` string, nullable
        - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
      - `LineNumber` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
        - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
        - `description` boolean, nullable — Generate LLM descriptions for this segment
        - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
        - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
        - `llm` string, nullable
        - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
      - `ListItem` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
        - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
        - `description` boolean, nullable — Generate LLM descriptions for this segment
        - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
        - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
        - `llm` string, nullable
        - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
      - `Page` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
        - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
        - `description` boolean, nullable — Generate LLM descriptions for this segment
        - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
        - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
        - `llm` string, nullable
        - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
      - `PageFooter` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
        - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
        - `description` boolean, nullable — Generate LLM descriptions for this segment
        - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
        - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
        - `llm` string, nullable
        - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
      - `PageHeader` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
        - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
        - `description` boolean, nullable — Generate LLM descriptions for this segment
        - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
        - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
        - `llm` string, nullable
        - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
      - `PageNumber` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
        - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
        - `description` boolean, nullable — Generate LLM descriptions for this segment
        - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
        - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
        - `llm` string, nullable
        - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
      - `Picture` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
        - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
        - `description` boolean, nullable — Generate LLM descriptions for this segment
        - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
        - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
        - `llm` string, nullable
        - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
      - `Table` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
        - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
        - `description` boolean, nullable — Generate LLM descriptions for this segment
        - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
        - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
        - `llm` string, nullable
        - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
      - `Text` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
        - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
        - `description` boolean, nullable — Generate LLM descriptions for this segment
        - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
        - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
        - `llm` string, nullable
        - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
      - `Title` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
        - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
        - `description` boolean, nullable — Generate LLM descriptions for this segment
        - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
        - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
        - `llm` string, nullable
        - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
      - `Unknown` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
        - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
        - `description` boolean, nullable — Generate LLM descriptions for this segment
        - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
        - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
        - `llm` string, nullable
        - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
    - `segmentation_strategy` 'LayoutAnalysis' | 'Page' — Controls the segmentation strategy: - `LayoutAnalysis`: Analyzes pages for layout elements (e.g., `Table`, `Picture`, `Formula`, etc.) using bounding boxes. Provides fine-grained segmentation and better chunking. - `Page`: Treats each page as a single segment. Faster processing, but without layout element detection and only simple chunking.
  - `schema` object, required — The schema to be used for the extraction.
  - `system_prompt` string, nullable — The system prompt to be used for the extraction.
  - `expires_in` integer, nullable — The number of seconds until task is deleted. Expired tasks can **not** be updated, polled or accessed via web interface.
  - `file` string, required — The file to be extracted. Supported inputs: - `ch://files/{file_id}`: Reference to an existing file. Upload via the Files API - `http(s)://...`: Remote URL to fetch - `data:*;base64,...` or raw base64 string - `task_id`: Reference to an existing `parse`task.
  - `file_name` string, nullable — The name of the file to be extracted. If not set a name will be generated. Can not be provided if the `file` is a `task_id`.

## Response `200`

Task created successfully.

- ExtractTaskResponse
  - `completed` boolean, required — True when the task reaches a terminal state i.e. `status` is `Succeeded` or `Failed` or `Cancelled`
  - `configuration` ExtractConfiguration, required
    - `parse_configuration` ParseConfiguration
      - `chunk_processing` ChunkProcessing — Controls the setting for the chunking and post-processing of each chunk.
        - `ignore_headers_and_footers` boolean, nullable — DEPRECATED: use `segment_processing.ignore` instead
        - `target_length` integer — The target number of words in each chunk. If 0, each chunk will contain a single segment.
        - `tokenizer` union — Specifies which tokenizer to use for the chunking process. This type supports two ways of specifying a tokenizer: 1. Using a predefined tokenizer from the `Tokenizer` enum 2. Using any Hugging Face tokenizer by providing its model ID as a string (e.g. "facebook/bart-large", "Qwen/Qwen-tokenizer", etc.) When using a string, any valid Hugging Face tokenizer ID can be specified, which will be loaded using the Hugging Face tokenizers library.
          - object — Use one of the predefined tokenizer types
            - `Enum` 'Word' | 'Cl100kBase' | 'XlmRobertaBase' | 'BertBaseUncased', required — Common tokenizers used for text processing. These values represent standard tokenization approaches and popular pre-trained tokenizers from the Hugging Face ecosystem.
          - object — Use any Hugging Face tokenizer by specifying its model ID Examples: "Qwen/Qwen-tokenizer", "facebook/bart-large"
            - `String` string, required — Use any Hugging Face tokenizer by specifying its model ID Examples: "Qwen/Qwen-tokenizer", "facebook/bart-large"
      - `error_handling` 'Fail' | 'Continue' — Controls how errors are handled during processing: - `Fail`: Stops processing and fails the task when any error occurs - `Continue`: Attempts to continue processing despite non-critical errors (eg. LLM refusals etc.)
      - `ocr_strategy` 'All' | 'Auto' — Controls the Optical Character Recognition (OCR) strategy. - `All`: Processes all pages with OCR. (Latency penalty: ~0.5 seconds per page) - `Auto`: Selectively applies OCR only to pages with missing or low-quality text. When text layer is present the bounding boxes from the text layer are used.
      - `pipeline` 'Azure' | 'Chunkr'
      - `segment_processing` SegmentProcessing — Configuration for how each document segment is processed and formatted. Each segment has sensible defaults, but you can override specific settings: - `format`: Output as `Html` or `Markdown` - `strategy`: `Auto` (rule-based), `LLM` (AI-generated), or `Ignore` (skip) - `crop_image`: Whether to crop images to segment bounds - `extended_context`: Use full page as context for LLM processing - `description`: Generate descriptions for segments **Defaults per segment type:** Check the documentation for more details. Only specify the fields you want to change - everything else uses the defaults.
        - `Caption` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
          - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
          - `description` boolean, nullable — Generate LLM descriptions for this segment
          - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
          - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
          - `llm` string, nullable
          - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
        - `Footnote` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
          - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
          - `description` boolean, nullable — Generate LLM descriptions for this segment
          - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
          - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
          - `llm` string, nullable
          - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
        - `FormRegion` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
          - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
          - `description` boolean, nullable — Generate LLM descriptions for this segment
          - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
          - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
          - `llm` string, nullable
          - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
        - `Formula` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
          - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
          - `description` boolean, nullable — Generate LLM descriptions for this segment
          - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
          - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
          - `llm` string, nullable
          - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
        - `GraphicalItem` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
          - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
          - `description` boolean, nullable — Generate LLM descriptions for this segment
          - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
          - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
          - `llm` string, nullable
          - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
        - `Legend` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
          - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
          - `description` boolean, nullable — Generate LLM descriptions for this segment
          - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
          - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
          - `llm` string, nullable
          - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
        - `LineNumber` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
          - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
          - `description` boolean, nullable — Generate LLM descriptions for this segment
          - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
          - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
          - `llm` string, nullable
          - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
        - `ListItem` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
          - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
          - `description` boolean, nullable — Generate LLM descriptions for this segment
          - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
          - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
          - `llm` string, nullable
          - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
        - `Page` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
          - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
          - `description` boolean, nullable — Generate LLM descriptions for this segment
          - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
          - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
          - `llm` string, nullable
          - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
        - `PageFooter` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
          - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
          - `description` boolean, nullable — Generate LLM descriptions for this segment
          - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
          - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
          - `llm` string, nullable
          - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
        - `PageHeader` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
          - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
          - `description` boolean, nullable — Generate LLM descriptions for this segment
          - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
          - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
          - `llm` string, nullable
          - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
        - `PageNumber` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
          - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
          - `description` boolean, nullable — Generate LLM descriptions for this segment
          - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
          - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
          - `llm` string, nullable
          - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
        - `Picture` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
          - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
          - `description` boolean, nullable — Generate LLM descriptions for this segment
          - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
          - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
          - `llm` string, nullable
          - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
        - `Table` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
          - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
          - `description` boolean, nullable — Generate LLM descriptions for this segment
          - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
          - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
          - `llm` string, nullable
          - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
        - `Text` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
          - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
          - `description` boolean, nullable — Generate LLM descriptions for this segment
          - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
          - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
          - `llm` string, nullable
          - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
        - `Title` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
          - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
          - `description` boolean, nullable — Generate LLM descriptions for this segment
          - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
          - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
          - `llm` string, nullable
          - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
        - `Unknown` GenerationConfig — Controls the processing and generation for the segment. - `crop_image` controls whether to crop the file's images to the segment's bounding box. The cropped image will be stored in the segment's `image` field. Use `All` to always crop, or `Auto` to only crop when needed for post-processing. - `format` specifies the output format: `Html` or `Markdown` - `strategy` determines how the content is generated: `Auto`, `LLM`, or `Ignore` - `Auto`: Process content automatically - `LLM`: Use large language models for processing - `Ignore`: Exclude segments from final output - `description` enables LLM-generated descriptions for segments. **Note:** This uses chunkr's own VLM models and is not configurable via LLM processing configuration. - `extended_context` uses the full page image as context for LLM generation.
          - `crop_image` 'All' | 'Auto' — Controls the cropping strategy for an item (e.g. segment, chunk, etc.) - `All` crops all images in the item - `Auto` crops images only if required for post-processing
          - `description` boolean, nullable — Generate LLM descriptions for this segment
          - `extended_context` boolean, nullable — Use the full page image as context for LLM generation
          - `format` 'Html' | 'Markdown' — The format for the `content` field of a segment.
          - `llm` string, nullable
          - `strategy` 'LLM' | 'Auto' | 'Ignore' — The strategy for generating the `content` field of a segment.
      - `segmentation_strategy` 'LayoutAnalysis' | 'Page' — Controls the segmentation strategy: - `LayoutAnalysis`: Analyzes pages for layout elements (e.g., `Table`, `Picture`, `Formula`, etc.) using bounding boxes. Provides fine-grained segmentation and better chunking. - `Page`: Treats each page as a single segment. Faster processing, but without layout element detection and only simple chunking.
    - `schema` object, required — The schema to be used for the extraction.
    - `system_prompt` string, nullable — The system prompt to be used for the extraction.
  - `created_at` string, date-time, required — The date and time when the task was created and queued.
  - `expires_at` string, date-time, nullable — The date and time when the task will expire.
  - `file_info` FileInfo, required — Information about the input file.
    - `mime_type` string, nullable — The MIME type of the file.
    - `name` string, nullable — The name of the file.
    - `page_count` integer, nullable — The number of pages in the file.
    - `ss_cell_count` integer, nullable — The number of cells in the file. Only used for spreadsheets.
    - `url` string, required — The presigned URL/Base64 encoded URL of the input file.
  - `finished_at` string, date-time, nullable — The date and time when the task was finished.
  - `input_file_url` string, nullable — The presigned URL of the input file. Deprecated use `file_info.url` instead.
  - `message` string, required — A message describing the task's status or any errors that occurred.
  - `output` ExtractOutputResponse — The processed results of a document extraction task. Shapes: - `results`: JSON matching the user-provided schema. - `citations`: mirror of `results`; only leaf positions (primitive or array-of-primitives) contain a `Vec<Citation>` supporting that field. - `metrics`: mirror of `results`; only leaf positions contain a `Metrics` object for that field.
    - `citations` unknown, required
    - `metrics` unknown, required
    - `results` unknown, required
  - `parse_task_id` string, nullable — The ID of the source `parse` task that was used for extraction
  - `started_at` string, date-time, nullable — The date and time when the task was started.
  - `status` 'Starting' | 'Processing' | 'Succeeded' | 'Failed' | 'Cancelled', required — The status of the task.
  - `task_id` string, required — The unique identifier for the task.
  - `task_type` 'Parse' | 'Extract', required
  - `task_url` string, nullable — The presigned URL of the task.
  - `version_info` VersionInfo, required — Version information for the task.
    - `client_version` union, required — Represents different types of SDK clients and their versions
      - 'Legacy' — Legacy SDK without version information (< 0.3.3)
      - object — Version of the current manually-maintained SDK
        - `ManualSdk` string, required — Version of the current manually-maintained SDK
      - object — Version of the auto-generated SDK
        - `GeneratedSdk` string, required — Version of the auto-generated SDK
      - 'Unspecified' — Unspecified/raw API request without any client version headers
    - `server_version` string, required — The version of the server.

## Other responses

- `400` — Invalid request or unsupported file type
- `401` — Unauthorized
- `429` — Usage limit exceeded or rate limit exceeded
- `500` — Server error

---

[API](https://skmtc.net/chunkr/apis/chunkr-api.md) · [All operations](https://skmtc.net/chunkr/apis/chunkr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chunkr/chunkr-api/versions/cfcf1ff1cbb0/schema)
