POST

Create bulk user lookup using ids

Returns user details for the ids provided in the request body.

Permissions required: Permission to access the Confluence site ('Can use' global permission). The user must be able to view user profiles in the Confluence site.

Data Security Policy: Exempt from app access rules
Scopes
read:user:confluence

Connect app scope requiredREAD

Request

Request bodyapplication/json

accountIds

array<string>

Required

Responses

Returned if the user info is returned for the account IDs. results may be empty if no account IDs were found.

Headers

Link

string

application/json

MultiEntityResult<User>
POST/users-bulk
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "accountIds": [ "<string>" ] }`; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/users-bulk`, { method: 'POST', headers: { 'Accept': 'application/json', 'Content-Type': 'application/json' }, body: bodyData }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.json());
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 { "results": [ { "displayName": "<string>", "timeZone": "<string>", "personalSpaceId": "<string>", "isExternalCollaborator": true, "accountStatus": "active", "accountId": "<string>", "email": "<string>", "accountType": "atlassian", "publicName": "<string>", "profilePicture": { "path": "<string>", "isDefault": true } } ], "_links": { "next": "<string>", "base": "<string>" } }
POST

Check site access for a list of emailsExperimental

Returns the list of emails from the input list that do not have access to site.

Permissions required: Permission to access the Confluence site ('Can use' global permission).

Data Security Policy: Exempt from app access rules
Scopes
read:configuration:confluence

Connect app scope requiredNONE

Request

Request bodyapplication/json

emails

array<string>

Required

Responses

Returns object with list of emails without access to site.

application/json

object
POST/user/access/check-access-by-email
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "emails": [ "<string>" ] }`; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/user/access/check-access-by-email`, { method: 'POST', headers: { 'Accept': 'application/json', 'Content-Type': 'application/json' }, body: bodyData }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.json());
200Response
1 2 3 4 5 6 7 8 { "emailsWithoutAccess": [ "<string>" ], "invalidEmails": [ "<string>" ] }
POST

Invite a list of emails to the siteExperimental

Invite a list of emails to the site.

Ignores all invalid emails and no action is taken for the emails that already have access to the site.

NOTE: This API is asynchronous and may take some time to complete.

Permissions required: Permission to access the Confluence site ('Can use' global permission).

Data Security Policy: Exempt from app access rules
Scopes
read:configuration:confluence

Connect app scope requiredNONE

Request

Request bodyapplication/json

emails

array<string>

Required

Responses

Returns object with list of emails without access to site.

POST/user/access/invite-by-email
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "emails": [ "<string>" ] }`; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/user/access/invite-by-email`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: bodyData }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.text());

Rate this page: