LLM Registry

Operations of the LLM Registry API. Paths are relative to your deployment's API host.

POST /api/llm-registry-api/model-config/preview

Preview which model a lane resolves to in an organisation Space (org admin)

Authentication: bearer token (Authorization: Bearer <token>)

Request body: application/json PreviewModelResolutionDto

POST /api/llm-registry-api/model-config/resolve

Resolve the model for one invocation, in a given Space (internal)

Authentication: bearer token (Authorization: Bearer <token>)

Request body: application/json ResolveModelForInvocationDto

GET /api/llm-registry-api/models

List the organisation's models across its providers, each with its provider and whether resolution would serve it

Authentication: bearer token (Authorization: Bearer <token>)

GET /api/llm-registry-api/models/{id}

Get a model by id (org-scoped, across providers)

Authentication: bearer token (Authorization: Bearer <token>)

DELETE /api/llm-registry-api/models/{id}

Delete a model by id (org-scoped, across providers)

Authentication: bearer token (Authorization: Bearer <token>)

PATCH /api/llm-registry-api/models/{modelId}

Update a model (toggle active, change display name, etc.)

Authentication: bearer token (Authorization: Bearer <token>)

Request body: application/json UpdateModelDto

PUT /api/llm-registry-api/models/{modelId}/retirement

Retire a model from an instant, optionally naming the successor resolutions use instead

For a model under the organisation's own provider; a platform-catalogue model is refused 403 MODEL_RETIREMENT_PLATFORM_MODEL, an unknown one 404. From retiresAt on, every resolution that would pick the model resolves to successorModelId and records the substitution (retirement, reason model-retired); with no successor it is refused with MODEL_RETIRED_NO_SUCCESSOR. Answers 422 MODEL_RETIREMENT_SUCCESSOR_IS_SELF, MODEL_RETIREMENT_SUCCESSOR_CYCLE, MODEL_RETIREMENT_SUCCESSOR_RETIRED, MODEL_RETIREMENT_SUCCESSOR_NOT_SERVED or MODEL_RETIREMENT_SUCCESSOR_CHAIN_TOO_LONG; nothing is written.

Authentication: bearer token (Authorization: Bearer <token>)

Request body: application/json SetModelRetirementDto

DELETE /api/llm-registry-api/models/{modelId}/retirement

Clear a model's retirement (instant and successor)

Authentication: bearer token (Authorization: Bearer <token>)

GET /api/llm-registry-api/projects/{projectId}/model-config/resolved

Get resolved model config for project (with defaults)

Authentication: bearer token (Authorization: Bearer <token>)

GET /api/llm-registry-api/providers

List LLM providers

Authentication: bearer token (Authorization: Bearer <token>)

POST /api/llm-registry-api/providers

Create an LLM provider

Authentication: bearer token (Authorization: Bearer <token>)

Request body: application/json CreateProviderDto

POST /api/llm-registry-api/providers/probe

Probe an unsaved provider endpoint for its model list (pre-create autofill)

Authentication: bearer token (Authorization: Bearer <token>)

Request body: application/json ProbeProviderDto

GET /api/llm-registry-api/providers/{id}

Get LLM provider details

Authentication: bearer token (Authorization: Bearer <token>)

PATCH /api/llm-registry-api/providers/{id}

Update an LLM provider

Authentication: bearer token (Authorization: Bearer <token>)

Request body: application/json UpdateProviderDto

DELETE /api/llm-registry-api/providers/{id}

Delete an LLM provider

Authentication: bearer token (Authorization: Bearer <token>)

GET /api/llm-registry-api/providers/{id}/deletion-impact

Get impact analysis before deleting a provider

Authentication: bearer token (Authorization: Bearer <token>)

POST /api/llm-registry-api/providers/{id}/test

Test LLM provider connectivity

Authentication: bearer token (Authorization: Bearer <token>)

GET /api/llm-registry-api/providers/{providerId}/models

List models on a provider

Authentication: bearer token (Authorization: Bearer <token>)

POST /api/llm-registry-api/providers/{providerId}/models

Register a model on a provider

Authentication: bearer token (Authorization: Bearer <token>)

Request body: application/json CreateModelDto

POST /api/llm-registry-api/providers/{providerId}/models/sync

Sync models from provider endpoint

Authentication: bearer token (Authorization: Bearer <token>)