---
title: "Get Task"
method: GET
path: "/tasks/{task_id}"
tags: ["Tasks"]
---

# Get Task

`GET /tasks/{task_id}`

Retrieves the current state of a task.

Returns task details such as processing status, configuration, output (when
available), file metadata, and timestamps.

Typical uses:
- Poll a task during processing
- Retrieve the final output once processing is complete
- Access task metadata and configuration

## Path parameters

- `task_id` string, nullable, required

## Query parameters

- `base64_urls` boolean
- `include_chunks` boolean

## Response `200`

Task details.

- TaskResponse
  - `completed` boolean, required — True when the task reaches a terminal state i.e. `status` is `Succeeded` or `Failed` or `Cancelled`
  - `configuration` union, required — Unified configuration type that can represent either parse or extract configurations
    - 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.
    - ExtractConfiguration
      - `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
              - …
            - object — 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` union — Unified output type that can represent either parse or extract results
    - 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.
              - …
            - `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
              - …
            - `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.
              - …
            - `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.
    - 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 the task
  - `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

- `401` — Unauthorized
- `404` — Task not found
- `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)