---
title: "👤 Accept the account membership invitation and finish registration. The user must be already authorized in Auth0."
method: PUT
path: "/invite/accept"
tags: ["registration", "default"]
---

# 👤 Accept the account membership invitation and finish registration. The user must be already authorized in Auth0.

`PUT /invite/accept`

## Request

- Base URL: `{{ server_url }}/v1`
- URL: `{{ server_url }}/v1/invite/accept`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/athenian/apis/title/docs/invite/accept/put.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- AcceptedInvitation: Request for entering the product.
  - `email` string, email: Calling user's email address.
  - `name` string: Calling user's name.
  - `url` string, url, required: Invitation URL. Users are supposed to click it and become admins or regular account members.

## Response `200`

Details about the new user.

- InvitedUser: Details about the user who has accepted an invitation.
  - `account` integer, required: Joined account ID.
  - `user` User, required: User details. "updated" and "accounts" are populated only for the calling user.
    - `accounts` object: Mapping from user's account ID the membership status.
    - `email` string: Email of the user.
    - `id` string, required: Auth0 user identifier.
    - `impersonated_by` string: Identifier of the super admin user who is acting on behalf of.
    - `login` string, required: Auth backend user login name.
    - `native_id` string, required: Auth backend user identifier.
    - `name` string: Full name of the user.
    - `picture` string: Avatar URL of the user.
    - `updated` string, date-time: Date and time of the last profile update.

## Other responses

- `400`: Something is wrong with the invitation URL.
- `403`: Invitation is disabled or user is not a member of the GitHub organization.
- `404`: Invitation was not found.
- `409`: Concurrent requests.
- `422`: Account's installation has not finished yet.

## Changes

- **2023-04-19** `59416fd802d2`: 1 info
  - added the required property `user/accounts/additionalProperties/stale` to the response with the `200` status

[Operation history](https://skmtc.dev/athenian/apis/title/changes/invite/accept/put.md)

---

[API](https://skmtc.dev/athenian/apis/title.md) - [All operations](https://skmtc.dev/athenian/apis/title/llms.txt) - [OpenAPI document](https://skmtc.dev/athenian/apis/title/revisions/110c9f7cffdd?raw)