API Reference
ModelHub API
API surface for SOIT model providers and model catalog entries.
The ModelHub API manages model providers, model entries, and related configuration used by agents and workflows.
Prefix
/api/v1/modelhubEndpoint families
| Method | Path | Purpose |
|---|---|---|
| GET / POST | /providers | List and create providers |
| PATCH / DELETE | /providers/{provider_id} | Update or remove a provider |
| POST | /providers/{provider_id}/healthcheck | Connectivity diagnostic |
| GET | /providers/support-matrix | Provider capability support matrix |
| GET / POST / PATCH / DELETE | /providers/{provider_id}/models | Manage a provider's model entries |
| POST / GET | /providers/{provider_id}/sync-from-platform, /sync-jobs | Sync models from the platform catalog |
| GET / POST | /platform-models (+ /sync) | Platform model catalog |
| GET | /workbench/overview, /workbench/models, /workbench/providers | Workbench views for the UI |
| POST | /test/chat, /test/embeddings | Live chat and embedding diagnostics |
| GET / POST | /virtual-models | List and create virtual models (vmodel:{slug}) |
| GET / PATCH / DELETE | /virtual-models/{virtual_model_id} | Read, edit, or delete a virtual model |
Related prefixes
/api/v1/agents,/api/v1/workflows— where model references are bound/api/v1/runs— model usage, tokens, and cost per call
Notes
- Provider credentials are stored as secret references, never plaintext.
- See the provider support matrix for runtime capabilities per provider.
- A virtual model is an ordered list of up to eight
model:refs tried in turn — see Virtual models.