DeleteAndSwapGroup
Deletes a group and transfers its restrictions to another group.
Procedure-Specific Information
Cloud
To delete a group, you must specify one of the following identifiers:
- GroupId
- GroupName
To transfer (swap) restrictions from the deleted group to another group, you may optionally specify one of the following:
- SwapGroupId
- SwapGroupName
If no swap parameter is provided, the group is deleted without transferring its restrictions.
In the example below, a group is deleted by Id, and its restrictions moved to another group by specifying the swap group Id.
EXEC DeleteAndSwapGroup @GroupId = '3dd7e7a1-77f7-4ac1-b8e1-a069830a7f1d', @SwapGroupId = '3dd7e7a1-77f7-4ac1-b8e1-a069830a7f2z';
Server
To delete a group, you must specify the GroupName input.
To transfer (swap) restrictions from the deleted group to another group, you may optionally specify the SwapGroupName. If no swap parameter is provided, the group is deleted without transferring its restrictions.
In the example below, a group is deleted by Name, and its restrictions moved to another group by specifying the swap group Name.
EXEC DeleteAndSwapGroup @GroupName = 'old-support-group', @SwapGroupName = 'new-support-group';
Note: On Jira Server/Data Center, groups are identified by name only. Group ID–based parameters are not supported.
Input
| Name | Type | Required | Description |
| GroupId | String | True | The Id of the Group to delete. Required if GroupName is not specified. Available only in Jira Cloud. |
| GroupName | String | True | The name of the Group to delete. Required if GroupId is not specified. |
| SwapGroupId | String | False | The Id of the Group to transfer the restrictions to. Available only in Jira Cloud. |
| SwapGroupName | String | False | The Name of the Group to transfer the restrictions to. |
Result Set Columns
| Name | Type | Description |
| Success | String | This value shows whether the operation was successful or not. |
| Error | String | The error message if the procedure failed. |