Class Users

Index

Constructors

Properties

Methods

bulkGetUsers bulkGetUsersMigration createUser getAllUsers getAllUsersDefault getUser getUserDefaultColumns getUserEmail getUserEmailBulk getUserGroups removeUser resetUserColumns setUserColumns

Constructors

constructor

new Users(client): Version2.Users
Parameters
- client: Client
Returns Version2.Users
- Defined in src/version2/users.ts:9

Properties

`Private` client

client: Client

Methods

bulkGetUsers

bulkGetUsers<T>(parameters, callback): Promise<void>
Returns a paginated list of the users specified by one or more account IDs.

Permissions required: Permission to access Jira.
Type Parameters
- T = Version2.Version2Models.PageUser
Parameters
- parameters: Version2.Version2Parameters.BulkGetUsers
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/users.ts:122
bulkGetUsers<T>(parameters, callback?): Promise<T>
Returns a paginated list of the users specified by one or more account IDs.

Permissions required: Permission to access Jira.
Type Parameters
- T = Version2.Version2Models.PageUser
Parameters
- parameters: Version2.Version2Parameters.BulkGetUsers
- Optional callback: undefined
Returns Promise<T>
- Defined in src/version2/users.ts:130

bulkGetUsersMigration

bulkGetUsersMigration<T>(parameters, callback): Promise<void>
Returns the account IDs for the users specified in the key or username parameters. Note that multiple key or username parameters can be specified.

Permissions required: Permission to access Jira.
Type Parameters
- T = Version2.Version2Models.UserMigration[]
Parameters
- parameters: Version2.Version2Parameters.BulkGetUsersMigration
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/users.ts:155
bulkGetUsersMigration<T>(parameters, callback?): Promise<T>
Returns the account IDs for the users specified in the key or username parameters. Note that multiple key or username parameters can be specified.

Permissions required: Permission to access Jira.
Type Parameters
- T = Version2.Version2Models.UserMigration[]
Parameters
- parameters: Version2.Version2Parameters.BulkGetUsersMigration
- Optional callback: undefined
Returns Promise<T>
- Defined in src/version2/users.ts:166

createUser

createUser<T>(parameters, callback): Promise<void>
Creates a user. This resource is retained for legacy compatibility. As soon as a more suitable alternative is available this resource will be deprecated.

If the user exists and has access to Jira, the operation returns a 201 status. If the user exists but does not have access to Jira, the operation returns a 400 status.

Permissions required: Administer Jira global permission.
Type Parameters
- T = Version2.Version2Models.User
Parameters
- parameters: Version2.Version2Parameters.CreateUser
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/users.ts:56
createUser<T>(parameters, callback?): Promise<T>
Creates a user. This resource is retained for legacy compatibility. As soon as a more suitable alternative is available this resource will be deprecated.

If the user exists and has access to Jira, the operation returns a 201 status. If the user exists but does not have access to Jira, the operation returns a 400 status.

Permissions required: Administer Jira global permission.
Type Parameters
- T = Version2.Version2Models.User
Parameters
- parameters: Version2.Version2Parameters.CreateUser
- Optional callback: undefined
Returns Promise<T>
- Defined in src/version2/users.ts:67

getAllUsers

getAllUsers<T>(parameters, callback): Promise<void>
Returns a list of all users, including active users, inactive users and previously deleted users that have an Atlassian account.

Privacy controls are applied to the response based on the users' preferences. This could mean, for example, that the user's email address is hidden. See the Profile visibility overview for more details.

Permissions required: Browse users and groups global permission.
Type Parameters
- T = Version2.Version2Models.User[]
Parameters
- parameters: undefined | Version2.Version2Parameters.GetAllUsers
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/users.ts:467
getAllUsers<T>(parameters?, callback?): Promise<T>
Returns a list of all users, including active users, inactive users and previously deleted users that have an Atlassian account.

Privacy controls are applied to the response based on the users' preferences. This could mean, for example, that the user's email address is hidden. See the Profile visibility overview for more details.

Permissions required: Browse users and groups global permission.
Type Parameters
- T = Version2.Version2Models.User[]
Parameters
- Optional parameters: Version2.Version2Parameters.GetAllUsers
- Optional callback: undefined
Returns Promise<T>
- Defined in src/version2/users.ts:482

getAllUsersDefault

getAllUsersDefault<T>(parameters, callback): Promise<void>
Returns a list of all users, including active users, inactive users and previously deleted users that have an Atlassian account.

Privacy controls are applied to the response based on the users' preferences. This could mean, for example, that the user's email address is hidden. See the Profile visibility overview for more details.

