---
title: "Create Parse Task"
method: POST
path: "/tasks/parse"
tags: ["Tasks"]
---

# Create Parse Task

`POST /tasks/parse`

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

Creates a parse task and returns its metadata immediately.

## Request body

- CreateParseForm
  - `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.
  - `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 parsed. 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
  - `file_name` string, nullable — The name of the file to be parsed. If not set a name will be generated.

## Response `200`

Task created successfully.

- ParseTaskResponse
  - `completed` boolean, required — True when the task reaches a terminal state i.e. `status` is `Succeeded` or `Failed` or `Cancelled`
  - `configuration` ParseConfiguration, required
    - `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.
  - `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` ParseOutputResponse — The processed results of a document parsing task
    - `chunks` Chunk[], required — Collection of document chunks, where each chunk contains one or more segments
      - `chunk_id` string — The unique identifier for the chunk.
      - `chunk_length` integer, required — The total number of tokens in the `embed` field of the chunk. Calculated by the `tokenizer`.
      - `content` string, nullable — The content of the chunk. This is the text that is generated by combining the `content` field from each segment. Can be used provided as context to the LLM.
      - `embed` string, nullable — Suggested text to be embedded for the chunk. This text is generated by combining the `embed` field from each segment.
      - `segments` Segment[], required — Collection of document segments that form this chunk. When `target_chunk_length` > 0, contains the maximum number of segments that fit within that length (segments remain intact). Otherwise, contains exactly one segment.
        - `bbox` BoundingBox, required — Bounding box for an item. It is used for segments and OCR results.
          - `height` number, float, required — The height of the bounding box.
          - `left` number, float, required — The left coordinate of the bounding box.
          - `top` number, float, required — The top coordinate of the bounding box.
          - `width` number, float, required — The width of the bounding box.
        - `confidence` number, float, nullable — Confidence score of the layout analysis model
        - `content` string — Content of the segment, will be either HTML or Markdown, depending on format chosen.
        - `description` string, nullable — Description of the segment, generated by the LLM.
        - `embed` string, nullable — Embeddable content of the segment.
        - `image` string, nullable — Presigned URL to the image of the segment.
        - `llm` string, nullable — LLM representation of the segment.
        - `ocr` OCRResult[], nullable — OCR results for the segment.
          - `bbox` BoundingBox, required — Bounding box for an item. It is used for segments and OCR results.
            - `height` number, float, required — The height of the bounding box.
            - `left` number, float, required — The left coordinate of the bounding box.
            - `top` number, float, required — The top coordinate of the bounding box.
            - `width` number, float, required — The width of the bounding box.
          - `confidence` number, float, nullable — The confidence score of the recognized text.
          - `ocr_id` string — The unique identifier for the OCR result.
          - `ss_cell_ref` string, nullable — Excel-style cell reference (e.g., "A1" or "A1:B2") when OCR originates from a spreadsheet cell
          - `text` string, required — The recognized text of the OCR result.
        - `page_height` number, float, required — Height of the page/sheet containing the segment.
        - `page_number` integer, required — Page number/Sheet number of the segment.
        - `page_width` number, float, required — Width of the page/sheet containing the segment.
        - `segment_id` string, required — Unique identifier for the segment.
        - `segment_length` integer, nullable — Length of the segment in tokens.
        - `segment_type` 'Caption' | 'Footnote' | 'Formula' | 'FormRegion' | 'GraphicalItem' | 'Legend' | 'LineNumber' | 'ListItem' | 'Page' | 'PageFooter' | 'PageHeader' | 'PageNumber' | 'Picture' | 'Table' | 'Text' | 'Title' | 'Unknown' | 'SectionHeader', required — All the possible types for a segment.
        - `ss_cells` Cell[], nullable — Cells of the segment. Only used for Spreadsheets.
          - `cell_id` string, required — The cell ID.
          - `formula` string, nullable — Formula of the cell.
          - `hyperlink` string, nullable — Hyperlink URL if the cell contains a link (e.g., "https://www.chunkr.ai").
          - `range` string, required — Range of the cell.
          - `style` CellStyle
            - `align` 'Left' | 'Center' | 'Right' | 'Justify'
            - `bg_color` string, nullable — Background color of the cell (e.g., "#FFFFFF" or "#DAE3F3").
            - `font_face` string, nullable — Font face/family of the cell (e.g., "Arial", "Daytona").
            - `is_bold` boolean, nullable — Whether the cell content is bold.
            - `text_color` string, nullable — Text color of the cell (e.g., "#000000" or "red").
            - `valign` 'Top' | 'Middle' | 'Bottom' | 'Baseline'
          - `text` string, required — Text content of the cell.
          - `value` string, nullable — The computed/evaluated value of the cell. This represents the actual result after evaluating any formulas, as opposed to the raw text content. For cells with formulas, this is the calculated result; for cells with static content, this is typically the same as the text field. Example: text might show "3.14" (formatted to 2 decimal places) while value could be "3.141592653589793" (full precision).
        - `ss_header_bbox` BoundingBox — Bounding box for an item. It is used for segments and OCR results.
          - `height` number, float, required — The height of the bounding box.
          - `left` number, float, required — The left coordinate of the bounding box.
          - `top` number, float, required — The top coordinate of the bounding box.
          - `width` number, float, required — The width of the bounding box.
        - `ss_header_ocr` OCRResult[], nullable — OCR results of the header of the segment, if found. Only used for Spreadsheets.
          - `bbox` BoundingBox, required — Bounding box for an item. It is used for segments and OCR results.
            - `height` number, float, required — The height of the bounding box.
            - `left` number, float, required — The left coordinate of the bounding box.
            - `top` number, float, required — The top coordinate of the bounding box.
            - `width` number, float, required — The width of the bounding box.
          - `confidence` number, float, nullable — The confidence score of the recognized text.
          - `ocr_id` string — The unique identifier for the OCR result.
          - `ss_cell_ref` string, nullable — Excel-style cell reference (e.g., "A1" or "A1:B2") when OCR originates from a spreadsheet cell
          - `text` string, required — The recognized text of the OCR result.
        - `ss_header_range` string, nullable — Header range of the segment, if found. The header can have overlap with the `segment.range` if the table contains the header, if the header is located in a different sheet, the header range will have no overlap with the `segment.range`. Only used for Spreadsheets.
        - `ss_header_text` string, nullable — Text content of the header of the segment, if found. Only used for Spreadsheets.
        - `ss_range` string, nullable — Range of the segment in Excel notation (e.g., A1:B5). Only used for Spreadsheets.
        - `ss_sheet_name` string, nullable — Name of the sheet containing the segment. Only used for Spreadsheets.
        - `text` string — Text content of the segment. Calculated by the OCR results.
    - `file_name` string, nullable — The name of the file. Deprecated use `file_info.name` instead.
    - `mime_type` string, nullable — The MIME type of the file. Deprecated use `file_info.mime_type` instead.
    - `page_count` integer, nullable — The number of pages in the file. Deprecated use `file_info.page_count` instead.
    - `pages` Page[], nullable — The pages of the file. Includes the image and metadata for each page.
      - `dpi` number, float, nullable — DPI of the page/sheet. All cropped images are scaled to this DPI.
      - `image` string, required — The presigned URL of the page/sheet image.
      - `page_height` number, float, required — The number of pages in the file.
      - `page_number` integer, required — The number of pages in the file.
      - `page_width` number, float, required — The number of pages in the file.
      - `ss_sheet_name` string, nullable — The name of the sheet containing the page. Only used for Spreadsheets.
    - `pdf_url` string, nullable — The presigned URL of the PDF file.
  - `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)