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
| Action | What it does |
|---|---|
| Create run | Start a run in an experiment, to log metrics and params to from a workflow. |
| Delete model alias | Remove an alias from a registered model. |
| Delete model version | Delete a version of a registered model for good, with the aliases pointing at it. |
| Delete run | Move a run to MLflow's trash, where it can be restored until the server's clean-up removes it. |
| End run | Mark a run finished, failed or killed, with the time it ended. |
| Find best run | Find the finished run in an experiment with the highest or lowest value of a metric, such as the most accurate. |
| Find or create experiment | Find the experiment with a name, or create it when there is none, to start runs in. |
| Get model version | Get a model version by its number or by an alias, such as the one champion points at. |
| Get run | Get a run with its status, metrics, params, tags and the models it logged. |
| List registered models | List registered models with their aliases and newest version. |
| Log metrics, params and tags | Log 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 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. |
| Search model versions | List a registered model's versions, or those registered from a run, newest first, with their aliases. |
| Search runs | Find runs in an experiment by a metric, param or tag filter, in the order asked, with their metrics, params and tags. |
| Set model alias | Point an alias, such as champion, at a model version, moving it from the version it pointed at. |
| Update model version | Set 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
- Experiment
experimenttextRequired - The experiment. Pick one, or give its name, ID or link.
- Run name
run_nametext - A name for the run. Leave blank for one MLflow makes up.
- Tags
tagsobject - 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 model
modeltextRequired - The registered model. Pick one, or type its name.
- Alias
aliastextRequired - 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 model
modeltextRequired - The registered model. Pick one, or type its name.
- Version
versiontextRequired - 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 ID
run_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 ID
run_idtextRequired - The run's ID (32 letters and digits, at the top of its page in MLflow), or a link to the run.
- Status
statustext - 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
- Experiment
experimenttextRequired - The experiment. Pick one, or give its name, ID or link.
- Metric
metrictextRequired - The metric to compare, by its name in MLflow, such as accuracy.
- Best is
goaltext - Whether the highest or the lowest value is best. Defaults to highest.One of:
highest(Highest (accuracy, F1)),lowest(Lowest (loss, error)). Default:highest. - Filter
filtertext - 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 name
experiment_nametextRequired - The experiment's name, such as churn-model. On Databricks it is a workspace path, such as /Users/you@example.com/churn-model.
- Tags
tagsobject - 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 model
modeltextRequired - The registered model. Pick one, or type its name.
- Version
versiontext - The version's number. Leave blank to give an alias instead.
- Alias
aliastext - 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 ID
run_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 contains
name_containstext - Only models whose names contain this. Leave blank for all.
- How many
limitnumber - 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 ID
run_idtextRequired - The run's ID (32 letters and digits, at the top of its page in MLflow), or a link to the run.
- Metrics
metricsobject - Metrics to log, each a name and a number, such as accuracy = 0.93.
- Params
paramsobject - Params to log, each a name and a value. MLflow won't change a param already logged.
- Tags
tagsobject - Tags to set, each a name and a value, such as team = fraud.
- Step
stepnumber - 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 model
modeltextRequired - The registered model. Pick one, or type its name.
- Version
versiontextRequired - The version's number, such as 3. Pick one once the model is chosen.
- Stage
stagetextRequired - The stage to move the version to.One of:
Staging,Production,Archived,None. - Archive the versions there
archive_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 model
modeltextRequired - The registered model to add a version to. Pick one, or type a name to register a new one.
- Run ID
run_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 run
logged_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.
- Description
descriptiontext - A description for the new version.
- Tags
tagsobject - 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 model
modeltext - Only this model's versions. Pick one, or type its name. Leave blank for every model.
- Run ID
run_idtext - Only versions registered from this run. Leave blank for any.
- How many
limitnumber - 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
- Experiment
experimenttextRequired - The experiment. Pick one, or give its name, ID or link.
- Filter
filtertext - 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 by
order_bytext - How to order the runs, such as metrics.accuracy DESC; separate several with commas. Leave blank for newest first.
- Status
statustext - Only runs with this status. Leave blank for any.One of:
FINISHED,FAILED,RUNNING,KILLED. - How many
limitnumber - 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 model
modeltextRequired - The registered model. Pick one, or type its name.
- Alias
aliastextRequired - The alias, such as champion: letters, digits, _ and - only.
- Version
versiontextRequired - 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 model
modeltextRequired - The registered model. Pick one, or type its name.
- Version
versiontextRequired - The version's number, such as 3. Pick one once the model is chosen.
- Description
descriptiontext - The version's new description. Leave blank to keep it.
- Tags
tagsobject - 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
}