> ## Documentation Index
> Fetch the complete documentation index at: https://condor.hummingbot.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Stop And Archive Bot

> Gracefully stop a bot and archive its data in the background.
This initiates a background task that will:
1. Stop the bot trading process via MQTT
2. Wait 15 seconds for graceful shutdown
3. Monitor and stop the Docker container
4. Archive the bot data (locally or to S3)
5. Remove the container

Returns immediately with a success message while the process continues in the background.



## OpenAPI

````yaml /api-reference/openapi.json post /bot-orchestration/stop-and-archive-bot/{bot_name}
openapi: 3.1.0
info:
  title: Hummingbot API
  description: API for managing Hummingbot trading instances
  version: 1.0.1
servers:
  - url: http://localhost:8000
    description: Local development server
security: []
paths:
  /bot-orchestration/stop-and-archive-bot/{bot_name}:
    post:
      tags:
        - Bot Orchestration
      summary: Stop And Archive Bot
      description: >-
        Gracefully stop a bot and archive its data in the background.

        This initiates a background task that will:

        1. Stop the bot trading process via MQTT

        2. Wait 15 seconds for graceful shutdown

        3. Monitor and stop the Docker container

        4. Archive the bot data (locally or to S3)

        5. Remove the container


        Returns immediately with a success message while the process continues
        in the background.
      operationId: >-
        stop_and_archive_bot_bot_orchestration_stop_and_archive_bot__bot_name__post
      parameters:
        - name: bot_name
          in: path
          required: true
          schema:
            type: string
            title: Bot Name
        - name: skip_order_cancellation
          in: query
          required: false
          schema:
            type: boolean
            default: true
            title: Skip Order Cancellation
        - name: archive_locally
          in: query
          required: false
          schema:
            type: boolean
            default: true
            title: Archive Locally
        - name: s3_bucket
          in: query
          required: false
          schema:
            type: string
            title: S3 Bucket
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBasic: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBasic:
      type: http
      scheme: basic

````