---
title: "Join cluster"
method: POST
path: "/v1/cluster/join"
tags: ["Cluster"]
---

# Join cluster

`POST /v1/cluster/join`

Joins this host to an existing cluster.

## Request body

- ClusterJoinToken
  - `server_urls` string[], required — Existing server to join
  - `token` string, required — Token to join an existing cluster.

## Response `204`

No Content response.

## Other responses

- `400` — Bad Request response.
- `401` — Unauthorized response.
- `409` — Conflict response.
- `500` — Internal Server Error response.
- `default` — Unexpected error response

---

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