---
title: "POST /admin/tools"
method: POST
path: "/admin/tools"
tags: ["OpenAPI Tools Admin (Deprecated)"]
---

# POST /admin/tools

`POST /admin/tools`

## Request

- Base URL: `https://api.prompteus.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.prompteus.com/admin/tools`
- Auth: none declared

Create a tool from custom definition

## Request body

- object
  - `id` string, cuid
  - `name` string, required
  - `slug` string, required
  - `baseUrl` string, required
  - `path` string, required
  - `method` string, required
  - `authValue` string, nullable, required
  - `oasOperation` OpenApiOperation, required
    - `summary` string
    - `description` string
    - `parameters` OpenApiParameter[]
      - `name` string, required
      - `in` 'query' | 'header' | 'path' | 'cookie', required
      - `description` string
      - `required` boolean
      - `schema` unknown
  - `security` union
    - object
      - `type` 'apiKey', required
      - `description` string
      - `name` string, required
      - `in` 'query' | 'header' | 'cookie', required
    - object
      - `type` 'http', required
      - `description` string
      - `scheme` string, required
      - `bearerFormat` string
    - object
      - `type` 'none', required

## Response `200`

Created tool

- Tool
  - `id` string, cuid, required
  - `name` string, required
  - `slug` string, required
  - `organizationId` string, required
  - `baseUrl` string, required
  - `path` string, required
  - `method` string, required
  - `authValue` string, nullable, required
  - `oasOperation` OpenApiOperation, required
    - `summary` string
    - `description` string
    - `parameters` OpenApiParameter[]
      - `name` string, required
      - `in` 'query' | 'header' | 'path' | 'cookie', required
      - `description` string
      - `required` boolean
      - `schema` unknown
  - `security` union
    - object
      - `type` 'apiKey', required
      - `description` string
      - `name` string, required
      - `in` 'query' | 'header' | 'cookie', required
    - object
      - `type` 'http', required
      - `description` string
      - `scheme` string, required
      - `bearerFormat` string
    - object
      - `type` 'none', required

---

[API](https://skmtc.dev/prompteus/apis/prompteus-api.md) - [All operations](https://skmtc.dev/prompteus/apis/prompteus-api/llms.txt) - [OpenAPI document](https://skmtc.dev/prompteus/apis/prompteus-api/revisions/50945f0ce58a?raw)