# Reject an invitation

Rejects a received invitation to join an entity. This declines the invitation and updates its status to rejected. The invitation must be in pending status to be rejected.

Endpoint: POST /api/v1/users/invite/reject
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