---
title: "Load a model into the engine"
method: POST
path: "/v1/engine/load"
tags: ["Engine"]
---

# Load a model into the engine

`POST /v1/engine/load`

## Request

- Base URL: `http://localhost:9998`
- URL: `http://localhost:9998/v1/engine/load`
- Auth: HTTP bearer

## Request body

- object
  - `modelId` string, required: Model identifier — accepts UUID, preset ID, or model stem (flexible resolution)

## Response `200`

Model loading started

- object
  - `ok` true
  - `modelId` string

## Other responses

- `400`: Invalid request
- `404`: Resource not found

---

[API](https://skmtc.dev/modelpiper/apis/toolpiper-api.md) · [All operations](https://skmtc.dev/modelpiper/apis/toolpiper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/modelpiper/apis/toolpiper-api/revisions/6722bf56385c?raw)