Job

Creates a new revision for an existing job definition.

Changed on

Unspecified fields are inherited from the latest revision. Revision numbers are allocated atomically; set requireLatest to get 409 instead of overwriting a newer revision.

post/job/definition/{definitionId}/revision

Request

Path parameters

definitionIdstring required

The id of the job definition to create a revision for.

Request body

datasetIdstring

The dataset id. If not provided, inherits from the previous revision.

aggregatorType'NonCommittal' | 'MajorityVote' | 'SimpleMatchup' | 'LocateCluster' | 'Classification' | 'Locate' | 'BoundingBox' | 'Line' | 'Transcription' | 'SinglePointLocate' | 'FreeText' | 'Scrub' | 'Ranking' | 'MultiRanking' nullable

The aggregator type. If not provided, inherits from the previous revision.

validationSetIdstring nullable

A validation set id to pin on this revision. When set, every job run from this revision uses the specified validation set as the source of validation rapids instead of audience-derived examples. If not provided, inherits from the previous revision. Provide a wrapped null value to clear a previously pinned set.

baseRevisionNumberinteger nullable

The revision this one was edited from. Stored as lineage only; fields are never inherited from it. Must refer to an existing revision of this definition.

requireLatestboolean

When true, the revision is only created if baseRevisionNumber is still the latest revision; otherwise 409 with a latestRevisionNumber member. Requires baseRevisionNumber.

Response

OK

revisionNumberinteger required

The revision number of the created job revision.

pipelineIdstring required

The id of the created preview pipeline.

Changes

    • info

      added the new optional request property

    • info

      added the new optional request property

    • breaking

      removed the enum value undefined of the request property ////

    • breaking

      removed the enum value undefined of the request property ///////////////////////////

    • breaking

      removed the enum value undefined of the request property ///////////////////////

    • breaking

      removed the enum value undefined of the request property ///////////////////////////

    • breaking

      removed the enum value undefined of the request property ///////////////////////

    • breaking

      removed the enum value undefined of the request property ///////////////////////////

    • breaking

      removed the enum value undefined of the request property ///////////////////////

    • breaking

      removed the enum value undefined of the request property ///////////////////////////

    • breaking

      removed the enum value undefined of the request property ///////////////////////

    • breaking

      removed the enum value undefined of the request property ///////////////////////////

    • breaking

      removed the enum value undefined of the request property ///////////////////////

    • breaking

      removed the enum value undefined of the request property ///////////////////////////

    • breaking

      removed the enum value undefined of the request property ///////////////////////

    • breaking

      removed the enum value undefined of the request property ///////////////////////////

    • breaking

      removed the enum value undefined of the request property ///////////////////////

    • breaking

      removed the enum value undefined of the request property ///////////////////////////

    • breaking

      removed the enum value undefined of the request property ///////////////////////

    • breaking

      removed the enum value undefined of the request property ///////////////////////////

    • breaking

      removed the enum value undefined of the request property ///////////////////////

    • breaking

      removed the enum value undefined of the request property ///////////////////////////

    • breaking

      removed the enum value undefined of the request property ///////////////////////

    • breaking

      removed the enum value undefined of the request property ///////////////////////