Generate Extraction Schema
Generate a JSON schema and return a product configuration request.
ParametersExpand Collapse
data_schema: Optional[Dict[str, Union[Dict[str, object], Iterable[object], str, 3 more]]]
Optional schema to validate, refine, or extend
file_id: Optional[str]
Optional file ID to analyze for schema generation
name: Optional[str]
Name for the generated configuration (auto-generated if omitted)
prompt: Optional[str]
Natural language description of the data structure to extract
ReturnsExpand Collapse
class ExtractGenerateSchemaResponse: …
Request body for creating a product configuration.
name: str
Human-readable name for this configuration.
parameters: Parameters
Product-specific configuration parameters.
class ParametersSplitV1Parameters: …
Typed parameters for a split v1 product configuration.
Categories to split documents into.
name: str
Name of the category.
description: Optional[str]
Optional description of what content belongs in this category.
product_type: Literal["split_v1"]
Product type.
splitting_strategy: Optional[ParametersSplitV1ParametersSplittingStrategy]
Strategy for splitting documents.
allow_uncategorized: Optional[Literal["include", "forbid", "omit"]]
Controls handling of pages that don't match any category. 'include': pages can be grouped as 'uncategorized' and included in results. 'forbid': all pages must be assigned to a defined category. 'omit': pages can be classified as 'uncategorized' but are excluded from results.
class ParametersExtractV2Parameters: …
Typed parameters for an extract v2 product configuration.
data_schema: Dict[str, Union[Dict[str, object], List[object], str, 3 more]]
JSON Schema defining the fields to extract. Validate with the /schema/validate endpoint first.
product_type: Literal["extract_v2"]
Product type.
cite_sources: Optional[bool]
Include citations in results
confidence_scores: Optional[bool]
Include confidence scores in results
extract_version: Optional[str]
Extract algorithm version. Use 'latest' or a date string.
extraction_target: Optional[Literal["per_doc", "per_page", "per_table_row"]]
Granularity of extraction: per_doc returns one object per document, per_page returns one object per page, per_table_row returns one object per table row
lang: Optional[str]
ISO 639-1 language code for the document
max_pages: Optional[int]
Maximum number of pages to process. Omit for no limit.
parse_config_id: Optional[str]
Saved parse configuration ID to control how the document is parsed before extraction
parse_tier: Optional[str]
Parse tier to use before extraction (fast, cost_effective, or agentic)
system_prompt: Optional[str]
Custom system prompt to guide extraction behavior
target_pages: Optional[str]
Comma-separated page numbers or ranges to process (1-based). Omit to process all pages.
tier: Optional[Literal["cost_effective", "agentic"]]
Extract tier: cost_effective (5 credits/page) or agentic (15 credits/page)
class ParametersClassifyV2Parameters: …
Typed parameters for a classify v2 product configuration.
product_type: Literal["classify_v2"]
Product type.
rules: List[ParametersClassifyV2ParametersRule]
Classify rules to evaluate against the document (at least one required)
description: str
Natural language criteria for matching this rule
type: str
Document type to assign when rule matches
mode: Optional[Literal["FAST"]]
Classify execution mode
parsing_configuration: Optional[ParametersClassifyV2ParametersParsingConfiguration]
Parsing configuration for classify jobs.
lang: Optional[str]
ISO 639-1 language code for the document
max_pages: Optional[int]
Maximum number of pages to process. Omit for no limit.
target_pages: Optional[str]
Comma-separated page numbers or ranges to process (1-based). Omit to process all pages.
class ParametersParseV2Parameters: …
Configuration for LlamaParse v2 document parsing.
Includes tier selection, processing options, output formatting, page targeting, and webhook delivery. Refer to the LlamaParse documentation for details on each field.
product_type: Literal["parse_v2"]
Product type.
tier: Literal["fast", "cost_effective", "agentic", "agentic_plus"]
Parsing tier: 'fast' (rule-based, cheapest), 'cost_effective' (balanced), 'agentic' (AI-powered with custom prompts), or 'agentic_plus' (premium AI with highest accuracy)
version: Union[Literal["2025-12-11", "2025-12-18", "2025-12-31", 31 more], str]
Tier version. Use 'latest' for the current stable version, or specify a specific version (e.g., '1.0', '2.0') for reproducible results
Literal["2025-12-11", "2025-12-18", "2025-12-31", 31 more]
Tier version. Use 'latest' for the current stable version, or specify a specific version (e.g., '1.0', '2.0') for reproducible results
agentic_options: Optional[ParametersParseV2ParametersAgenticOptions]
Options for AI-powered parsing tiers (cost_effective, agentic, agentic_plus).
These options customize how the AI processes and interprets document content. Only applicable when using non-fast tiers.
custom_prompt: Optional[str]
Custom instructions for the AI parser. Use to guide extraction behavior, specify output formatting, or provide domain-specific context. Example: 'Extract financial tables with currency symbols. Format dates as YYYY-MM-DD.'
client_name: Optional[str]
Identifier for the client/application making the request. Used for analytics and debugging. Example: 'my-app-v2'
crop_box: Optional[ParametersParseV2ParametersCropBox]
Crop boundaries to process only a portion of each page. Values are ratios 0-1 from page edges
bottom: Optional[float]
Bottom boundary as ratio (0-1). 0=top edge, 1=bottom edge. Content below this line is excluded
left: Optional[float]
Left boundary as ratio (0-1). 0=left edge, 1=right edge. Content left of this line is excluded
right: Optional[float]
Right boundary as ratio (0-1). 0=left edge, 1=right edge. Content right of this line is excluded
top: Optional[float]
Top boundary as ratio (0-1). 0=top edge, 1=bottom edge. Content above this line is excluded
disable_cache: Optional[bool]
Bypass result caching and force re-parsing. Use when document content may have changed or you need fresh results
fast_options: Optional[object]
Options for fast tier parsing (rule-based, no AI).
Fast tier uses deterministic algorithms for text extraction without AI enhancement. It's the fastest and most cost-effective option, best suited for simple documents with standard layouts. Currently has no configurable options but reserved for future expansion.
input_options: Optional[ParametersParseV2ParametersInputOptions]
Format-specific options (HTML, PDF, spreadsheet, presentation). Applied based on detected input file type
html: Optional[ParametersParseV2ParametersInputOptionsHTML]
HTML/web page parsing options (applies to .html, .htm files)
make_all_elements_visible: Optional[bool]
Force all HTML elements to be visible by overriding CSS display/visibility properties. Useful for parsing pages with hidden content or collapsed sections
remove_fixed_elements: Optional[bool]
Remove fixed-position elements (headers, footers, floating buttons) that appear on every page render
remove_navigation_elements: Optional[bool]
Remove navigation elements (nav bars, sidebars, menus) to focus on main content
pdf: Optional[object]
PDF-specific parsing options (applies to .pdf files)
presentation: Optional[ParametersParseV2ParametersInputOptionsPresentation]
Presentation parsing options (applies to .pptx, .ppt, .odp, .key files)
out_of_bounds_content: Optional[bool]
Extract content positioned outside the visible slide area. Some presentations have hidden notes or content that extends beyond slide boundaries
skip_embedded_data: Optional[bool]
Skip extraction of embedded chart data tables. When true, only the visual representation of charts is captured, not the underlying data
spreadsheet: Optional[ParametersParseV2ParametersInputOptionsSpreadsheet]
Spreadsheet parsing options (applies to .xlsx, .xls, .csv, .ods files)
detect_sub_tables_in_sheets: Optional[bool]
Detect and extract multiple tables within a single sheet. Useful when spreadsheets contain several data regions separated by blank rows/columns
force_formula_computation_in_sheets: Optional[bool]
Compute formula results instead of extracting formula text. Use when you need calculated values rather than formula definitions
include_hidden_sheets: Optional[bool]
Parse hidden sheets in addition to visible ones. By default, hidden sheets are skipped
output_options: Optional[ParametersParseV2ParametersOutputOptions]
Output formatting options for markdown, text, and extracted images
extract_printed_page_number: Optional[bool]
Extract the printed page number as it appears in the document (e.g., 'Page 5 of 10', 'v', 'A-3'). Useful for referencing original page numbers
images_to_save: Optional[List[Literal["screenshot", "embedded", "layout"]]]
Image categories to extract and save. Options: 'screenshot' (full page renders useful for visual QA), 'embedded' (images found within the document), 'layout' (cropped regions from layout detection like figures and diagrams). Empty list saves no images
markdown: Optional[ParametersParseV2ParametersOutputOptionsMarkdown]
Markdown formatting options including table styles and link annotations
annotate_links: Optional[bool]
Add link annotations to markdown output in the format text. When false, only the link text is included
inline_images: Optional[bool]
Embed images directly in markdown as base64 data URIs instead of extracting them as separate files. Useful for self-contained markdown output
tables: Optional[ParametersParseV2ParametersOutputOptionsMarkdownTables]
Table formatting options including markdown vs HTML format and merging behavior
compact_markdown_tables: Optional[bool]
Remove extra whitespace padding in markdown table cells for more compact output
markdown_table_multiline_separator: Optional[str]
Separator string for multiline cell content in markdown tables. Example: '
' to preserve line breaks, ' ' to join with spaces
merge_continued_tables: Optional[bool]
Automatically merge tables that span multiple pages into a single table. The merged table appears on the first page with merged_from_pages metadata
output_tables_as_markdown: Optional[bool]
Output tables as markdown pipe tables instead of HTML