You only need this page if you have existing v1 code to migrate.
New users should skip this and start with Getting Started — v2 is the only version you need to learn.
v2 replaced v1’s flat 70+ form parameters with structured JSON. The biggest changes: tier and version are now required, most parameters moved into nested option buckets, and page indexing is now 1-based.
For where every v2 option lives, see Configuring Parse. For the comprehensive field-by-field reference, see the API reference.
- Replace
POST /api/v1/parsing/upload → POST /api/v2/parse (or /parse/upload for multipart)
- Replace
parse_mode → tier (fast, cost_effective, agentic, agentic_plus)
- Move
parsing_instruction / system_prompt → agentic_options.custom_prompt
- Move
language → processing_options.ocr_parameters.languages
- Replace
invalidate_cache + do_not_cache → single disable_cache boolean
- Replace
webhook_url (string) → webhook_configurations (array with event-style notifications)
- Update
target_pages from 0-based → 1-based indexing
- Replace
bounding_box → crop_box
- Remove
model (auto-selected by tier), gpt4o_mode, premium_mode, fast_mode, azure_openai_*, vendor_multimodal_*
high_res_ocr and precise_bounding_box are always on in v2
| v1 | v2 | Notes |
|---|
input_url | source_url | Renamed |
max_pages | page_ranges.max_pages | Same |
target_pages | page_ranges.target_pages | 1-based indexing |
invalidate_cache / do_not_cache | disable_cache | Combined |
language | processing_options.ocr_parameters.languages | Same |
| v1 | v2 | Notes |
|---|
parse_mode | tier | Tier-based system |
model | Auto-selected | Based on tier |
parsing_instruction | agentic_options.custom_prompt | cost_effective/agentic/agentic_plus only |
formatting_instruction / system_prompt / user_prompt | agentic_options.custom_prompt | Consolidated |
| v1 | v2 |
|---|
bbox_top/bottom/left/right | crop_box.top/bottom/left/right |
| v1 | v2 |
|---|
html_make_all_elements_visible | input_options.html.make_all_elements_visible |
html_remove_fixed_elements | input_options.html.remove_fixed_elements |
html_remove_navigation_elements | input_options.html.remove_navigation_elements |
spreadsheet_extract_sub_tables | input_options.spreadsheet.detect_sub_tables_in_sheets |
presentation_out_of_bounds_content | input_options.presentation.out_of_bounds_content |
| v1 | v2 |
|---|
aggressive_table_extraction | processing_options.aggressive_table_extraction |
outlined_table_extraction + adaptive_long_table | processing_options.disable_heuristics (inverted) |
specialized_chart_parsing_* | processing_options.specialized_chart_parsing: "efficient"/"agentic"/"agentic_plus" |
skip_diagonal_text | processing_options.ignore.ignore_diagonal_text |
disable_ocr | processing_options.ignore.ignore_text_in_image |
remove_hidden_text | processing_options.ignore.ignore_hidden_text |
| v1 | v2 |
|---|
annotate_links | output_options.markdown.annotate_links |
compact_markdown_table | output_options.markdown.tables.compact_markdown_tables |
output_tables_as_HTML | output_options.markdown.tables.output_tables_as_markdown (inverted) |
merge_tables_across_pages_in_markdown | output_options.markdown.tables.merge_continued_tables |
save_images / take_screenshot | output_options.images_to_save (array: "screenshot", "embedded", "layout") |
extract_printed_page_number | output_options.extract_printed_page_number |
| v1 | v2 |
|---|
job_timeout_in_seconds | processing_control.timeouts.base_in_seconds |
job_timeout_extra_time_per_page_in_seconds | processing_control.timeouts.extra_time_per_page_in_seconds |
page_error_tolerance | processing_control.job_failure_conditions.allowed_page_failure_ratio |
strict_mode_image_extraction | processing_control.job_failure_conditions.fail_on_image_extraction_error |
strict_mode_image_ocr | processing_control.job_failure_conditions.fail_on_image_ocr_error |
strict_mode_reconstruction | processing_control.job_failure_conditions.fail_on_markdown_reconstruction_error |
strict_mode_buggy_font | processing_control.job_failure_conditions.fail_on_buggy_font |
gpt4o_mode, gpt4o_api_key, premium_mode, fast_mode, continuous_mode, vendor_multimodal_api_key, azure_openai_*, disable_image_extraction, hide_headers, hide_footers, page_header_prefix, page_footer_prefix, page_prefix, page_separator, input_s3_path, output_s3_path_prefix, extract_layout.
The v1 endpoint remains available for the foreseeable future. New features are v2-only.
