---
title: "add instance"
method: POST
path: "/cluster/{clusterKey}/instances"
tags: ["Cluster"]
---

# add instance

`POST /cluster/{clusterKey}/instances`

Add a new instance to a cluster

## Path parameters

- `clusterKey` string, required

## Request body

- Instance
  - `host` string
  - `port` integer
  - `metadata` Metadatum[]
    - `key` string
    - `value` string

## Response `200`

the newly created instance

- InstanceResult
  - `result` Instance
    - `host` string
    - `port` integer
    - `metadata` Metadatum[]
      - `key` string
      - `value` string

## Other responses

- `default` — Unexpected error

---

[API](https://skmtc.net/turbinelabs/apis/turbine-labs-api.md) · [All operations](https://skmtc.net/turbinelabs/apis/turbine-labs-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/turbinelabs/turbine-labs-api/versions/47fce18aa12f/schema)