Method: projects.models.versions.delete

Deletes a model version.

Each model can have multiple versions deployed and in use at any given time. Use this method to remove a single version.

Note: You cannot delete the version that is set as the default version of the model unless it is the only remaining version.

HTTP request

DELETE https://{endpoint}/v1/{name=projects/*/models/*/versions/*}

Where {endpoint} is one of the supported service endpoints.

The URLs use gRPC Transcoding syntax.

Path parameters



Required. The name of the version. You can get the names of all the versions of a model by calling projects.models.versions.list.

Authorization requires the following IAM permission on the specified resource name:

  • ml.versions.delete

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of Operation.

Authorization Scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.