Permissions required: Browse users and groups global permission.
Type Parameters
- T = Version2.Version2Models.User[]
Parameters
- parameters: undefined | Version2.Version2Parameters.GetAllUsersDefault
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/users.ts:424
getAllUsersDefault<T>(parameters?, callback?): Promise<T>
Returns a list of all users, including active users, inactive users and previously deleted users that have an Atlassian account.

Privacy controls are applied to the response based on the users' preferences. This could mean, for example, that the user's email address is hidden. See the Profile visibility overview for more details.

Permissions required: Browse users and groups global permission.
Type Parameters
- T = Version2.Version2Models.User[]
Parameters
- Optional parameters: Version2.Version2Parameters.GetAllUsersDefault
- Optional callback: undefined
Returns Promise<T>
- Defined in src/version2/users.ts:439

getUser

getUser<T>(parameters, callback): Promise<void>
Returns a user.

Privacy controls are applied to the response based on the user's preferences. This could mean, for example, that the user's email address is hidden. See the Profile visibility overview for more details.

Permissions required: Browse users and groups global permission.
Type Parameters
- T = Version2.Version2Models.User
Parameters
- parameters: undefined | Version2.Version2Parameters.GetUser
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/users.ts:21
getUser<T>(parameters?, callback?): Promise<T>
Returns a user.

Privacy controls are applied to the response based on the user's preferences. This could mean, for example, that the user's email address is hidden. See the Profile visibility overview for more details.

Permissions required: Browse users and groups global permission.
Type Parameters
- T = Version2.Version2Models.User
Parameters
- Optional parameters: Version2.Version2Parameters.GetUser
- Optional callback: undefined
Returns Promise<T>
- Defined in src/version2/users.ts:32

getUserDefaultColumns

getUserDefaultColumns<T>(parameters, callback): Promise<void>
Returns the default issue table columns for the user. If accountId is not passed in the request, the calling user's details are returned.

Permissions required:
- Administer Jira global permission, to get the column details for any user.
- Permission to access Jira, to get the calling user's column details.
Type Parameters
- T = Version2.Version2Models.ColumnItem[]
Parameters
- parameters: undefined | Version2.Version2Parameters.GetUserDefaultColumns
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/users.ts:198
getUserDefaultColumns<T>(parameters?, callback?): Promise<T>
Returns the default issue table columns for the user. If accountId is not passed in the request, the calling user's details are returned.

Permissions required:
- Administer Jira global permission, to get the column details for any user.
- Permission to access Jira, to get the calling user's column details.
Type Parameters
- T = Version2.Version2Models.ColumnItem[]
Parameters
- Optional parameters: Version2.Version2Parameters.GetUserDefaultColumns
- Optional callback: undefined
Returns Promise<T>
- Defined in src/version2/users.ts:212

getUserEmail

getUserEmail<T>(parameters, callback): Promise<void>
Returns a user's email address. This API is only available to apps approved by Atlassian, according to these guidelines.
Type Parameters
- T = Version2.Version2Models.UnrestrictedUserEmail
Parameters
- parameters: string | Version2.Version2Parameters.GetUserEmail
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/users.ts:317
getUserEmail<T>(parameters, callback?): Promise<T>
Returns a user's email address. This API is only available to apps approved by Atlassian, according to these guidelines.
Type Parameters
- T = Version2.Version2Models.UnrestrictedUserEmail
Parameters
- parameters: string | Version2.Version2Parameters.GetUserEmail
- Optional callback: undefined
Returns Promise<T>
- Defined in src/version2/users.ts:325

getUserEmailBulk

getUserEmailBulk<T>(parameters, callback): Promise<void>
Returns a user's email address. This API is only available to apps approved by Atlassian, according to these guidelines.
Type Parameters
- T = Version2.Version2Models.UnrestrictedUserEmail
Parameters
- parameters: string | Version2.Version2Parameters.GetUserEmailBulk
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/users.ts:350
getUserEmailBulk<T>(parameters, callback?): Promise<T>
Returns a user's email address. This API is only available to apps approved by Atlassian, according to these guidelines.
Type Parameters
- T = Version2.Version2Models.UnrestrictedUserEmail
Parameters
- parameters: string | Version2.Version2Parameters.GetUserEmailBulk
- Optional callback: undefined
Returns Promise<T>
- Defined in src/version2/users.ts:358

getUserGroups

getUserGroups<T>(parameters, callback): Promise<void>
Returns the groups to which a user belongs.

Permissions required: Browse users and groups global permission.
Type Parameters
- T = Version2.Version2Models.GroupName[]
Parameters
- parameters: Version2.Version2Parameters.GetUserGroups
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/users.ts:385
getUserGroups<T>(parameters, callback?): Promise<T>
Returns the groups to which a user belongs.

