Get model versions
GET /api/v1/predictive-models/versions/{versionId}: request fields and declared response contract.
GET/api/v1/predictive-models/versions/{versionId}
| Permission | dataPipelines.read |
|---|---|
| Workspace scope | required |
| Scope target | workspace |
Parameters
| Field | Type | Required | Nullable | Default |
|---|---|---|---|---|
| versionId | string | required | non-null | — |
Query parameters: none.
Response
200
| Field | Type | Required | Nullable | Default |
|---|---|---|---|---|
| data | object | required | non-null | — |
| data.versionId | string | required | non-null | — |
| data.companyId | string | required | non-null | — |
| data.workspaceId | string | required | non-null | — |
| data.runId | string | required | non-null | — |
| data.objectiveId | string | required | non-null | — |
| data.projectKey | string | required | non-null | — |
| data.projectVersion | integer | required | non-null | — |
| data.executorKind | string | required | non-null | — |
| data.status | "candidate" | "revoked" | required | non-null | — |
| data.revision | integer | required | non-null | — |
| data.lineage | object | required | non-null | — |
| data.lineage.dataDefinitionId | string | required | non-null | — |
| data.lineage.snapshotKey | string | required | non-null | — |
| data.lineage.inputManifestUri | string | required | non-null | — |
| data.lineage.outputPrefixUri | string | required | non-null | — |
| data.artifacts | array | required | non-null | — |
| data.metrics | object | required | non-null | — |
| data.params | object | required | non-null | — |
| data.costUsdMicros | integer | required | non-null | — |
| data.origins | object | required | non-null | — |
| data.origins.providerJobName | string | optional | non-null | — |
| data.origins.mlflowRunId | string | optional | non-null | — |
| data.origins.mlflowExperimentId | string | optional | non-null | — |
| data.origins.trackingServerArn | string | optional | non-null | — |
| data.createdAt | string | required | non-null | — |
| data.updatedAt | string | required | non-null | — |
Declared failures
| ACCESS_DENIED | 403 — not retryable |
|---|---|
| CORE_ERROR | 500 — not retryable |
| GOVERNANCE_DENIED | 403 — not retryable |
| VALIDATION_ERROR | 400 — not retryable |
| VALIDATION_INPUT_ERROR | 400 — 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>