MLflow

App · 17 actions

Track ML experiments and manage models in MLflow: find the best run, log metrics and params, register model versions and move aliases such as champion. Start a workflow when a version is registered, an alias moves or a run finishes.

Actions

ActionWhat it does
Create runStart a run in an experiment, to log metrics and params to from a workflow.
Delete model aliasRemove an alias from a registered model.
Delete model versionDelete a version of a registered model for good, with the aliases pointing at it.
Delete runMove a run to MLflow's trash, where it can be restored until the server's clean-up removes it.
End runMark a run finished, failed or killed, with the time it ended.
Find best runFind the finished run in an experiment with the highest or lowest value of a metric, such as the most accurate.
Find or create experimentFind the experiment with a name, or create it when there is none, to start runs in.
Get model versionGet a model version by its number or by an alias, such as the one champion points at.
Get runGet a run with its status, metrics, params, tags and the models it logged.
List registered modelsList registered models with their aliases and newest version.
Log metrics, params and tagsLog metrics, params and tags to a run in one go, such as an evaluation's scores.
Move model version to stage (legacy)Move a model version to Staging, Production, Archived or None.
Register model versionRegister the model a run logged as a new version of a registered model, registering the model's name first if it's new.
Search model versionsList a registered model's versions, or those registered from a run, newest first, with their aliases.
Search runsFind runs in an experiment by a metric, param or tag filter, in the order asked, with their metrics, params and tags.
Set model aliasPoint an alias, such as champion, at a model version, moving it from the version it pointed at.
Update model versionSet a model version's description, and add or change its tags, such as validated = true.

Create run

Start a run in an experiment, to log metrics and params to from a workflow.

Inputs

ExperimentexperimenttextRequired
The experiment. Pick one, or give its name, ID or link.
Run namerun_nametext
A name for the run. Leave blank for one MLflow makes up.
Tagstagsobject
Tags to set, each a name and a value, such as team = fraud.

Outputs

