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.

[Reconcile cached models](https://ottomfg.com/docs/sync.md)

API v1 preview

Source: https://ottomfg.com/docs/delete-models