# Send invitation to a user for an entity

Invites a local or remote user to join a local or remote entity (such as a group). For remote users or entities, include the domain in the username (e.g., user@domain.com). The invitation must be explicitly accepted or rejected by the invitee.

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

## Query parameters:

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

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

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