---
title: "Creates a new job definition."
method: POST
path: "/job/definition"
tags: ["Job"]
---

# Creates a new job definition.

`POST /job/definition`

A preview pipeline is automatically created and returned in the response.

## Request body

- CreateJobDefinitionEndpointInput — The input for the create job definition endpoint.
  - `definitionName` string, required — The name of the definition.
  - `workflow` union, required
    - object
      - `_t` 'EvaluationWorkflow', required
      - `validationSetId` string, required
      - `shouldAcceptIncorrect` boolean, required
      - `featureFlags` FeatureFlag[]
        - `key` string, required
        - `value` string, required
    - object
      - `_t` 'GroupedRankingWorkflow', required
      - `criteria` string, required
      - `pairMakerConfig` union
        - object
          - `_t` 'FullPermutationPairMaker', required
        - object
          - `_t` 'OnlinePairMaker', required
          - `randomMatchesRatio` number, float
          - `totalComparisonBudget` integer
      - `rankingConfig` union
        - IRankingConfigBradleyTerryRankingConfig
          - `_t` 'BradleyTerryRankingConfig', required
          - `startingScore` integer, required
        - IRankingConfigEloConfig
          - `_t` 'EloConfig', required
          - `startingScore` integer, required
          - `kFactor` integer, required
          - `scalingFactor` integer, required
      - `contexts` object, nullable
      - `contextAssets` object, nullable
      - `featureFlags` FeatureFlag[]
        - `key` string, required
        - `value` string, required
      - `maxParallelism` integer
    - object
      - `_t` 'SimpleWorkflow', required
      - `blueprint` union, required
        - object
          - `_t` 'ClassifyBlueprint', required
          - `categories` AttachCategoryRapidBlueprintCategory[], required
            - `label` string, required
            - `value` string, required
          - `possibleCategories` string[], nullable
          - `title` string, required
        - object
          - `_t` 'BoundingBoxBlueprint', required
          - `target` string, required
        - object
          - `_t` 'CompareBlueprint', required
          - `criteria` string, required
          - `indexIdentifiers` string[], nullable
        - object
          - `_t` 'FreeTextBlueprint', required
          - `question` string, required
          - `shouldValidateResponse` boolean, nullable
          - `validationSystemPrompt` string, nullable
        - object
          - `_t` 'LineBlueprint', required
          - `target` string, required
        - object
          - `_t` 'LocateBlueprint', required
          - `target` string, required
        - object
          - `_t` 'NamedEntityBlueprint', required
          - `target` string, required
          - `classes` string[], required
        - object
          - `_t` 'PolygonBlueprint', required
          - `target` string, required
        - object
          - `_t` 'ScrubBlueprint', required
          - `target` string, required
        - object
          - `_t` 'TranscriptionBlueprint', required
          - `title` string, required
      - `batchSize` integer, nullable
      - `featureFlags` FeatureFlag[]
        - `key` string, required
        - `value` string, required
  - `referee` union, required
    - object
      - `_t` 'BudgetReferee', required
      - `totalBudget` integer, required
    - object
      - `_t` 'EarlyStoppingReferee', required
      - `maxVotes` integer, required
      - `threshold` number, double, required
    - object
      - `_t` 'NaiveReferee', required
      - `totalVotes` integer, required
    - object
      - `_t` 'QuorumReferee', required
      - `maxVotes` integer, required
      - `threshold` integer, required
  - `datasetId` string, required — The dataset id.
  - `rapidFeatureFlags` FeatureFlag[] — The feature flags that apply to each rapid created by this definition.
    - `key` string, required
    - `value` string, required
  - `campaignFeatureFlags` FeatureFlag[] — The feature flags that apply to the campaign (session-wide) for this definition.
    - `key` string, required
    - `value` string, required
  - `aggregatorType` unknown

## Response `200`

OK

- CreateJobDefinitionEndpointOutput — The result when a job definition has been created.
  - `definitionId` string, required — The id of the created job definition.
  - `pipelineId` string, required — The id of the created preview pipeline.

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden

---

[API](https://skmtc.net/rapidata/apis/rapidata-api.md) · [All operations](https://skmtc.net/rapidata/apis/rapidata-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rapidata/rapidata-api/revisions/e42ec51c7b88/schema)