---
title: "Changes to Submit a batch"
method: POST
path: "/batch/submit"
---

# Changes to Submit a batch

`POST /batch/submit`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 26 revisions.

- **2026-08-27** `1febe5476266`: 1 info
- **2026-08-14** `9eddb9e1a8ea`: 8 breaking
- **2026-08-11** `b037ec95b2e8`: 4 info
- **2026-08-08** `182f532c2552`: 5 warning
- **2026-08-07** `3c6a01ba967f`: 5 warning, 2 info
- **2026-08-06** `fc8ac2f5f021`: 20 warning
- **2026-08-01** `58e9a031fe32`: 6 breaking, 6 warning, 5 info
- **2026-07-31** `f5c503b03f98`: 1 info

## Changes

- **2026-08-27** `1febe5476266`: 1 info
  - added the required property `allOf[subschema #1: Accepted batch]/cache_metadata` to the response with the `202` status
- **2026-08-14** `9eddb9e1a8ea`: 8 breaking
  - request property `input/oneOf[subschema #1: Scrape]/data/oneOf[subschema #1: Markdown]/options/pdf/ocr` list-of-types was narrowed by removing types `string` from media type `application/json`
  - request property `input/oneOf[subschema #1: Scrape]/data/oneOf[subschema #1: Markdown]/options/pdf/shouldParse` list-of-types was narrowed by removing types `string` from media type `application/json`
  - request property `input/oneOf[subschema #1: Scrape]/data/oneOf[subschema #2: HTML]/options/pdf/ocr` list-of-types was narrowed by removing types `string` from media type `application/json`
  - request property `input/oneOf[subschema #1: Scrape]/data/oneOf[subschema #2: HTML]/options/pdf/shouldParse` list-of-types was narrowed by removing types `string` from media type `application/json`
  - request property `input/oneOf[subschema #2: Crawl]/data/oneOf[subschema #1: Markdown]/options/pdf/ocr` list-of-types was narrowed by removing types `string` from media type `application/json`
  - request property `input/oneOf[subschema #2: Crawl]/data/oneOf[subschema #1: Markdown]/options/pdf/shouldParse` list-of-types was narrowed by removing types `string` from media type `application/json`
  - request property `input/oneOf[subschema #2: Crawl]/data/oneOf[subschema #2: HTML]/options/pdf/ocr` list-of-types was narrowed by removing types `string` from media type `application/json`
  - request property `input/oneOf[subschema #2: Crawl]/data/oneOf[subschema #2: HTML]/options/pdf/shouldParse` list-of-types was narrowed by removing types `string` from media type `application/json`
- **2026-08-11** `b037ec95b2e8`: 4 info
  - added the new optional request property `input/oneOf[subschema #1: Scrape]/data/oneOf[subschema #1: Markdown]/options/includeHTML`
  - added the new optional request property `input/oneOf[subschema #2: Crawl]/data/oneOf[subschema #1: Markdown]/options/includeHTML`
  - the `options` request property default value changed from `{"includeLinks":true,"includeImages":false,"shortenBase64Images":true,"useMainContentOnly":false,"pdf":{"shouldParse":true,"ocr":false},"settleAnimations":false,"maxAgeMs":86400000}` to `{"includeLinks":true,"includeImages":false,"shortenBase64Images":true,"useMainContentOnly":false,"includeHTML":false,"pdf":{"shouldParse":true,"ocr":false},"settleAnimations":false,"maxAgeMs":86400000}`
  - the `options` request property default value changed from `{"includeLinks":true,"includeImages":false,"shortenBase64Images":true,"useMainContentOnly":false,"pdf":{"shouldParse":true,"ocr":false},"settleAnimations":false,"maxAgeMs":86400000}` to `{"includeLinks":true,"includeImages":false,"shortenBase64Images":true,"useMainContentOnly":false,"includeHTML":false,"pdf":{"shouldParse":true,"ocr":false},"settleAnimations":false,"maxAgeMs":86400000}`
- **2026-08-08** `182f532c2552`: 5 warning
  - added the new `WEBSITE_BLOCKED` enum value to the `error_code` response property for the response status `400`
  - added the new `WEBSITE_BLOCKED` enum value to the `error_code` response property for the response status `401`
  - added the new `WEBSITE_BLOCKED` enum value to the `error_code` response property for the response status `403`
  - added the new `WEBSITE_BLOCKED` enum value to the `error_code` response property for the response status `409`
  - added the new `WEBSITE_BLOCKED` enum value to the `error_code` response property for the response status `500`
