Job

Gets the latest revision for a job definition.

Changed on Oct 23, 2026

get/job/definition/{definitionId}/revision

Request

Base URL
https://api.rapidata.ai
Auth
OpenID Connect (https://auth.rapidata.ai/.well-known/openid-configuration, scopes: openid, profile, email, offline_access, api)
TypeScript
https://skmtc.dev/rapidata/apis/rapidata-api/docs/job/definition/:definitionId/revision/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

definitionIdstring required

The id of the job definition.

Response

definitionIdstring required

The job definition id.

revisionNumberinteger required

The revision number.

state'Pending' | 'Completed' | 'Failed' required

pipelineIdstring required

The pipeline id.

datasetIdstring required

The dataset id.

The aggregator type.

validationSetIdstring nullable

The validation set pinned on this revision, or null when none is pinned.

baseRevisionNumberinteger nullable

The revision this one was edited from, when the caller supplied it.

createdAtstring date-time required

The creation timestamp.

createdByIdstring uuid required

The id of the user who created the revision.

createdByMailstring required

The email of the user who created the revision.

isInstructionComplexboolean nullable

Whether the instruction was flagged as too complex for the average annotator to understand. Null until the asynchronous complexity check has completed.

instructionComplexityReasonstring nullable

A short explanation of why the instruction was flagged, when applicable.

Changes

Oct 23, 2026004a977d7d9f Revision changes
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the required property to the response with the status
Oct 19, 2026c72c9f1c8ef5 Revision changes
- info
  removed the undefined enum value from the //// response property for the response status
- info
  removed the undefined enum value from the /////////////////////////// response property for the response status
- info
  removed the undefined enum value from the /////////////////////// response property for the response status
- info
  removed the undefined enum value from the /////////////////////////// response property for the response status
- info
  removed the undefined enum value from the /////////////////////// response property for the response status
- info
  removed the undefined enum value from the /////////////////////////// response property for the response status
- info
  removed the undefined enum value from the /////////////////////// response property for the response status
- info
  removed the undefined enum value from the /////////////////////////// response property for the response status
- info
  removed the undefined enum value from the /////////////////////// response property for the response status
- info
  removed the undefined enum value from the /////////////////////////// response property for the response status
- info
  removed the undefined enum value from the /////////////////////// response property for the response status
- info
  removed the undefined enum value from the /////////////////////////// response property for the response status
- info
  removed the undefined enum value from the /////////////////////// response property for the response status
- info
  removed the undefined enum value from the /////////////////////////// response property for the response status
- info
  removed the undefined enum value from the /////////////////////// response property for the response status
- info
  removed the undefined enum value from the /////////////////////////// response property for the response status
- info
  removed the undefined enum value from the /////////////////////// response property for the response status
- info
  removed the undefined enum value from the /////////////////////////// response property for the response status
- info
  removed the undefined enum value from the /////////////////////// response property for the response status
- info
  removed the undefined enum value from the /////////////////////////// response property for the response status
- info
  removed the undefined enum value from the /////////////////////// response property for the response status
- info
  removed the undefined enum value from the /////////////////////// response property for the response status

Operation history (5 revisions)

Gets the latest revision for a job definition.

Request

Path parameters

Response 200OK

Changes

Response