Edit a Model Key

Update the model key assigned to a checkpoint in Datature Vi. Model keys are customizable identifiers that help you organize and reference specific checkpoints. The underlying run ID never changes when you edit a key.

Before You Start

Access to the training project containing the model

Open your training project

Go to Training in the sidebar and click the project containing the model you want to edit.

You should see

Models tab showing the model with its updated key visible in the card details

The new key appears in the platform and in API responses. The run ID remains unchanged.

What changes and what doesn't

Item

Changed?

Model checkpoint identifier

Key returned in API responses

Identifier in deployment configurations

Run ID (model ID)

Model weights and training configuration

Training metrics and evaluation results

Display name (change separately with Rename Model)

Model ID vs model key: The run ID is the permanent internal identifier. It never changes. The model key is a human-readable label you can update any time. For critical integrations, always reference the run ID rather than the model key.

Update references after changing a key

If any deployment scripts, documentation, or integration code references the old key by name, update those references. Scripts that use the run ID directly are unaffected.

Next steps

Rename A Model

Update the display name independently from the checkpoint key.

Delete A Model

Permanently remove a model you no longer need.

Manage Models

Overview of all model management operations in Datature Vi.