Sign in

v13

OpenAPI 3.0.32026-07-31359869.4 MB
teams

Invite a user

Invite a user to join the team specified in the URL. The authenticated user needs to be an OWNER in order to successfully invoke this endpoint. The user to be invited must be specified by email.

post/v2/teams/{teamId}/members

Path parameters

teamIdstring required
Example:team_1a2b3c4d5e6f7g8h9i0j1k2l

The Team identifier to perform the request on behalf of.

Query parameters

slugstring
Example:my-team-url-slug

The Team slug to perform the request on behalf of.

Request body

emailstring email required

The email address of the user to invite

role'OWNER' | 'MEMBER' | 'DEVELOPER' | 'SECURITY' | 'BILLING' | 'VIEWER' | 'VIEWER_FOR_PLUS' | 'CONTRIBUTOR'

The role of the user to invite

Example request

[
  {
    "email": "john@example.com",
    "role": "VIEWER",
    "projects": [
      {
        "projectId": "prj_ndlgr43fadlPyCtREAqxxdyFK",
        "role": "ADMIN"
      }
    ]
  }
]

Response

uidstring required

The ID of the invited user

usernamestring required

The username of the invited user

emailstring required

The email of the invited user.

role'BILLING' | 'CONTRIBUTOR' | 'DEVELOPER' | 'MEMBER' | 'OWNER' | 'SECURITY' | 'VIEWER' | 'VIEWER_FOR_PLUS' required

The role used for the invitation

teamRolesstring[]

The team roles of the user

teamPermissionsstring[]

The team permissions of the user

Example response

{
  "uid": "kr1PsOIzqEL5Xg6M4VZcZosf",
  "username": "john-doe",
  "email": "john@user.co",
  "role": "MEMBER",
  "teamRoles": [
    "MEMBER"
  ],
  "teamPermissions": [
    "CreateProject"
  ]
}