Organization API - Invitation

Respond to an invitation

Changed on

Choose to accept or decline an invitation.

patch/v3/invitations/token/{token}

Request

Path parameters

tokenstring required

Invitation token.

Request body

status'accepted' | 'declined'

Response

Successfully responded to the invitation.

identifierstring

Uniquely identify an invitation.

emailstring

The email which the invitation is sent to.

role'admin' | 'member'
status'pending' | 'accepted' | 'declined'
expiryDatestring date

The date after which the invitation expires. Default is 10 days from now.

createdDtstring date-time

Example response

{
  "identifier": "mEFayXdO",
  "organization": {
    "identifier": "mEFayXdO",
    "name": "Grove Street King",
    "userRole": "admin"
  },
  "email": "carljohnson@grove.street",
  "role": "admin",
  "invitedBy": {
    "id": 1,
    "name": "Carl Johnson",
    "username": "carljohnson",
    "email": "carljohnson@grove.street",
    "avatar": "https://affinda-api.s3.amazonaws.com/media/user-avatar.png?AWSAccessKeyId=KEY&Signature=SIG"
  },
  "respondedBy": {
    "id": 1,
    "name": "Carl Johnson",
    "username": "carljohnson",
    "email": "carljohnson@grove.street",
    "avatar": "https://affinda-api.s3.amazonaws.com/media/user-avatar.png?AWSAccessKeyId=KEY&Signature=SIG"
  }
}

Changes

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      added the required property / to the response with the status