Invite users to a workspace.
Invite users to a workspace. All invited users will have the same defined permission.
Path Parameters
- organization_id integer required
ID of the workspace
- application/json
Request Body required
- role string required
Possible values: [
USER
,VIEWER
,ANNOTATOR
,ADMIN
,MANAGER
]User's role
- emails email[] required
List of emails
- 200
- 400
- 401
- 403
- 404
- 500
User invited to the workspace.
- application/json
- Schema
- Example (from schema)
Schema
not_invited object[]
List of users that were not invited
email emailInvited email
reason stringThe reason why invitation failed
invitations object[]
List of invitations sent
id integerThe ID of the invitation
role stringPossible values: [
USER
,VIEWER
,ANNOTATOR
,ADMIN
,MANAGER
]User's role
email emailInvited email
invited_by_id integerID of the user who sent the invitation
organization_id integerID of the organization
created date-timeinvitation date
invitation_link stringThe invitation link. This link contains an invitation token
{
"not_invited": [
{
"email": "user@example.com",
"reason": "User was already invited"
}
],
"invitations": [
{
"id": 5,
"role": "USER",
"email": "user@example.com",
"invited_by_id": 5,
"organization_id": 1,
"created": "2023-11-02",
"invitation_link": "string"
}
]
}
Invalid request body
User is not authenticated. This means token is either not present or invalid
User does not have the minimal required organization role "ADMIN"
No workspace was found that corresponds to the ID sent
Something is wrong with the API.