---
title: "Gets a specific revision for a job definition."
method: GET
path: "/job/definition/{definitionId}/revision/{revisionNumber}"
tags: ["Job"]
---

# Gets a specific revision for a job definition.

`GET /job/definition/{definitionId}/revision/{revisionNumber}`

## Path parameters

- `definitionId` string, required
- `revisionNumber` integer, required

## Response `200`

OK

- GetJobRevisionEndpointOutput — The result when a job revision has been retrieved.
  - `definitionId` string, required — The job definition id.
  - `revisionNumber` integer, required — The revision number.
  - `state` 'Pending' | 'Completed' | 'Failed', required
  - `pipelineId` string, required — The pipeline id.
  - `datasetId` string, required — The dataset id.
  - `aggregatorType` unknown
  - `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
  - `featureFlags` FeatureFlag[], required — The feature flags.
    - `key` string, required
    - `value` string, required
  - `createdAt` string, date-time, required — The creation timestamp.
  - `createdById` string, uuid, required — The id of the user who created the revision.
  - `createdByMail` string, required — The email of the user who created the revision.
  - `isInstructionComplex` boolean, nullable — Whether the instruction was flagged as too complex for the average annotator to understand. Null until the asynchronous complexity check has completed.
  - `instructionComplexityReason` string, nullable — A short explanation of why the instruction was flagged, when applicable.

## 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/versions/e42ec51c7b88/schema)