---
title: "Accept invitation by key"
method: POST
path: "/invitations/{invitationKey}"
tags: ["invitations"]
---

# Accept invitation by key

`POST /invitations/{invitationKey}`

Allows user to accept an invitation to join the organization using invitationKey. The user will automatically leave their current organization.

## Path parameters

- `invitationKey` string, required

## Response `200`

Successfully accepted the invitation.

## Other responses

- `400` — - [group:**invitation**, code:**3**]: Invalid invitationKey. - [group:**request**, code:**0**]: Invalid field in the request.
- `403` — - [group:**invitation**, code:**1**]: The user has no permission to access the invitation resources. - [group:**invitation**, code:**2**]: The invitation has been revoked.
- `404` — - [group:**organization**, code:**2**]: Organization does not exist.
- `409` — - [group:**organization**, code:**0**]: User already owns an organization.
- `500` — - [group:**invitation**, code:**201**]: Get invitation encountered error. - [group:**organization**, code:**1201**]: Get organization encountered DB error. - [group:**organization**, code:**1400**]: Update organization grouping policy encountered error. - [group:**session**, code:**3**]: Failed to save session to cache. - [group:**user**, code:**1200**]: Get user encountered DB error.

---

[API](https://skmtc.net/gmicloud/apis/cluster-engine-api.md) · [All operations](https://skmtc.net/gmicloud/apis/cluster-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gmicloud/cluster-engine-api/revisions/bcbab016469f/schema)