---
title: "创建工具实例"
method: POST
path: "/admin/toolset/instances"
tags: ["toolset"]
---

# 创建工具实例

`POST /admin/toolset/instances`

根据工具ID和参数创建并运行工具实例

## Request body

- ModelToolCreateInstanceReq
  - `args` object
  - `toolId` string

## Response `200`

OK

- ModelToolInstanceHistoryDTO
  - `endTime` string
  - `err` string
  - `id` string
  - `isRunning` boolean
  - `launchUserName` string
  - `ret` integer
  - `startTime` string
  - `tool` ModelToolDTO
    - `allowedSignals` ModelToolSignalDTO[]
      - `description` string
      - `name` string
      - `value` integer
    - `args` ModelToolArgDTO[]
      - `default` unknown
      - `description` string
      - `name` string — Name is the name of the argument.
      - `type` string
    - `description` string
    - `group` string
    - `id` string — ID is the unique identifier for the toolset.
    - `name` string
  - `toolId` string
  - `toolName` string

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

## Changes

- **2025-05-21** `9252e714e560` — 1 info
  - endpoint added
- **2025-02-07** `2e28347b5811` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/hust-open-atom-club/apis/untitled-api/changes/admin/toolset/instances/post.md)

---

[API](https://skmtc.dev/hust-open-atom-club/apis/untitled-api.md) · [All operations](https://skmtc.dev/hust-open-atom-club/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hust-open-atom-club/untitled-api/revisions/34214ad5a103/schema)