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

# Accept Join

`POST /cluster/accept-join`

Accept a join request from a cluster node

## Request body

- InternalHandlersClusterAcceptJoinRequest
  - `inventory` GithubComAlchemillahqSylveInternalServicesClusterGuestIdentityInventoryReport
    - `conflicts` GithubComAlchemillahqSylveInternalServicesClusterGuestIdentityInventoryConflict[]
      - `entries` GithubComAlchemillahqSylveInternalServicesClusterGuestIdentityInventoryEntry[]
        - `guestId` integer
        - `guestType` string
        - `name` string
        - `nodeId` string
        - `recordId` integer
      - `guestId` integer
      - `reason` string
    - `digest` string
    - `entries` GithubComAlchemillahqSylveInternalServicesClusterGuestIdentityInventoryEntry[]
      - `guestId` integer
      - `guestType` string
      - `name` string
      - `nodeId` string
      - `recordId` integer
  - `nodeId` string, required
  - `nodeIp` string, required
  - `nodeVersion` string, required
  - `preflight` boolean

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `409` — Conflict
- `413` — Request Entity Too Large
- `500` — Internal Server Error
- `503` — Service Unavailable

## Changes

- **2026-08-28** `afb6dfed3935` — 1 breaking
  - removed the success response with the status `200`
- **2026-08-12** `9a5026bf9057` — 7 info
  - the endpoint scheme security `ClusterKeyAuth` was added to the API
  - the endpoint scheme security `BearerAuth` was removed from the API
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - …3 more
- **2025-09-19** `dc875965a5da` — 1 info
  - endpoint added
- **2025-03-11** `2b736ca1b025` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/alchemillahq/apis/sylve-api/changes/cluster/accept-join/post.md)

---

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