--- 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}` ## Request - Base URL: `https://api.rapidata.ai` - URL: `https://api.rapidata.ai/job/definition/{definitionId}/revision/{revisionNumber}` - Auth: OpenID Connect (`https://auth.rapidata.ai/.well-known/openid-configuration`, scopes: `openid`, `profile`, `email`, `offline_access`, `api`) ## 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` 'NonCommittal' | 'MajorityVote' | 'SimpleMatchup' | 'LocateCluster' | 'Classification' | 'Locate' | 'BoundingBox' | 'Line' | 'Transcription' | 'SinglePointLocate' | 'FreeText' | 'Scrub' | 'Ranking' | 'MultiRanking', nullable: The aggregator type. - `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 - `rapid` union - IRapidSpecBoundingBoxRapidSpec - `_t` 'BoundingBox', required - `asset` AssetBinding, required - `segment` string, required - `context` object, nullable - `literal` string, nullable - `segment` string, nullable - `language` 'Original' | 'English', nullable: Which language of a text segment to read. - `contextAssets` AssetBinding[], nullable - `segment` string, required - `target` TextBinding, required - `literal` string, nullable - `segment` string, nullable - `language` 'Original' | 'English', nullable: Which language of a text segment to read. - IRapidSpecClassifyRapidSpec - `_t` 'Classify', required - `asset` AssetBinding, required - `segment` string, required - `context` object, nullable - `literal` string, nullable - `segment` string, nullable - `language` 'Original' | 'English', nullable: Which language of a text segment to read. - `contextAssets` AssetBinding[], nullable - `segment` string, required - `title` TextBinding, required - `literal` string, nullable - `segment` string, nullable - `language` 'Original' | 'English', nullable: Which language of a text segment to read. - `categories` OptionsBinding, required - `literal` OptionsBindingOption[], nullable - … - `segment` string, nullable - IRapidSpecCompareRapidSpec - `_t` 'Compare', required - `asset` AssetBinding, required - `segment` string, required - `context` object, nullable - `literal` string, nullable - `segment` string, nullable - `language` 'Original' | 'English', nullable: Which language of a text segment to read. - `contextAssets` AssetBinding[], nullable - `segment` string, required - `criteria` TextBinding, required - `literal` string, nullable - `segment` string, nullable - `language` 'Original' | 'English', nullable: Which language of a text segment to read. - `indexIdentifiers` string[], nullable - IRapidSpecFreeTextRapidSpec - `_t` 'FreeText', required - `asset` AssetBinding, required - `segment` string, required - `context` object, nullable - `literal` string, nullable - `segment` string, nullable - `language` 'Original' | 'English', nullable: Which language of a text segment to read. - `contextAssets` AssetBinding[], nullable - `segment` string, required - `question` TextBinding, required - `literal` string, nullable - `segment` string, nullable - `language` 'Original' | 'English', nullable: Which language of a text segment to read. - `shouldValidateResponse` boolean, nullable - `validationSystemPrompt` string, nullable - IRapidSpecLineRapidSpec - `_t` 'Line', required - `asset` AssetBinding, required - `segment` string, required - `context` object, nullable - `literal` string, nullable - `segment` string, nullable - `language` 'Original' | 'English', nullable: Which language of a text segment to read. - `contextAssets` AssetBinding[], nullable - `segment` string, required - `target` TextBinding, required - `literal` string, nullable - `segment` string, nullable - `language` 'Original' | 'English', nullable: Which language of a text segment to read. - IRapidSpecLocateRapidSpec - `_t` 'Locate', required - `asset` AssetBinding, required - `segment` string, required - `context` object, nullable - `literal` string, nullable - `segment` string, nullable - `language` 'Original' | 'English', nullable: Which language of a text segment to read. - `contextAssets` AssetBinding[], nullable - `segment` string, required - `target` TextBinding, required - `literal` string, nullable - `segment` string, nullable - `language` 'Original' | 'English', nullable: Which language of a text segment to read. - IRapidSpecNamedEntityRapidSpec - `_t` 'NamedEntity', required - `asset` AssetBinding, required - `segment` string, required - `context` object, nullable - `literal` string, nullable - `segment` string, nullable - `language` 'Original' | 'English', nullable: Which language of a text segment to read. - `contextAssets` AssetBinding[], nullable - `segment` string, required - `target` TextBinding, required - `literal` string, nullable - `segment` string, nullable - `language` 'Original' | 'English', nullable: Which language of a text segment to read. - `classes` string[], required - IRapidSpecPolygonRapidSpec - `_t` 'Polygon', required - `asset` AssetBinding, required - `segment` string, required - `context` object, nullable - `literal` string, nullable - `segment` string, nullable - `language` 'Original' | 'English', nullable: Which language of a text segment to read. - `contextAssets` AssetBinding[], nullable - `segment` string, required - `target` TextBinding, required - `literal` string, nullable - `segment` string, nullable - `language` 'Original' | 'English', nullable: Which language of a text segment to read. - IRapidSpecScrubRapidSpec - `_t` 'Scrub', required - `asset` AssetBinding, required - `segment` string, required - `context` object, nullable - `literal` string, nullable - `segment` string, nullable - `language` 'Original' | 'English', nullable: Which language of a text segment to read. - `contextAssets` AssetBinding[], nullable - `segment` string, required - `target` TextBinding, required - `literal` string, nullable - `segment` string, nullable - `language` 'Original' | 'English', nullable: Which language of a text segment to read. - IRapidSpecTranscriptionRapidSpec - `_t` 'Transcription', required - `asset` AssetBinding, required - `segment` string, required - `context` object, nullable - `literal` string, nullable - `segment` string, nullable - `language` 'Original' | 'English', nullable: Which language of a text segment to read. - `contextAssets` AssetBinding[], nullable - `segment` string, required - `title` TextBinding, required - `literal` string, nullable - `segment` string, nullable - `language` 'Original' | 'English', nullable: Which language of a text segment to read. - `transcription` TextBinding, required - `literal` string, nullable - `segment` string, nullable - `language` 'Original' | 'English', nullable: Which language of a text segment to read. - `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 rapid-level feature flags. Send back as rapidFeatureFlags to create a new revision. - `key` string, required - `value` string, required - `campaignFeatureFlags` FeatureFlag[], required: The campaign-level (session-wide) feature flags. - `key` string, required - `value` string, required - `validationSetId` string, nullable: The validation set pinned on this revision, or null when none is pinned. - `baseRevisionNumber` integer, nullable: The revision this one was edited from, when the caller supplied it. - `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 ## Changes - **2026-10-23** `004a977d7d9f`: 3 info - added the optional property `baseRevisionNumber` to the response with the `200` status - added the optional property `validationSetId` to the response with the `200` status - added the required property `campaignFeatureFlags` to the response with the `200` status - …earlier changes not shown [Operation history](https://skmtc.dev/rapidata/apis/rapidata-api/changes/job/definition/:definitionId/revision/:revisionNumber/get.md) --- [API](https://skmtc.dev/rapidata/apis/rapidata-api.md) - [All operations](https://skmtc.dev/rapidata/apis/rapidata-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rapidata/apis/rapidata-api/revisions/004a977d7d9f?raw)