[POST] Invite Users

Use this request to invite one or more users to the current tenant and workspace by assigning them a role.

Invite Users

POST/api/v1.0/external/sdworkspace/inviteusers

Body application/json `InviteUsersRequest`

Name

Type

Description

users

array of ExternalUserModel

List of users to be invited to the current tenant. Each entry must contain a valid email and role name. Duplicate emails are not allowed.

workspaceId

integer

The ID of the workspace.

Body application/json `ExternalUserModel`

Name

Type

Description

email

string

The user's email address. Must be unique and properly formatted.

roleName

string

The name of the role to assign. Must match one of the available roles from the /availableroles endpoint.

Example Request

curl -X 'POST' \
'https://cloud.smartdocumentor.net/api/v1.0/external/sdworkspace/inviteusers' \
  --header 'Authorization: Bearer {your access token here}' \
  --header 'accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "workspaceId": 1,
  "users": [
    {
      "email": "[email protected]",
      "roleName": "Administrator"
    }
  ]
}'

var client = new HttpClient();

var request = new HttpRequestMessage(HttpMethod.Post, "https://cloud.smartdocumentor.net/api/v1.0/external/sdworkspace/inviteusers");
request.Headers.Add("Authorization", "Bearer {your access token here}");
request.Headers.Add("Accept", "application/json");

var content = new StringContent("{\r\n  \"workspaceId\": 1,\r\n  \"users\": [\r\n    {\r\n      \"email\": \"[email protected]\",\r\n      \"roleName\": \"Administrator\"\r\n    }\r\n  ]\r\n}", null, "application/json");
request.Content = content;

var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();

Console.WriteLine(await response.Content.ReadAsStringAsync());

import requests
import json

url = "https://cloud.smartdocumentor.net/api/v1.0/external/sdworkspace/inviteusers"

payload = json.dumps({
  "workspaceId": 1,
  "users": [
    {
      "email": "[email protected]",
      "roleName": "Administrator"
    }
  ]
})
headers = {
  'Authorization': 'Bearer {your access token here}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

var myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer {your access token here}");
myHeaders.append("Content-Type", "application/json");
myHeaders.append("Accept", "application/json");

var raw = JSON.stringify({
  "workspaceId": 1,
  "users": [
    {
      "email": "[email protected]",
      "roleName": "Some Name"
    }
  ]
});

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw
};

fetch("https://cloud.smartdocumentor.net/api/v1.0/external/sdworkspace/inviteusers", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

Responses

Response Body `Empty`

Indicates that the operation was successful and a invitation email will be sent to the invited user(s).

{
  "title": "Internal Server Error",
  "status": 500,
  "detail": "A server error occurred while processing your request. Please try again later. Trace ID:"
}

Response Body Problem Detail JSON Object

Previous[GET] List All Workspace Users NextFolder Worker

Last updated 6 months ago

Invite Users

Body application/json InviteUsersRequest

Body application/json ExternalUserModel

Example Request

Responses

Response Body Empty

Response Body Problem Detail JSON Object

Response Body Problem Detail JSON Object

Body application/json `InviteUsersRequest`

Body application/json `ExternalUserModel`

Response Body `Empty`