- **2026-08-07** `3c6a01ba967f`: 5 warning, 2 info
  - added the new `COLD_DOMAIN_TIMEOUT_TOO_LOW` enum value to the `error_code` response property for the response status `400`
  - added the new `COLD_DOMAIN_TIMEOUT_TOO_LOW` enum value to the `error_code` response property for the response status `401`
  - added the new `COLD_DOMAIN_TIMEOUT_TOO_LOW` enum value to the `error_code` response property for the response status `403`
  - added the new `COLD_DOMAIN_TIMEOUT_TOO_LOW` enum value to the `error_code` response property for the response status `409`
  - added the new `COLD_DOMAIN_TIMEOUT_TOO_LOW` enum value to the `error_code` response property for the response status `500`
  - added `subschema #1: Start URL, subschema #2: Sitemap` to the `allOf[subschema #1: Accepted batch]/crawl/anyOf[subschema #1]/allOf[subschema #1: Crawl controls]/source` response property `anyOf` list for the response status `202`
  - removed `subschema #1, subschema #2` from the `allOf[subschema #1: Accepted batch]/crawl/anyOf[subschema #1]/allOf[subschema #1: Crawl controls]/source` response property `anyOf` list for the response status `202`
- **2026-08-06** `fc8ac2f5f021`: 20 warning
  - added the new `CONTENT_TOO_LARGE` enum value to the `error_code` response property for the response status `400`
  - added the new `CONTENT_TOO_LARGE` enum value to the `error_code` response property for the response status `401`
  - added the new `CONTENT_TOO_LARGE` enum value to the `error_code` response property for the response status `403`
  - added the new `CONTENT_TOO_LARGE` enum value to the `error_code` response property for the response status `409`
  - added the new `CONTENT_TOO_LARGE` enum value to the `error_code` response property for the response status `500`
  - added the new `PDF_IMAGES_ONLY` enum value to the `error_code` response property for the response status `400`
  - added the new `PDF_IMAGES_ONLY` enum value to the `error_code` response property for the response status `401`
  - added the new `PDF_IMAGES_ONLY` enum value to the `error_code` response property for the response status `403`
  - added the new `PDF_IMAGES_ONLY` enum value to the `error_code` response property for the response status `409`
  - added the new `PDF_IMAGES_ONLY` enum value to the `error_code` response property for the response status `500`
  - added the new `PDF_SKIPPED` enum value to the `error_code` response property for the response status `400`
  - added the new `PDF_SKIPPED` enum value to the `error_code` response property for the response status `401`
  - added the new `PDF_SKIPPED` enum value to the `error_code` response property for the response status `403`
  - added the new `PDF_SKIPPED` enum value to the `error_code` response property for the response status `409`
  - added the new `PDF_SKIPPED` enum value to the `error_code` response property for the response status `500`
  - added the new `WEBSITE_NOT_FOUND` enum value to the `error_code` response property for the response status `400`
  - added the new `WEBSITE_NOT_FOUND` enum value to the `error_code` response property for the response status `401`
  - added the new `WEBSITE_NOT_FOUND` enum value to the `error_code` response property for the response status `403`
  - added the new `WEBSITE_NOT_FOUND` enum value to the `error_code` response property for the response status `409`
  - added the new `WEBSITE_NOT_FOUND` enum value to the `error_code` response property for the response status `500`
- **2026-08-01** `58e9a031fe32`: 6 breaking, 6 warning, 5 info
  - added the new required request property `input/oneOf[subschema #1: Scrape]/data/oneOf[subschema #1: Markdown]/format`
  - added the new required request property `input/oneOf[subschema #1: Scrape]/data/oneOf[subschema #2: HTML]/format`
  - added the new required request property `input/oneOf[subschema #1: Scrape]/mode`
  - added the new required request property `input/oneOf[subschema #2: Crawl]/data/oneOf[subschema #1: Markdown]/format`
  - added the new required request property `input/oneOf[subschema #2: Crawl]/data/oneOf[subschema #2: HTML]/format`
  - added the new required request property `input/oneOf[subschema #2: Crawl]/mode`
  - removed the request property `input/oneOf[subschema #1: Scrape]/data/oneOf[subschema #1: Markdown]/type`
  - removed the request property `input/oneOf[subschema #1: Scrape]/data/oneOf[subschema #2: HTML]/type`
  - removed the request property `input/oneOf[subschema #1: Scrape]/type`
  - removed the request property `input/oneOf[subschema #2: Crawl]/data/oneOf[subschema #1: Markdown]/type`
  - removed the request property `input/oneOf[subschema #2: Crawl]/data/oneOf[subschema #2: HTML]/type`
  - removed the request property `input/oneOf[subschema #2: Crawl]/type`
  - request discriminator property name changed for `input` request property from `type` to `mode`
  - request discriminator property name changed for `input/oneOf[subschema #1: Scrape]/data` request property from `type` to `format`
  - request discriminator property name changed for `input/oneOf[subschema #2: Crawl]/data` request property from `type` to `format`
  - added `#/components/schemas/BatchAccepted` to the response body `allOf` list for the response status `202`
  - removed `#/components/schemas/Batch, #/components/schemas/BatchSubmitted` from the response body `allOf` list for the response status `202`
- **2026-07-31** `f5c503b03f98`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/context/apis/context-dev/docs/batch/submit/post.md) - [API](https://skmtc.dev/context/apis/context-dev.md) - [Page](https://skmtc.dev/context/apis/context-dev/changes/batch/submit/post)