Models
Endpoints
Every model route at a glance — core catalog, foundation models, and BYOM.
All routes require the Authorization header. The core /v1/models
routes and the BYOM routes also require X-Workspace-Id — sending it
on every call is harmless.
Models (/v1/models)
| Method | Path | Purpose |
|---|---|---|
| POST | /v1/models | Create a model (any kind) |
| GET | /v1/models | List your models |
| GET | /v1/models/{uid} | Get one model |
| GET | /v1/models/public | Browse the public catalog (paginated) |
| GET | /v1/models/recommended | Get the recommended model |
| POST | /v1/models/deploy-foundation | Deploy a foundation model zero-shot |
Foundation (/v1/models/foundation)
One namespace for every foundation model — predictfm included.
| Method | Path | Purpose |
|---|---|---|
| GET | /v1/models/foundation | List foundation models |
| GET | /v1/models/foundation/{family}/{slug} | Get one foundation model |
| GET | /v1/models/foundation/adapters | List adapters |
| GET | /v1/models/foundation/adapters/{adapter_id} | Get one adapter |
BYOM (/v1/models/byom)
| Method | Path | Purpose |
|---|---|---|
| POST | /v1/models/byom/upload | BYOM step 1 — upload |
| POST | /v1/models/byom/validate | BYOM step 2 — validate |
| POST | /v1/models/byom/register | BYOM step 3 — register |
| GET | /v1/models/byom/{blueprint_id}/download | Download your model |