# Accept an invitation

Accepts a received invitation to join an entity. This confirms the invitee's willingness to join the entity (such as a group). The invitation must be in pending status to be accepted.

Endpoint: POST /api/v1/users/invite/accept
Version: 1.0
Security: header

## Query parameters:

  - `entity` (string, required)
    The username and domain of the entity

  - `inviter` (string, required)
    The username and domain of the inviter

  - `scheme` (string)
    http vs. https.  For testing ONLY
    Enum: "http", "https"

## Response 400 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 404 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation