---
title: "Changes to Creates a new revision for an existing job definition."
method: POST
path: "/job/definition/{definitionId}/revision"
---

# Changes to Creates a new revision for an existing job definition.

`POST /job/definition/{definitionId}/revision`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 25 revisions.

- **2026-10-23** `004a977d7d9f`: 2 info
- **2026-10-19** `c72c9f1c8ef5`: 22 breaking
- **2026-10-16** `c125fee5f3e1`: 1 warning, 1 info
- **2026-09-04** `9da534659e5f`: 1 info

## Changes

- **2026-10-23** `004a977d7d9f`: 2 info
  - added the new optional request property `baseRevisionNumber`
  - added the new optional request property `requireLatest`
- **2026-10-19** `c72c9f1c8ef5`: 22 breaking
  - removed the enum value `undefined` of the request property `aggregatorType/oneOf[#/components/schemas/AggregatorType]/`
  - removed the enum value `undefined` of the request property `workflow/allOf[#/components/schemas/IOrderWorkflowInput]/oneOf[#/components/schemas/IOrderWorkflowInputSimpleWorkflowInput]/rapid/oneOf[#/components/schemas/IRapidSpec]/oneOf[#/components/schemas/IRapidSpecBoundingBoxRapidSpec]/context/oneOf[#/components/schemas/TextBinding]/language/oneOf[#/components/schemas/SegmentTextLanguage]/`
  - removed the enum value `undefined` of the request property `workflow/allOf[#/components/schemas/IOrderWorkflowInput]/oneOf[#/components/schemas/IOrderWorkflowInputSimpleWorkflowInput]/rapid/oneOf[#/components/schemas/IRapidSpec]/oneOf[#/components/schemas/IRapidSpecBoundingBoxRapidSpec]/target/language/oneOf[#/components/schemas/SegmentTextLanguage]/`
  - removed the enum value `undefined` of the request property `workflow/allOf[#/components/schemas/IOrderWorkflowInput]/oneOf[#/components/schemas/IOrderWorkflowInputSimpleWorkflowInput]/rapid/oneOf[#/components/schemas/IRapidSpec]/oneOf[#/components/schemas/IRapidSpecClassifyRapidSpec]/context/oneOf[#/components/schemas/TextBinding]/language/oneOf[#/components/schemas/SegmentTextLanguage]/`
  - removed the enum value `undefined` of the request property `workflow/allOf[#/components/schemas/IOrderWorkflowInput]/oneOf[#/components/schemas/IOrderWorkflowInputSimpleWorkflowInput]/rapid/oneOf[#/components/schemas/IRapidSpec]/oneOf[#/components/schemas/IRapidSpecClassifyRapidSpec]/title/language/oneOf[#/components/schemas/SegmentTextLanguage]/`
  - removed the enum value `undefined` of the request property `workflow/allOf[#/components/schemas/IOrderWorkflowInput]/oneOf[#/components/schemas/IOrderWorkflowInputSimpleWorkflowInput]/rapid/oneOf[#/components/schemas/IRapidSpec]/oneOf[#/components/schemas/IRapidSpecCompareRapidSpec]/context/oneOf[#/components/schemas/TextBinding]/language/oneOf[#/components/schemas/SegmentTextLanguage]/`
  - removed the enum value `undefined` of the request property `workflow/allOf[#/components/schemas/IOrderWorkflowInput]/oneOf[#/components/schemas/IOrderWorkflowInputSimpleWorkflowInput]/rapid/oneOf[#/components/schemas/IRapidSpec]/oneOf[#/components/schemas/IRapidSpecCompareRapidSpec]/criteria/language/oneOf[#/components/schemas/SegmentTextLanguage]/`
  - removed the enum value `undefined` of the request property `workflow/allOf[#/components/schemas/IOrderWorkflowInput]/oneOf[#/components/schemas/IOrderWorkflowInputSimpleWorkflowInput]/rapid/oneOf[#/components/schemas/IRapidSpec]/oneOf[#/components/schemas/IRapidSpecFreeTextRapidSpec]/context/oneOf[#/components/schemas/TextBinding]/language/oneOf[#/components/schemas/SegmentTextLanguage]/`
  - removed the enum value `undefined` of the request property `workflow/allOf[#/components/schemas/IOrderWorkflowInput]/oneOf[#/components/schemas/IOrderWorkflowInputSimpleWorkflowInput]/rapid/oneOf[#/components/schemas/IRapidSpec]/oneOf[#/components/schemas/IRapidSpecFreeTextRapidSpec]/question/language/oneOf[#/components/schemas/SegmentTextLanguage]/`
  - removed the enum value `undefined` of the request property `workflow/allOf[#/components/schemas/IOrderWorkflowInput]/oneOf[#/components/schemas/IOrderWorkflowInputSimpleWorkflowInput]/rapid/oneOf[#/components/schemas/IRapidSpec]/oneOf[#/components/schemas/IRapidSpecLineRapidSpec]/context/oneOf[#/components/schemas/TextBinding]/language/oneOf[#/components/schemas/SegmentTextLanguage]/`
  - removed the enum value `undefined` of the request property `workflow/allOf[#/components/schemas/IOrderWorkflowInput]/oneOf[#/components/schemas/IOrderWorkflowInputSimpleWorkflowInput]/rapid/oneOf[#/components/schemas/IRapidSpec]/oneOf[#/components/schemas/IRapidSpecLineRapidSpec]/target/language/oneOf[#/components/schemas/SegmentTextLanguage]/`
  - removed the enum value `undefined` of the request property `workflow/allOf[#/components/schemas/IOrderWorkflowInput]/oneOf[#/components/schemas/IOrderWorkflowInputSimpleWorkflowInput]/rapid/oneOf[#/components/schemas/IRapidSpec]/oneOf[#/components/schemas/IRapidSpecLocateRapidSpec]/context/oneOf[#/components/schemas/TextBinding]/language/oneOf[#/components/schemas/SegmentTextLanguage]/`
  - removed the enum value `undefined` of the request property `workflow/allOf[#/components/schemas/IOrderWorkflowInput]/oneOf[#/components/schemas/IOrderWorkflowInputSimpleWorkflowInput]/rapid/oneOf[#/components/schemas/IRapidSpec]/oneOf[#/components/schemas/IRapidSpecLocateRapidSpec]/target/language/oneOf[#/components/schemas/SegmentTextLanguage]/`
  - removed the enum value `undefined` of the request property `workflow/allOf[#/components/schemas/IOrderWorkflowInput]/oneOf[#/components/schemas/IOrderWorkflowInputSimpleWorkflowInput]/rapid/oneOf[#/components/schemas/IRapidSpec]/oneOf[#/components/schemas/IRapidSpecNamedEntityRapidSpec]/context/oneOf[#/components/schemas/TextBinding]/language/oneOf[#/components/schemas/SegmentTextLanguage]/`
  - removed the enum value `undefined` of the request property `workflow/allOf[#/components/schemas/IOrderWorkflowInput]/oneOf[#/components/schemas/IOrderWorkflowInputSimpleWorkflowInput]/rapid/oneOf[#/components/schemas/IRapidSpec]/oneOf[#/components/schemas/IRapidSpecNamedEntityRapidSpec]/target/language/oneOf[#/components/schemas/SegmentTextLanguage]/`
  - removed the enum value `undefined` of the request property `workflow/allOf[#/components/schemas/IOrderWorkflowInput]/oneOf[#/components/schemas/IOrderWorkflowInputSimpleWorkflowInput]/rapid/oneOf[#/components/schemas/IRapidSpec]/oneOf[#/components/schemas/IRapidSpecPolygonRapidSpec]/context/oneOf[#/components/schemas/TextBinding]/language/oneOf[#/components/schemas/SegmentTextLanguage]/`
  - removed the enum value `undefined` of the request property `workflow/allOf[#/components/schemas/IOrderWorkflowInput]/oneOf[#/components/schemas/IOrderWorkflowInputSimpleWorkflowInput]/rapid/oneOf[#/components/schemas/IRapidSpec]/oneOf[#/components/schemas/IRapidSpecPolygonRapidSpec]/target/language/oneOf[#/components/schemas/SegmentTextLanguage]/`
  - removed the enum value `undefined` of the request property `workflow/allOf[#/components/schemas/IOrderWorkflowInput]/oneOf[#/components/schemas/IOrderWorkflowInputSimpleWorkflowInput]/rapid/oneOf[#/components/schemas/IRapidSpec]/oneOf[#/components/schemas/IRapidSpecScrubRapidSpec]/context/oneOf[#/components/schemas/TextBinding]/language/oneOf[#/components/schemas/SegmentTextLanguage]/`
  - removed the enum value `undefined` of the request property `workflow/allOf[#/components/schemas/IOrderWorkflowInput]/oneOf[#/components/schemas/IOrderWorkflowInputSimpleWorkflowInput]/rapid/oneOf[#/components/schemas/IRapidSpec]/oneOf[#/components/schemas/IRapidSpecScrubRapidSpec]/target/language/oneOf[#/components/schemas/SegmentTextLanguage]/`
  - removed the enum value `undefined` of the request property `workflow/allOf[#/components/schemas/IOrderWorkflowInput]/oneOf[#/components/schemas/IOrderWorkflowInputSimpleWorkflowInput]/rapid/oneOf[#/components/schemas/IRapidSpec]/oneOf[#/components/schemas/IRapidSpecTranscriptionRapidSpec]/context/oneOf[#/components/schemas/TextBinding]/language/oneOf[#/components/schemas/SegmentTextLanguage]/`
  - removed the enum value `undefined` of the request property `workflow/allOf[#/components/schemas/IOrderWorkflowInput]/oneOf[#/components/schemas/IOrderWorkflowInputSimpleWorkflowInput]/rapid/oneOf[#/components/schemas/IRapidSpec]/oneOf[#/components/schemas/IRapidSpecTranscriptionRapidSpec]/title/language/oneOf[#/components/schemas/SegmentTextLanguage]/`
  - removed the enum value `undefined` of the request property `workflow/allOf[#/components/schemas/IOrderWorkflowInput]/oneOf[#/components/schemas/IOrderWorkflowInputSimpleWorkflowInput]/rapid/oneOf[#/components/schemas/IRapidSpec]/oneOf[#/components/schemas/IRapidSpecTranscriptionRapidSpec]/transcription/language/oneOf[#/components/schemas/SegmentTextLanguage]/`
- **2026-10-16** `c125fee5f3e1`: 1 warning, 1 info
  - removed the request property `workflow/allOf[#/components/schemas/IOrderWorkflowInput]/oneOf[#/components/schemas/IOrderWorkflowInputSimpleWorkflowInput]/blueprint`
  - added the new optional request property `workflow/allOf[#/components/schemas/IOrderWorkflowInput]/oneOf[#/components/schemas/IOrderWorkflowInputSimpleWorkflowInput]/rapid`
- **2026-09-04** `9da534659e5f`: 1 info
  - the security scope `api` was added to the endpoint's security scheme `OpenIdConnect`

---

[Operation](https://skmtc.dev/rapidata/apis/rapidata-api/docs/job/definition/:definitionId/revision/post.md) - [API](https://skmtc.dev/rapidata/apis/rapidata-api.md) - [Page](https://skmtc.dev/rapidata/apis/rapidata-api/changes/job/definition/:definitionId/revision/post)