---
title: "Deploy V2 Script"
method: POST
path: "/bot-orchestration/deploy-v2-script"
tags: ["Bot Orchestration"]
---

# Deploy V2 Script

`POST /bot-orchestration/deploy-v2-script`

Deploy a V2 script bot with optional script configuration.
This endpoint creates and starts a Hummingbot instance running the specified script.

Args:
    deployment: V2ScriptDeployment configuration containing instance name, credentials,
               optional script name and configuration
    docker_manager: Docker service dependency
    db_manager: Database manager dependency

Returns:
    Dictionary with deployment response including instance details

Raises:
    HTTPException: 500 if deployment fails

## Request body

- V2ScriptDeployment — Configuration for deploying a bot with a script
  - `instance_name` string, required — Unique name for the bot instance
  - `credentials_profile` string, required — Name of the credentials profile to use
  - `image` string — Docker image for the Hummingbot instance
  - `script` string, nullable — Script name to run (without .py extension)
  - `script_config` string, nullable — Script configuration file name (without .yml extension)
  - `headless` boolean — Run in headless mode (no UI)

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/hummingbot/apis/hummingbot-api.md) · [All operations](https://skmtc.net/hummingbot/apis/hummingbot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hummingbot/hummingbot-api/revisions/5347fe79537f/schema)