Skip to content

Get model versions

GET /api/v1/predictive-models/versions/{versionId}: request fields and declared response contract.

GET/api/v1/predictive-models/versions/{versionId}

Authorization
PermissiondataPipelines.read
Workspace scoperequired
Scope targetworkspace

Parameters

Path parameters
FieldTypeRequiredNullableDefault
versionIdstringrequirednon-null—

Query parameters: none.

Response

200

Response fields
FieldTypeRequiredNullableDefault
dataobjectrequirednon-null—
data.versionIdstringrequirednon-null—
data.companyIdstringrequirednon-null—
data.workspaceIdstringrequirednon-null—
data.runIdstringrequirednon-null—
data.objectiveIdstringrequirednon-null—
data.projectKeystringrequirednon-null—
data.projectVersionintegerrequirednon-null—
data.executorKindstringrequirednon-null—
data.status"candidate" | "revoked"requirednon-null—
data.revisionintegerrequirednon-null—
data.lineageobjectrequirednon-null—
data.lineage.dataDefinitionIdstringrequirednon-null—
data.lineage.snapshotKeystringrequirednon-null—
data.lineage.inputManifestUristringrequirednon-null—
data.lineage.outputPrefixUristringrequirednon-null—
data.artifactsarrayrequirednon-null—
data.metricsobjectrequirednon-null—
data.paramsobjectrequirednon-null—
data.costUsdMicrosintegerrequirednon-null—
data.originsobjectrequirednon-null—
data.origins.providerJobNamestringoptionalnon-null—
data.origins.mlflowRunIdstringoptionalnon-null—
data.origins.mlflowExperimentIdstringoptionalnon-null—
data.origins.trackingServerArnstringoptionalnon-null—
data.createdAtstringrequirednon-null—
data.updatedAtstringrequirednon-null—

Declared failures

Declared failures
ACCESS_DENIED403 — not retryable
CORE_ERROR500 — not retryable
GOVERNANCE_DENIED403 — not retryable
VALIDATION_ERROR400 — not retryable
VALIDATION_INPUT_ERROR400 — not retryable

Readback

This method returns the current state it read.

  • predictiveModels.versions.read

Request example

Schematic only. Replace placeholders with real values and include all required nested fields.

GET /api/v1/predictive-models/versions/{versionId} HTTP/1.1
Authorization: Bearer <token>
x-merulan-workspace-id: <workspace-id>