Delete a version of a model

DELETE 
/models/:modelId/versions/:version

Available in development only — the sandbox and production tables are replicas of development, so models cannot be written there.

Deletes the version outright. A version that has been published beyond development carries frozenAt and cannot be deleted — its number must stay a faithful record of what those environments ran.

A version an environment still resolves to cannot be deleted either: there is no unpublishing, so removing what an environment points at would strand it. Publish another version to that environment first, or — for a model's only version — delete the model instead.

Request

Responses

204

Version deleted successfully

401

Missing or invalid bearer token

403

Token does not carry the management:models:write scope, or models are read-only in this environment

404

No such version of this model

409

The version has been published beyond development, or an environment still resolves to it — delete the model instead if it is the only version