artifact_uritext
Where its files are kept
deletedtrue/false
True when it is in MLflow's trash
descriptiontext
The run's description
duration_secondsnumber
How long it ran, in seconds; empty while it runs
ended_attext
When it ended (ISO 8601, UTC); blank while it runs
experiment_idtext
The ID of the experiment it is in
linktext
Its page in MLflow
logged_model_idslist
The IDs of the models it logged (MLflow 3)
metricsobject
Each metric's latest value, by name
paramsobject
Its params, by name, as text
run_idtext
The run's ID
run_nametext
Its name
started_attext
When it started (ISO 8601, UTC)
statustext
RUNNING, SCHEDULED, FINISHED, FAILED or KILLED
tagsobject
Its own tags, by name (MLflow's system tags left out)
usertext
Who started it
Example output
{
  "artifact_uri": "mlflow-artifacts:/1/8c019ddca7894c08800a84f71c75318e/artifacts",
  "deleted": false,
  "description": "",
  "duration_seconds": 12.609,
  "ended_at": "2026-11-10T09:12:51Z",
  "experiment_id": "1",
  "link": "https://mlflow.example.com/#/experiments/1/runs/8c019ddca7894c08800a84f71c75318e",
  "logged_model_ids": [
    "m-677160f3846547079d1bccb8c1bcc987"
  ],
  "metrics": {
    "accuracy": 0.9111,
    "f1": 0.9191,
    "loss": 0.25
  },
  "params": {
    "C": "1.0",
    "max_iter": "200"
  },
  "run_id": "8c019ddca7894c08800a84f71c75318e",
  "run_name": "logreg-C1.0",
  "started_at": "2026-11-10T09:12:38Z",
  "status": "FINISHED",
  "tags": {
    "team": "ml-platform"
  },
  "user": "admin"
}

Delete model alias

Remove an alias from a registered model. The version itself stays.

Inputs

Registered modelmodeltextRequired
The registered model. Pick one, or type its name.
AliasaliastextRequired
The alias, such as champion: letters, digits, _ and - only.

Outputs

aliastext
The alias
deletedtrue/false
True when it was removed; false when it wasn't set
modeltext
The registered model's name
versionnumber
The version it pointed at; empty when it wasn't set
Example output
{
  "alias": "challenger",
  "deleted": true,
  "model": "iris-classifier",
  "version": 4
}

Delete model version

Delete a version of a registered model for good, with the aliases pointing at it. The run and its files stay.

Inputs

Registered modelmodeltextRequired
The registered model. Pick one, or type its name.
VersionversiontextRequired
The version's number, such as 3. Pick one once the model is chosen.

Outputs

aliases_removedlist
The aliases that pointed at it, removed with it
deletedtrue/false
True when it was deleted; false when there was none
modeltext
The registered model's name
versionnumber
The version's number
Example output
{
  "aliases_removed": [],
  "deleted": true,
  "model": "iris-classifier",
  "version": 2
}

Delete run

Move a run to MLflow's trash, where it can be restored until the server's clean-up removes it.

Inputs

Run IDrun_idtextRequired
The run's ID (32 letters and digits, at the top of its page in MLflow), or a link to the run.

Outputs

already_deletedtrue/false
True when it was in the trash already
deletedtrue/false
True: the run is in MLflow's trash
experiment_idtext
The ID of the experiment it was in
run_idtext
The run's ID
run_nametext
Its name
Example output
{
  "already_deleted": false,
  "deleted": true,
  "experiment_id": "1",
  "run_id": "8c019ddca7894c08800a84f71c75318e",
  "run_name": "logreg-C1.0"
}

End run

Mark a run finished, failed or killed, with the time it ended.

Inputs

Run IDrun_idtextRequired
The run's ID (32 letters and digits, at the top of its page in MLflow), or a link to the run.
Statusstatustext
How the run ended. Defaults to finished.One of: FINISHED, FAILED, KILLED. Default: FINISHED.

Outputs

artifact_uritext
Where its files are kept
deletedtrue/false
True when it is in MLflow's trash
descriptiontext
The run's description
duration_secondsnumber
How long it ran, in seconds; empty while it runs
ended_attext
When it ended (ISO 8601, UTC); blank while it runs
experiment_idtext
The ID of the experiment it is in
linktext
Its page in MLflow
logged_model_idslist
The IDs of the models it logged (MLflow 3)
metricsobject
Each metric's latest value, by name
paramsobject
Its params, by name, as text
run_idtext
The run's ID
run_nametext
Its name
started_attext
When it started (ISO 8601, UTC)
statustext
RUNNING, SCHEDULED, FINISHED, FAILED or KILLED
tagsobject
Its own tags, by name (MLflow's system tags left out)
usertext
Who started it
Example output
{
  "artifact_uri": "mlflow-artifacts:/1/8c019ddca7894c08800a84f71c75318e/artifacts",
  "deleted": false,
  "description": "",
  "duration_seconds": 12.609,
  "ended_at": "2026-11-10T09:12:51Z",
  "experiment_id": "1",
  "link": "https://mlflow.example.com/#/experiments/1/runs/8c019ddca7894c08800a84f71c75318e",
  "logged_model_ids": [
    "m-677160f3846547079d1bccb8c1bcc987"
  ],
  "metrics": {
    "accuracy": 0.9111,
    "f1": 0.9191,
    "loss": 0.25
  },
  "params": {
    "C": "1.0",
    "max_iter": "200"
  },
  "run_id": "8c019ddca7894c08800a84f71c75318e",
  "run_name": "logreg-C1.0",
  "started_at": "2026-11-10T09:12:38Z",
  "status": "FINISHED",
  "tags": {
    "team": "ml-platform"
  },
  "user": "admin"
}

Find best run

Find the finished run in an experiment with the highest or lowest value of a metric, such as the most accurate.

Inputs

ExperimentexperimenttextRequired
The experiment. Pick one, or give its name, ID or link.
MetricmetrictextRequired
The metric to compare, by its name in MLflow, such as accuracy.
Best isgoaltext
Whether the highest or the lowest value is best. Defaults to highest.One of: highest (Highest (accuracy, F1)), lowest (Lowest (loss, error)). Default: highest.
Filterfiltertext
Only runs matching this, written as in MLflow's search box, such as metrics.accuracy > 0.9 and params.model = 'rf'. Text values go in single quotes. Leave blank for every run.

Outputs

experiment_idtext
The experiment's ID
experiment_nametext
Its name
foundtrue/false
True when a finished run has the metric
goaltext
highest or lowest
metrictext
The metric compared
runobject
The best run; empty when none was found
valuenumber
The best run's value of the metric; empty when none was found
Example output
{
  "experiment_id": "1",
  "experiment_name": "iris-classifier",
  "found": true,
  "goal": "highest",
  "metric": "accuracy",
  "run": {
    "artifact_uri": "mlflow-artifacts:/1/8c019ddca7894c08800a84f71c75318e/artifacts",
    "deleted": false,
    "description": "",
    "duration_seconds": 12.609,
    "ended_at": "2026-11-10T09:12:51Z",
    "experiment_id": "1",
    "link": "https://mlflow.example.com/#/experiments/1/runs/8c019ddca7894c08800a84f71c75318e",
    "logged_model_ids": [
      "m-677160f3846547079d1bccb8c1bcc987"
    ],
    "metrics": {
      "accuracy": 0.9111,
      "f1": 0.9191,
      "loss": 0.25
    },
    "params": {
      "C": "1.0",
      "max_iter": "200"
    },
    "run_id": "8c019ddca7894c08800a84f71c75318e",
    "run_name": "logreg-C1.0",
    "started_at": "2026-11-10T09:12:38Z",
    "status": "FINISHED",
    "tags": {
      "team": "ml-platform"
    },
    "user": "admin"
  },
  "value": 0.9111
}

Find or create experiment

Find the experiment with a name, or create it when there is none, to start runs in.

Inputs

Experiment nameexperiment_nametextRequired
The experiment's name, such as churn-model. On Databricks it is a workspace path, such as /Users/you@example.com/churn-model.
Tagstagsobject
Tags for the experiment if it's created, each a name and a value.

Outputs

artifact_locationtext
Where its runs' files are kept
createdtrue/false
True when this step made it; false when it was there already
created_attext
When it was made (ISO 8601, UTC)
experiment_idtext
The experiment's ID
lifecycle_stagetext
active, or deleted when it is in the trash
linktext
Its page in MLflow
nametext
Its name
tagsobject
Its own tags, by name
updated_attext
When it last changed (ISO 8601, UTC)
Example output
{
  "artifact_location": "mlflow-artifacts:/1",
  "created": false,
  "created_at": "2026-11-10T09:12:30Z",
  "experiment_id": "1",
  "lifecycle_stage": "active",
  "link": "https://mlflow.example.com/#/experiments/1",
  "name": "iris-classifier",
  "tags": {
    "team": "ml-platform"
  },
  "updated_at": "2026-11-10T09:12:30Z"
}

Get model version

Get a model version by its number or by an alias, such as the one champion points at.

Inputs

Registered modelmodeltextRequired
The registered model. Pick one, or type its name.
Versionversiontext
The version's number. Leave blank to give an alias instead.
Aliasaliastext
An alias, such as champion, used when no version is given.

Outputs

aliaseslist
The aliases pointing at it, such as champion
created_attext
When it was registered (ISO 8601, UTC)
created_bytext
Who registered it, when MLflow says
descriptiontext
Its description
foundtrue/false
True: the version was found
linktext
Its page in MLflow
modeltext
The registered model's name
model_idtext
The logged model it was registered from (MLflow 3)
run_idtext
The run it was registered from
sourcetext
Where its files are
stagetext
Its stage (legacy): None, Staging, Production or Archived
statustext
READY, PENDING_REGISTRATION or FAILED_REGISTRATION
tagsobject
Its tags, by name
updated_attext
When it last changed (ISO 8601, UTC)
versionnumber
The version's number
Example output
{
  "aliases": [
    "champion"
  ],
  "created_at": "2026-11-10T09:12:58Z",
  "created_by": "",
  "description": "Logistic regression, C=1.0",
  "found": true,
  "link": "https://mlflow.example.com/#/models/iris-classifier/versions/3",
  "model": "iris-classifier",
  "model_id": "m-677160f3846547079d1bccb8c1bcc987",
  "run_id": "8c019ddca7894c08800a84f71c75318e",
  "source": "models:/m-677160f3846547079d1bccb8c1bcc987",
  "stage": "None",
  "status": "READY",
  "tags": {
    "validated": "true"
  },
  "updated_at": "2026-11-10T09:13:40Z",
  "version": 3
}

Get run

Get a run with its status, metrics, params, tags and the models it logged.

Inputs

Run IDrun_idtextRequired
The run's ID (32 letters and digits, at the top of its page in MLflow), or a link to the run.

Outputs

artifact_uritext
Where its files are kept
deletedtrue/false
True when it is in MLflow's trash
descriptiontext
The run's description
duration_secondsnumber
How long it ran, in seconds; empty while it runs
ended_attext
When it ended (ISO 8601, UTC); blank while it runs
experiment_idtext
The ID of the experiment it is in
linktext
Its page in MLflow
logged_model_idslist
The IDs of the models it logged (MLflow 3)
logged_modelslist
The models the run logged
metricsobject
Each metric's latest value, by name
paramsobject
Its params, by name, as text
run_idtext
The run's ID
run_nametext
Its name
started_attext
When it started (ISO 8601, UTC)
statustext
RUNNING, SCHEDULED, FINISHED, FAILED or KILLED
tagsobject
Its own tags, by name (MLflow's system tags left out)
usertext
Who started it
Example output
{
  "artifact_uri": "mlflow-artifacts:/1/8c019ddca7894c08800a84f71c75318e/artifacts",
  "deleted": false,
  "description": "",
  "duration_seconds": 12.609,
  "ended_at": "2026-11-10T09:12:51Z",
  "experiment_id": "1",
  "link": "https://mlflow.example.com/#/experiments/1/runs/8c019ddca7894c08800a84f71c75318e",
  "logged_model_ids": [
    "m-677160f3846547079d1bccb8c1bcc987"
  ],
  "logged_models": [
    {
      "model_id": "m-677160f3846547079d1bccb8c1bcc987",
      "name": "model"
    }
  ],
  "metrics": {
    "accuracy": 0.9111,
    "f1": 0.9191,
    "loss": 0.25
  },
  "params": {
    "C": "1.0",
    "max_iter": "200"
  },
  "run_id": "8c019ddca7894c08800a84f71c75318e",
  "run_name": "logreg-C1.0",
  "started_at": "2026-11-10T09:12:38Z",
  "status": "FINISHED",
  "tags": {
    "team": "ml-platform"
  },
  "user": "admin"
}

List registered models

List registered models with their aliases and newest version.

Inputs

Name containsname_containstext
Only models whose names contain this. Leave blank for all.
How manylimitnumber
The most models to return, up to 200. Defaults to 25.From 1 to 200.

Outputs

countnumber
How many models are returned
modelslist
The registered models, by name
Example output
{
  "count": 1,
  "models": [
    {
      "aliases": [
        {
          "alias": "champion",
          "version": 3
        }
      ],
      "created_at": "2026-11-10T09:12:56Z",
      "description": "Classifies iris flowers.",
      "latest_version": 3,
      "latest_version_stage": "None",
      "link": "https://mlflow.example.com/#/models/iris-classifier",
      "name": "iris-classifier",
      "tags": {},
      "updated_at": "2026-11-10T09:13:40Z"
    }
  ]
}

Log metrics, params and tags

Log metrics, params and tags to a run in one go, such as an evaluation's scores.

Inputs

Run IDrun_idtextRequired
The run's ID (32 letters and digits, at the top of its page in MLflow), or a link to the run.
Metricsmetricsobject
Metrics to log, each a name and a number, such as accuracy = 0.93.
Paramsparamsobject
Params to log, each a name and a value. MLflow won't change a param already logged.
Tagstagsobject
Tags to set, each a name and a value, such as team = fraud.
Stepstepnumber
The step the metrics are for, such as an epoch. Defaults to 0.At least 0.

Outputs

metrics_loggednumber
How many metrics were logged
params_loggednumber
How many params were logged
runobject
The run as it is now
run_idtext
The run's ID
stepnumber
The step the metrics were logged at
tags_loggednumber
How many tags were set
Example output
{
  "metrics_logged": 2,
  "params_logged": 2,
  "run": {
    "artifact_uri": "mlflow-artifacts:/1/8c019ddca7894c08800a84f71c75318e/artifacts",
    "deleted": false,
    "description": "",
    "duration_seconds": 12.609,
    "ended_at": "2026-11-10T09:12:51Z",
    "experiment_id": "1",
    "link": "https://mlflow.example.com/#/experiments/1/runs/8c019ddca7894c08800a84f71c75318e",
    "logged_model_ids": [
      "m-677160f3846547079d1bccb8c1bcc987"
    ],
    "metrics": {
      "accuracy": 0.9111,
      "f1": 0.9191,
      "loss": 0.25
    },
    "params": {
      "C": "1.0",
      "max_iter": "200"
    },
    "run_id": "8c019ddca7894c08800a84f71c75318e",
    "run_name": "logreg-C1.0",
    "started_at": "2026-11-10T09:12:38Z",
    "status": "FINISHED",
    "tags": {
      "team": "ml-platform"
    },
    "user": "admin"
  },
  "run_id": "8c019ddca7894c08800a84f71c75318e",
  "step": 0,
  "tags_logged": 1
}

Move model version to stage (legacy)

Move a model version to Staging, Production, Archived or None. Stages are deprecated in MLflow: use aliases where you can.

Inputs

Registered modelmodeltextRequired
The registered model. Pick one, or type its name.
VersionversiontextRequired
The version's number, such as 3. Pick one once the model is chosen.
StagestagetextRequired
The stage to move the version to.One of: Staging, Production, Archived, None.
Archive the versions therearchive_existing_versionstrue/false
Archive the model's other versions in that stage. Only for Staging and Production.

Outputs

aliaseslist
The aliases pointing at it, such as champion
created_attext
When it was registered (ISO 8601, UTC)
created_bytext
Who registered it, when MLflow says
descriptiontext
Its description
linktext
Its page in MLflow
modeltext
The registered model's name
model_idtext
The logged model it was registered from (MLflow 3)
run_idtext
The run it was registered from
sourcetext
Where its files are
stagetext
Its stage (legacy): None, Staging, Production or Archived
statustext
READY, PENDING_REGISTRATION or FAILED_REGISTRATION
tagsobject
Its tags, by name
updated_attext
When it last changed (ISO 8601, UTC)
versionnumber
The version's number
Example output
{
  "aliases": [
    "champion"
  ],
  "created_at": "2026-11-10T09:12:58Z",
  "created_by": "",
  "description": "Logistic regression, C=1.0",
  "link": "https://mlflow.example.com/#/models/iris-classifier/versions/3",
  "model": "iris-classifier",
  "model_id": "m-677160f3846547079d1bccb8c1bcc987",
  "run_id": "8c019ddca7894c08800a84f71c75318e",
  "source": "models:/m-677160f3846547079d1bccb8c1bcc987",
  "stage": "None",
  "status": "READY",
  "tags": {
    "validated": "true"
  },
  "updated_at": "2026-11-10T09:13:40Z",
  "version": 3
}

Register model version

Register the model a run logged as a new version of a registered model, registering the model's name first if it's new.

Inputs

Registered modelmodeltextRequired
The registered model to add a version to. Pick one, or type a name to register a new one.
Run IDrun_idtextRequired
The run's ID (32 letters and digits, at the top of its page in MLflow), or a link to the run.
Model in the runlogged_modeltext
The model's name in the run, as logged (such as model). Leave blank for the run's only model, or the one named model.
Descriptiondescriptiontext
A description for the new version.
Tagstagsobject
Tags to set, each a name and a value, such as team = fraud.

Outputs

aliaseslist
The aliases pointing at it, such as champion
created_attext
When it was registered (ISO 8601, UTC)
created_bytext
Who registered it, when MLflow says
created_modeltrue/false
True when this step also registered the model's name
descriptiontext
Its description
linktext
Its page in MLflow
modeltext
The registered model's name
model_idtext
The logged model it was registered from (MLflow 3)
run_idtext
The run it was registered from
sourcetext
Where its files are
stagetext
Its stage (legacy): None, Staging, Production or Archived
statustext
READY, PENDING_REGISTRATION or FAILED_REGISTRATION
tagsobject
Its tags, by name
updated_attext
When it last changed (ISO 8601, UTC)
versionnumber
The version's number
Example output
{
  "aliases": [],
  "created_at": "2026-11-10T09:12:58Z",
  "created_by": "",
  "created_model": false,
  "description": "Logistic regression, C=1.0",
  "link": "https://mlflow.example.com/#/models/iris-classifier/versions/3",
  "model": "iris-classifier",
  "model_id": "m-677160f3846547079d1bccb8c1bcc987",
  "run_id": "8c019ddca7894c08800a84f71c75318e",
  "source": "models:/m-677160f3846547079d1bccb8c1bcc987",
  "stage": "None",
  "status": "READY",
  "tags": {
    "validated": "true"
  },
  "updated_at": "2026-11-10T09:13:40Z",
  "version": 3
}

Search model versions

List a registered model's versions, or those registered from a run, newest first, with their aliases.

Inputs

Registered modelmodeltext
Only this model's versions. Pick one, or type its name. Leave blank for every model.
Run IDrun_idtext
Only versions registered from this run. Leave blank for any.
How manylimitnumber
The most versions to return, up to 200. Defaults to 25.From 1 to 200.

Outputs

countnumber
How many versions are returned
versionslist
The versions, newest first
Example output
{
  "count": 1,
  "versions": [
    {
      "aliases": [
        "champion"
      ],
      "created_at": "2026-11-10T09:12:58Z",
      "created_by": "",
      "description": "Logistic regression, C=1.0",
      "link": "https://mlflow.example.com/#/models/iris-classifier/versions/3",
      "model": "iris-classifier",
      "model_id": "m-677160f3846547079d1bccb8c1bcc987",
      "run_id": "8c019ddca7894c08800a84f71c75318e",
      "source": "models:/m-677160f3846547079d1bccb8c1bcc987",
      "stage": "None",
      "status": "READY",
      "tags": {
        "validated": "true"
      },
      "updated_at": "2026-11-10T09:13:40Z",
      "version": 3
    }
  ]
}

Search runs

Find runs in an experiment by a metric, param or tag filter, in the order asked, with their metrics, params and tags.

Inputs

ExperimentexperimenttextRequired
The experiment. Pick one, or give its name, ID or link.
Filterfiltertext
Only runs matching this, written as in MLflow's search box, such as metrics.accuracy > 0.9 and params.model = 'rf'. Text values go in single quotes. Leave blank for every run.
Order byorder_bytext
How to order the runs, such as metrics.accuracy DESC; separate several with commas. Leave blank for newest first.
Statusstatustext
Only runs with this status. Leave blank for any.One of: FINISHED, FAILED, RUNNING, KILLED.
How manylimitnumber
The most runs to return, up to 200. Defaults to 25.From 1 to 200.

Outputs

countnumber
How many runs are returned
experiment_idtext
The experiment's ID
experiment_nametext
Its name
runslist
The runs found
Example output
{
  "count": 1,
  "experiment_id": "1",
  "experiment_name": "iris-classifier",
  "runs": [
    {
      "artifact_uri": "mlflow-artifacts:/1/8c019ddca7894c08800a84f71c75318e/artifacts",
      "deleted": false,
      "description": "",
      "duration_seconds": 12.609,
      "ended_at": "2026-11-10T09:12:51Z",
      "experiment_id": "1",
      "link": "https://mlflow.example.com/#/experiments/1/runs/8c019ddca7894c08800a84f71c75318e",
      "logged_model_ids": [
        "m-677160f3846547079d1bccb8c1bcc987"
      ],
      "metrics": {
        "accuracy": 0.9111,
        "f1": 0.9191,
        "loss": 0.25
      },
      "params": {
        "C": "1.0",
        "max_iter": "200"
      },
      "run_id": "8c019ddca7894c08800a84f71c75318e",
      "run_name": "logreg-C1.0",
      "started_at": "2026-11-10T09:12:38Z",
      "status": "FINISHED",
      "tags": {
        "team": "ml-platform"
      },
      "user": "admin"
    }
  ]
}

Set model alias

Point an alias, such as champion, at a model version, moving it from the version it pointed at.

Inputs

Registered modelmodeltextRequired
The registered model. Pick one, or type its name.
AliasaliastextRequired
The alias, such as champion: letters, digits, _ and - only.
VersionversiontextRequired
The version's number, such as 3. Pick one once the model is chosen.

Outputs

aliastext
The alias
modeltext
The registered model's name
model_versionobject
The version it points at now
movedtrue/false
True when it now points at a different version
previous_versionnumber
The version it pointed at before; empty when it is new
versionnumber
The version it points at now
Example output
{
  "alias": "champion",
  "model": "iris-classifier",
  "model_version": {
    "aliases": [
      "champion"
    ],
    "created_at": "2026-11-10T09:12:58Z",
    "created_by": "",
    "description": "Logistic regression, C=1.0",
    "link": "https://mlflow.example.com/#/models/iris-classifier/versions/3",
    "model": "iris-classifier",
    "model_id": "m-677160f3846547079d1bccb8c1bcc987",
    "run_id": "8c019ddca7894c08800a84f71c75318e",
    "source": "models:/m-677160f3846547079d1bccb8c1bcc987",
    "stage": "None",
    "status": "READY",
    "tags": {
      "validated": "true"
    },
    "updated_at": "2026-11-10T09:13:40Z",
    "version": 3
  },
  "moved": true,
  "previous_version": 2,
  "version": 3
}

Update model version

Set a model version's description, and add or change its tags, such as validated = true.

Inputs

Registered modelmodeltextRequired
The registered model. Pick one, or type its name.
VersionversiontextRequired
The version's number, such as 3. Pick one once the model is chosen.
Descriptiondescriptiontext
The version's new description. Leave blank to keep it.
Tagstagsobject
Tags to set, each a name and a value, such as team = fraud.

Outputs

aliaseslist
The aliases pointing at it, such as champion
created_attext
When it was registered (ISO 8601, UTC)
created_bytext
Who registered it, when MLflow says
descriptiontext
Its description
linktext
Its page in MLflow
modeltext
The registered model's name
model_idtext
The logged model it was registered from (MLflow 3)
run_idtext
The run it was registered from
sourcetext
Where its files are
stagetext
Its stage (legacy): None, Staging, Production or Archived
statustext
READY, PENDING_REGISTRATION or FAILED_REGISTRATION
tagsobject
Its tags, by name
updated_attext
When it last changed (ISO 8601, UTC)
versionnumber
The version's number
Example output
{
  "aliases": [
    "champion"
  ],
  "created_at": "2026-11-10T09:12:58Z",
  "created_by": "",
  "description": "Logistic regression, C=1.0",
  "link": "https://mlflow.example.com/#/models/iris-classifier/versions/3",
  "model": "iris-classifier",
  "model_id": "m-677160f3846547079d1bccb8c1bcc987",
  "run_id": "8c019ddca7894c08800a84f71c75318e",
  "source": "models:/m-677160f3846547079d1bccb8c1bcc987",
  "stage": "None",
  "status": "READY",
  "tags": {
    "validated": "true"
  },
  "updated_at": "2026-11-10T09:13:40Z",
  "version": 3
}

On this page