Skip to main content
Applicable to anyone who:Not applicable if you never install these packages and never call the Repositories APIs from custom code.

What Is Changing

Two related changes:
  1. Repositories APIs move from /api/ml to /api/svc (same methods, query params, and bodies).
  2. Older packages that still call /api/ml are deprecated: truefoundry<0.17.0 and truefoundry-sdk<0.4.0.
The APIs themselves are not going away — only the old prefix and old package versions. Self-hosted tenants are unaffected until they upgrade to 0.190.x.

Repositories API paths

These HTTP APIs are covered: Example: https://<control-plane-url>/api/ml/v1/models → https://<control-plane-url>/api/svc/v1/models

Package versions

Supported versions already call /api/svc. On control plane 0.190.x, older truefoundry clients are rejected with:
truefoundry>=0.17.0 requires Python 3.10+ and removes run.log_images() / run.log_plots(). See:

What You Need to Do

If you only use truefoundry or truefoundry-sdk, upgrade the package — you do not need to edit URLs by hand. If you call these APIs over HTTP yourself, change /api/ml to /api/svc.
1

Upgrade Python to 3.10 or later

Required for truefoundry 0.17.x. See Minimum Python version raised to 3.10.
2

Upgrade packages

3

Update every pin

Laptops, CI (tfy apply / GitHub Actions), requirements.txt / lockfiles, and job or notebook images.
Complete the upgrade before your control plane reaches 0.190.x. After that, older packages and /api/ml calls will fail.
If you have questions or need help, reach out to support@truefoundry.com.