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

# 创建工具实例

`POST /admin/toolset/instances`

## Request

- The document declares no server URL.
- Auth: none declared

根据工具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

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

---

[API](https://skmtc.dev/hust-open-atom-club/apis/apiserver-api.md) - [All operations](https://skmtc.dev/hust-open-atom-club/apis/apiserver-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hust-open-atom-club/apis/apiserver-api/revisions/34214ad5a103?raw)