Invitations

Creating an invitation

Specify an email address and permission and invite a user to the organization.

POST /api/v0/invitations

Required permissions for API key

  • Read
  • Write

Input

KEY TYPE DESCRIPTION
email string the email address to send the invitation
authority string the default permission when joining from an invitation (manager,collaborator,viewer)

Example input

{
  "email": "example@example.com",
  "authority": "viewer"
}

Response

Success

The expiresAt field (in epoch seconds) is given and returned with the input. Invitations can not be used after the moment of expiresAt.

{
  "email": "example@example.com",
  "authority": "viewer",
  "expiresAt": 1492393387
}

Error

STATUS CODE DESCRIPTION
400 when JSON format is incorrect, when an email address that has already been invited or an organization member’s email address is specified
403 doesn't have the required permissions