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

# Deploy V2 Script

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

Creates and autostart a v2 script with a configuration if present.

Args:
    config: Configuration for the new Hummingbot instance
    docker_manager: Docker service dependency
    db_manager: Database manager dependency
    
Returns:
    Dictionary with creation response and instance details

## 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 — Name of the script to run (without .py extension)
  - `script_config` string, nullable — Name of the script configuration file (without .yml extension)
  - `headless` boolean — Run in headless mode (no UI)

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2025-12-20** `1005bcd47280` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hummingbot/apis/hummingbot-api/changes/bot-orchestration/deploy-v2-script/post.md)

---

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