API v1 preview
Delete models
Remove a model and handle existing references safely.
Delete a model
DELETE requires models:write and returns the model ID with deleted: true. Subsequent GET and repeated DELETE return 404 model_not_found. Lists exclude the deleted model.
Delete a model
# Set MODEL_ID to the model you intend to delete. Requires models:write.
curl --fail-with-body --request DELETE \
"${API_BASE_URL%/}/api/v1/models/$MODEL_ID" \
--header "Authorization: Bearer $OTTOMFG_API_KEY"
# Success: {"id":"MD-7K3P9D2Q","deleted":true}. Repeated DELETE returns 404.
# A 409 model_in_use means an order references this model; keep the model.
References and recovery
A model referenced by any order, including a cancelled order, returns 409 model_in_use. Deleting a model does not delete its linked source file, which may back other models.
After a lost DELETE response, retrieving the model determines whether it remains accessible. Retrying DELETE cannot delete another resource. A creation replay returns its original snapshot and never restores a deleted model.
API v1 preview