> ## Documentation Index
> Fetch the complete documentation index at: https://perps-api.vooi.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete a bot

> Deletes a stopped bot that holds no pair; the row is the only record of an open pair, so a running or holding bot is refused. A halted bot is deletable whatever it holds, since its pair is already in human hands.



## OpenAPI

````yaml https://vooi-api-app.fly.dev/swagger/json delete /bots/{id}
openapi: 3.1.0
info:
  title: VOOI API
  description: Unified perps API
  version: '1.0'
  contact: {}
servers:
  - url: https://perps-api.vooi.io
security: []
tags: []
paths:
  /bots/{id}:
    delete:
      tags:
        - Bots
      summary: Delete a bot
      description: >-
        Deletes a stopped bot that holds no pair; the row is the only record of
        an open pair, so a running or holding bot is refused. A halted bot is
        deletable whatever it holds, since its pair is already in human hands.
      operationId: BotController_deleteBot
      parameters:
        - name: id
          required: true
          in: path
          schema:
            example: '12'
            type: string
            pattern: ^[1-9]\d*$
          description: Bot identifier
      responses:
        '404':
          description: Bot not found
        '409':
          description: >-
            The bot is running, or is stopped while still holding a pair and has
            not halted
      security:
        - bearer: []
components:
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.