Permissions required: Browse users and groups global permission.
Type Parameters
- T = Version2.Version2Models.GroupName[]
Parameters
- parameters: Version2.Version2Parameters.GetUserGroups
- Optional callback: undefined
Returns Promise<T>
- Defined in src/version2/users.ts:395

removeUser

removeUser<T>(parameters, callback): Promise<void>
Deletes a user. If the operation completes successfully then the user is removed from Jira's user base. This operation does not delete the user's Atlassian account.

Permissions required: Site administration (that is, membership of the site-admin group).
Type Parameters
- T = void
Parameters
- parameters: Version2.Version2Parameters.RemoveUser
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/users.ts:92
removeUser<T>(parameters, callback?): Promise<T>
Deletes a user. If the operation completes successfully then the user is removed from Jira's user base. This operation does not delete the user's Atlassian account.

Permissions required: Site administration (that is, membership of the site-admin group).
Type Parameters
- T = void
Parameters
- parameters: Version2.Version2Parameters.RemoveUser
- Optional callback: undefined
Returns Promise<T>
- Defined in src/version2/users.ts:100

resetUserColumns

resetUserColumns<T>(parameters, callback): Promise<void>
Resets the default issue table columns for the user to the system default. If accountId is not passed, the calling user's default columns are reset.

Permissions required:
- Administer Jira global permission, to set the columns on any user.
- Permission to access Jira, to set the calling user's columns.
Type Parameters
- T = void
Parameters
- parameters: Version2.Version2Parameters.ResetUserColumns
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/users.ts:289
resetUserColumns<T>(parameters, callback?): Promise<T>
Resets the default issue table columns for the user to the system default. If accountId is not passed, the calling user's default columns are reset.

Permissions required:
- Administer Jira global permission, to set the columns on any user.
- Permission to access Jira, to set the calling user's columns.
Type Parameters
- T = void
Parameters
- parameters: Version2.Version2Parameters.ResetUserColumns
- Optional callback: undefined
Returns Promise<T>
- Defined in src/version2/users.ts:299

setUserColumns

setUserColumns<T>(parameters, callback): Promise<void>
Sets the default issue table columns for the user. If an account ID is not passed, the calling user's default columns are set. If no column details are sent, then all default columns are removed.

The parameters for this resource are expressed as HTML form data. For example, in curl:

curl -X PUT -d columns=summary -d columns=description https://your-domain.atlassian.net/rest/api/2/user/columns?accountId=5b10ac8d82e05b22cc7d4ef5'

Permissions required:
- Administer Jira global permission, to set the columns on any user.
- Permission to access Jira, to set the calling user's columns.
Type Parameters
- T = string
Parameters
- parameters: undefined | Version2.Version2Parameters.SetUserColumns
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/users.ts:247
setUserColumns<T>(parameters?, callback?): Promise<T>
Sets the default issue table columns for the user. If an account ID is not passed, the calling user's default columns are set. If no column details are sent, then all default columns are removed.

The parameters for this resource are expressed as HTML form data. For example, in curl:

curl -X PUT -d columns=summary -d columns=description https://your-domain.atlassian.net/rest/api/2/user/columns?accountId=5b10ac8d82e05b22cc7d4ef5'

Permissions required:
- Administer Jira global permission, to set the columns on any user.
- Permission to access Jira, to set the calling user's columns.
Type Parameters
- T = string
Parameters
- Optional parameters: Version2.Version2Parameters.SetUserColumns
- Optional callback: undefined
Returns Promise<T>
- Defined in src/version2/users.ts:266

Class Users

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns Version2.Users

Properties

Private client

Methods

bulkGetUsers

Type Parameters

Parameters

Returns Promise<void>

Type Parameters

Parameters

Returns Promise<T>

bulkGetUsersMigration

Type Parameters

Parameters

Returns Promise<void>

Type Parameters

Parameters

Returns Promise<T>

createUser

Type Parameters

Parameters

Returns Promise<void>

Type Parameters

Parameters

Returns Promise<T>

getAllUsers

Type Parameters

Parameters

Returns Promise<void>

Type Parameters

Parameters

Returns Promise<T>

getAllUsersDefault

Type Parameters

Parameters

Returns Promise<void>

Type Parameters

Parameters

Returns Promise<T>

getUser

Type Parameters

Parameters

Returns Promise<void>

Type Parameters

Parameters

Returns Promise<T>

getUserDefaultColumns

Type Parameters

Parameters

Returns Promise<void>

Type Parameters

Parameters

Returns Promise<T>

getUserEmail

Type Parameters

Parameters

Returns Promise<void>

Type Parameters

Parameters

Returns Promise<T>

getUserEmailBulk

Type Parameters

Parameters

Returns Promise<void>

Type Parameters

Parameters

Returns Promise<T>

getUserGroups

Type Parameters

Parameters

Returns Promise<void>

Type Parameters

`Private` client