---
title: "Replace the models in a pool"
method: PUT
path: "/admin/llm/call-pools/{id}/models"
tags: ["Admin LLM"]
---

# Replace the models in a pool

`PUT /admin/llm/call-pools/{id}/models`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/admin/llm/call-pools/{id}/models`
- Auth: HTTP bearer

## Path parameters

- `id` integer, required

## Request body

- UpdateLlmCallPoolModelsRequest: The models whose calls share a pool
  - `instanceModelIds` integer[], required: Ids of instance models
  - `workspaceModelIds` integer[], required: Ids of models on workspaces' own connections

## Response `200`

OK

- LlmCallPoolModel[]
  - `callPoolId` integer: The pool the model is in; null for none
  - `connectionDisplayName` string, required: Connection's display name
  - `displayName` string, required: Human-readable name
  - `host` string: The connection's host; null when its URL has none
  - `modelId` integer, required: Model id within its scope
  - `scope` 'INSTANCE' | 'WORKSPACE', required: INSTANCE for the instance catalog, WORKSPACE for a workspace's own model
  - `workspaceSlug` string: Slug of the workspace that owns the model; null for an instance model

## Other responses

- `404`: Pool or model not found
- `409`: The pool still has calls, rate history, or a cooldown

## Changes

- **2026-10-29** `ff0bf3f056b6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hephaestus-build/apis/hephaestus-api/changes/admin/llm/call-pools/:id/models/put.md)

---

[API](https://skmtc.dev/hephaestus-build/apis/hephaestus-api.md) - [All operations](https://skmtc.dev/hephaestus-build/apis/hephaestus-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hephaestus-build/apis/hephaestus-api/revisions/5d989120094e?raw)