---
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

## Response `200`

Success

- GithubComAlchemillahqSylveInternalAPIResponseGithubComAlchemillahqSylveInternalServicesClusterGuestIdentityInventoryReport
  - `data` 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
  - `error` string
  - `message` string
  - `status` string

## Other responses

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

---

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