Models

Deploy Model

POST/v1/models/deploy

Deploy a scorecard model from a Calibr scorecard spec. The spec is the JSON export from the Calibr desktop app containing the full scorecard definition including features, bins, weights, and scaling parameters. When auto_deploy is true, a deployment endpoint is created automatically and the model becomes immediately available for scoring.

Authentication: JWT token. Requires role: owner, admin, or lead_modeler.

Body Parameters

specCalibrScorecardSpecrequired

The full scorecard specification exported from the Calibr desktop app. Contains model metadata, feature definitions, binning rules, WOE values, and scaling parameters.

environmentstringrequired

Target environment. One of "production" or "staging".

descriptionstring | nulloptional

Human-readable description of this deployment. Useful for tracking why a specific version was deployed.

auto_deploybooleanrequired

When true, a deployment endpoint is created automatically and the model becomes the champion for that endpoint. When false, the model is registered but not deployed.

Error Responses

401unauthorized

JWT is missing or expired.

403insufficient_role

Your role does not have permission to deploy models.

422invalid_spec

The scorecard spec failed validation. Check the error details for specific issues.

Deploy Model
curl -X POST https://api.cali-br.com/v1/models/deploy \
  -H #a5d6ff">"Authorization: Bearer eyJhbGciOiJSUzI1NiIs..." \
  -H #a5d6ff">"Content-Type: application/json" \
  -d '{
    #a5d6ff">"spec": { "...calibr scorecard spec JSON..." },
    #a5d6ff">"environment": "production",
    #a5d6ff">"description": "Q1 2026 retail model refresh",
    #a5d6ff">"auto_deploy": true
  }'
Response200
{
  "model_id": "mod_r4Kw9xPm",
  "name": "retail_unsecured_v3",
  "version": "1.2.0",
  "deployment": {
    "id": "dep_xK8m",
    "slug": "dep_xK8m",
    "endpoint": "https://api.cali-br.com/v1/score/dep_xK8m",
    "status": "active"
  }
}