Skip to content

Get model objectives

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

GET/api/v1/predictive-models/objectives/{id}

Authorization
PermissiondataPipelines.read
Workspace scoperequired
Scope targetworkspace

Parameters

Path parameters
FieldTypeRequiredNullableDefault
idstringrequirednon-null—

Query parameters: none.

Response

200

Response fields
FieldTypeRequiredNullableDefault
dataobjectrequirednon-null—
data.idstringrequirednon-null—
data.companyIdstringrequirednon-null—
data.workspaceIdstringrequirednon-null—
data.objectiveKeystringrequirednon-null—
data.revisionintegerrequirednon-null—
data.state"draft" | "active" | "archived"requirednon-null—
data.namestringrequirednon-null—
data.taskType"binary_classification" | "multiclass_classification" | "regression"requirednon-null—
data.contractobjectrequirednon-null—
data.contract.contractVersionintegerrequirednon-null1
data.contract.predictionHorizonobjectrequirednon-null—
data.contract.predictionHorizon.unit"days" | "weeks" | "months"requirednon-null—
data.contract.predictionHorizon.amountintegerrequirednon-null—
data.contract.semanticInputsarrayrequirednon-null—
data.contract.outputobjectrequirednon-null—
data.contract.output.targetNamestringrequirednon-null—
data.contract.output.valueType"boolean" | "number" | "category"requirednon-null—
data.contract.output.categoriesarrayoptionalnon-null—
data.contract.successMeasuresarrayrequirednon-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.objective.read

Request example

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

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