---
title: "Creates cuttlefish instances"
method: POST
path: "/cvds"
---

# Creates cuttlefish instances

`POST /cvds`

Creates cuttlefish instances

## Headers

- `X-Cutf-Host-Orchestrator-BuildAPI-Creds` string

## Request body

- V1CreateCVDRequest
  - `env_config` object — Environment canonical configuration. Structure: https://android.googlesource.com/device/google/cuttlefish/+/8bbd3b9cd815f756f332791d45c4f492b663e493/host/commands/cvd/parser/README.md Example: https://cs.android.com/android/platform/superproject/main/+/main:device/google/cuttlefish/host/cvd_test_configs/main_phone-main_watch.json;drc=b2e8f4f014abb7f9cb56c0ae199334aacb04542d NOTE: Using this as a black box for now as its content is unstable. Use the test configs pointed above as reference to build your config object.

## Response `200`

OK

- V1CreateCVDResponse
  - `cvds` V1CVD[]
    - `adb_port` integer — [Output Only]
    - `adb_serial` string — [Output Only]
    - `displays` string[] — [Output Only]
    - `group` string — [Output Only] The group name the instance belongs to.
    - `name` string — [Output Only] Identifier within a group.
    - `status` string — [Output Only]
    - `webrtc_device_id` string — [Output Only]

---

[API](https://skmtc.dev/google/apis/cuttlefish-host-orchestrator-api.md) · [All operations](https://skmtc.dev/google/apis/cuttlefish-host-orchestrator-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/cuttlefish-host-orchestrator-api/revisions/72163858ba8a/schema)