@itentialopensource/adapter-jira 1.7.5 → 1.7.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CALLS.md CHANGED
@@ -3425,6 +3425,2228 @@ If you want to add or delete a permission grant instead of updating the whole li
3425
3425
 
3426
3426
  See [About permission schemes and grants](#about-permission-schemes) for more details.
3427
3427
 
3428
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
3429
+ <td style="padding:15px">{base_path}/{version}/permissionscheme/{pathv1}?{query}</td>
3430
+ <td style="padding:15px">Yes</td>
3431
+ </tr>
3432
+ <tr>
3433
+ <td style="padding:15px">deleteRestapi2permissionschemeschemeId(schemeId, callback)</td>
3434
+ <td style="padding:15px">Deletes a permission scheme.
3435
+
3436
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
3437
+ <td style="padding:15px">{base_path}/{version}/permissionscheme/{pathv1}?{query}</td>
3438
+ <td style="padding:15px">Yes</td>
3439
+ </tr>
3440
+ <tr>
3441
+ <td style="padding:15px">getRestapi2permissionschemeschemeIdpermission(schemeId, expand, callback)</td>
3442
+ <td style="padding:15px">Returns all permission grants for a permission scheme.
3443
+
3444
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
3445
+ <td style="padding:15px">{base_path}/{version}/permissionscheme/{pathv1}/permission?{query}</td>
3446
+ <td style="padding:15px">Yes</td>
3447
+ </tr>
3448
+ <tr>
3449
+ <td style="padding:15px">postRestapi2permissionschemeschemeIdpermission(schemeId, expand, body, callback)</td>
3450
+ <td style="padding:15px">Creates a permission grant in a permission scheme.
3451
+
3452
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
3453
+ <td style="padding:15px">{base_path}/{version}/permissionscheme/{pathv1}/permission?{query}</td>
3454
+ <td style="padding:15px">Yes</td>
3455
+ </tr>
3456
+ <tr>
3457
+ <td style="padding:15px">getRestapi2permissionschemeschemeIdpermissionpermissionId(schemeId, permissionId, expand, callback)</td>
3458
+ <td style="padding:15px">Returns a permission grant.
3459
+
3460
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
3461
+ <td style="padding:15px">{base_path}/{version}/permissionscheme/{pathv1}/permission/{pathv2}?{query}</td>
3462
+ <td style="padding:15px">Yes</td>
3463
+ </tr>
3464
+ <tr>
3465
+ <td style="padding:15px">deleteRestapi2permissionschemeschemeIdpermissionpermissionId(schemeId, permissionId, callback)</td>
3466
+ <td style="padding:15px">Deletes a permission grant from a permission scheme. See [About permission schemes and grants](#about-permission-schemes) for more details.
3467
+
3468
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
3469
+ <td style="padding:15px">{base_path}/{version}/permissionscheme/{pathv1}/permission/{pathv2}?{query}</td>
3470
+ <td style="padding:15px">Yes</td>
3471
+ </tr>
3472
+ <tr>
3473
+ <td style="padding:15px">getRestapi2projectprojectKeyOrIdnotificationscheme(projectKeyOrId, expand, callback)</td>
3474
+ <td style="padding:15px">Gets a [notification scheme](https://confluence.atlassian.com/x/8YdKLg) associated with the project. See the [Get notification scheme](#api-api-2-notificationscheme-id-get) resource for more information about notification schemes.
3475
+
3476
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg) or *Administer Projects* [project permission](https://confluence.atlassian.com/x/yodKLg).</td>
3477
+ <td style="padding:15px">{base_path}/{version}/project/{pathv1}/notificationscheme?{query}</td>
3478
+ <td style="padding:15px">Yes</td>
3479
+ </tr>
3480
+ <tr>
3481
+ <td style="padding:15px">getRestapi2project(expand, recent, callback)</td>
3482
+ <td style="padding:15px">Returns all projects visible to the user. Deprecated, use [ Get projects paginated](#api-api-2-project-search-get) that supports search and pagination.
3483
+
3484
+ **[Permissions](#permissions) required:** None, however, projects are returned only where:
3485
+
3486
+ * the user has *Browse Projects* or *Administer projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project.
3487
+ * the project is public.</td>
3488
+ <td style="padding:15px">{base_path}/{version}/project?{query}</td>
3489
+ <td style="padding:15px">Yes</td>
3490
+ </tr>
3491
+ <tr>
3492
+ <td style="padding:15px">postRestapi2project(body, callback)</td>
3493
+ <td style="padding:15px">Creates a project based on a project type template, as shown in the following table:
3494
+
3495
+ <table>
3496
+ <thead>
3497
+ <tr>
3498
+ <th>Project Type Key</th>
3499
+ <th>Project Template Key</th>
3500
+ </tr>
3501
+ <tr>
3502
+ <td style="padding:15px">getRestapi2applicationrole(callback)</td>
3503
+ <td style="padding:15px">Returns all application roles. In Jira, application roles are managed using the [Application access configuration](https://confluence.atlassian.com/x/3YxjL) page.
3504
+
3505
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
3506
+ <td style="padding:15px">{base_path}/{version}/applicationrole?{query}</td>
3507
+ <td style="padding:15px">Yes</td>
3508
+ </tr>
3509
+ <tr>
3510
+ <td style="padding:15px">getRestapi2applicationrolekey(key, callback)</td>
3511
+ <td style="padding:15px">Returns an application role.
3512
+
3513
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
3514
+ <td style="padding:15px">{base_path}/{version}/applicationrole/{pathv1}?{query}</td>
3515
+ <td style="padding:15px">Yes</td>
3516
+ </tr>
3517
+ <tr>
3518
+ <td style="padding:15px">getRestapi2auditingrecord(offset, limit, filter, from, to, callback)</td>
3519
+ <td style="padding:15px">Returns a list of audit records. The list can be filtered to include items:
3520
+
3521
+ * containing a string in at least one field. For example, providing *up* will return all audit records where one or more fields contains words such as *update*.
3522
+ * created on or after a date and time.
3523
+ * created or or before a date and time.
3524
+ * created during a time period.
3525
+
3526
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
3527
+ <td style="padding:15px">{base_path}/{version}/auditing/record?{query}</td>
3528
+ <td style="padding:15px">Yes</td>
3529
+ </tr>
3530
+ <tr>
3531
+ <td style="padding:15px">getRestapi2dashboard(filter, startAt, maxResults, callback)</td>
3532
+ <td style="padding:15px">Returns a list of dashboards owned by or shared with the user. The list may be filtered to include only favorite or owned dashboards.
3533
+
3534
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
3535
+ <td style="padding:15px">{base_path}/{version}/dashboard?{query}</td>
3536
+ <td style="padding:15px">Yes</td>
3537
+ </tr>
3538
+ <tr>
3539
+ <td style="padding:15px">getRestapi2dashboardsearch(dashboardName, accountId, owner, groupname, projectId, orderBy, startAt, maxResults, expand, callback)</td>
3540
+ <td style="padding:15px">Searches for dashboards. This operation is similar to [Get dashboards](#api-api-2-dashboard-get) except that the results can be refined to include dashboards that have specific attributes. For example, dashboards with a particular name. When multiple attributes are specified only filters matching all attributes are returned.
3541
+
3542
+ **[Permissions](#permissions) required:** None, however, only the following dashboards that match the query parameters are returned:
3543
+
3544
+ * Dashboards owned by the user. Not returned for anonymous users.
3545
+ * Dashboards shared with a group that the user is a member of. Not returned for anonymous users.
3546
+ * Dashboards shared with a private project that the user can browse. Not returned for anonymous users.
3547
+ * Dashboards shared with a public project.
3548
+ * Dashboards shared with the public.</td>
3549
+ <td style="padding:15px">{base_path}/{version}/dashboard/search?{query}</td>
3550
+ <td style="padding:15px">Yes</td>
3551
+ </tr>
3552
+ <tr>
3553
+ <td style="padding:15px">getRestapi2dashboarddashboardIditemsitemIdproperties(dashboardId, itemId, callback)</td>
3554
+ <td style="padding:15px">Returns the keys of all properties for a dashboard item.
3555
+
3556
+ **[Permissions](#permissions) required:** Permission to access Jira. However, to get the property keys the user must be the owner of the dashboard or be shared the dashboard. Note, users with the *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg) are considered owners of the System dashboard. The System dashboard is considered to be shared with all other users.</td>
3557
+ <td style="padding:15px">{base_path}/{version}/dashboard/{pathv1}/items/{pathv2}/properties?{query}</td>
3558
+ <td style="padding:15px">Yes</td>
3559
+ </tr>
3560
+ <tr>
3561
+ <td style="padding:15px">getRestapi2dashboarddashboardIditemsitemIdpropertiespropertyKey(dashboardId, itemId, propertyKey, callback)</td>
3562
+ <td style="padding:15px">Returns the key and value of a dashboard item property.
3563
+
3564
+ A dashboard item enables an app to add user-specific information to a user dashboard. Dashboard items are exposed to users as gadgets that users can add to their dashboards. For more information on how users do this, see [Adding and customizing gadgets](https://confluence.atlassian.com/x/7AeiLQ).
3565
+
3566
+ When an app creates a dashboard item it registers a callback to receive the dashboard item ID. The callback fires whenever the item is rendered or, where the item is configurable, the user edits the item. The app then uses this resource to store the item's content or configuration details. For more information on working with dashboard items, see [ Building a dashboard item for a JIRA Connect add-on](https://developer.atlassian.com/server/jira/platform/guide-building-a-dashboard-item-for-a-jira-connect-add-on-33746254/) and the [Dashboard Item](https://developer.atlassian.com/cloud/jira/platform/modules/dashboard-item/) documentation.
3567
+
3568
+ There is no resource to set or get dashboard items.
3569
+
3570
+ **[Permissions](#permissions) required:** Permission to access Jira. However, to get a dashboard item property the user must be the owner of the dashboard or be shared the dashboard. Note, users with the *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg) are considered owners of the System dashboard. The System dashboard is considered to be shared with all other users.</td>
3571
+ <td style="padding:15px">{base_path}/{version}/dashboard/{pathv1}/items/{pathv2}/properties/{pathv3}?{query}</td>
3572
+ <td style="padding:15px">Yes</td>
3573
+ </tr>
3574
+ <tr>
3575
+ <td style="padding:15px">putRestapi2dashboarddashboardIditemsitemIdpropertiespropertyKey(dashboardId, itemId, propertyKey, body, callback)</td>
3576
+ <td style="padding:15px">Sets the value of a dashboard item property. Use this resource in apps to store custom data against a dashboard item.
3577
+
3578
+ A dashboard item enables an app to add user-specific information to a user dashboard. Dashboard items are exposed to users as gadgets that users can add to their dashboards. For more information on how users do this, see [Adding and customizing gadgets](https://confluence.atlassian.com/x/7AeiLQ).
3579
+
3580
+ When an app creates a dashboard item it registers a callback to receive the dashboard item ID. The callback fires whenever the item is rendered or, where the item is configurable, the user edits the item. The app then uses this resource to store the item's content or configuration details. For more information on working with dashboard items, see [ Building a dashboard item for a JIRA Connect add-on](https://developer.atlassian.com/server/jira/platform/guide-building-a-dashboard-item-for-a-jira-connect-add-on-33746254/) and the [Dashboard Item](https://developer.atlassian.com/cloud/jira/platform/modules/dashboard-item/) documentation.
3581
+
3582
+ There is no resource to set or get dashboard items.
3583
+
3584
+ The value of the request body must be a [valid](http://tools.ietf.org/html/rfc4627), non-empty JSON blob. The maximum length is 32768 characters.
3585
+
3586
+ **[Permissions](#permissions) required:** Permission to access Jira. However, to set a dashboard item property the user must be the owner of the dashboard. Note, users with the *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg) are considered owners of the System dashboard.</td>
3587
+ <td style="padding:15px">{base_path}/{version}/dashboard/{pathv1}/items/{pathv2}/properties/{pathv3}?{query}</td>
3588
+ <td style="padding:15px">Yes</td>
3589
+ </tr>
3590
+ <tr>
3591
+ <td style="padding:15px">deleteRestapi2dashboarddashboardIditemsitemIdpropertiespropertyKey(dashboardId, itemId, propertyKey, callback)</td>
3592
+ <td style="padding:15px">Deletes a dashboard item property.
3593
+
3594
+ **[Permissions](#permissions) required:** Permission to access Jira. However, to delete a dashboard item property the user must be the owner of the dashboard. Note, users with the *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg) are considered owners of the System dashboard.</td>
3595
+ <td style="padding:15px">{base_path}/{version}/dashboard/{pathv1}/items/{pathv2}/properties/{pathv3}?{query}</td>
3596
+ <td style="padding:15px">Yes</td>
3597
+ </tr>
3598
+ <tr>
3599
+ <td style="padding:15px">getRestapi2dashboardid(id, callback)</td>
3600
+ <td style="padding:15px">Returns a dashboard.
3601
+
3602
+ **[Permissions](#permissions) required:** Permission to access Jira. However, to get a dashboard, the dashboard must be shared with the user or the user must own it. Note, users with the *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg) are considered owners of the System dashboard. The System dashboard is considered to be shared with all other users.</td>
3603
+ <td style="padding:15px">{base_path}/{version}/dashboard/{pathv1}?{query}</td>
3604
+ <td style="padding:15px">Yes</td>
3605
+ </tr>
3606
+ <tr>
3607
+ <td style="padding:15px">getRestapi2filter(expand, callback)</td>
3608
+ <td style="padding:15px">Returns all filters. Deprecated, use [ Search for filters](#api-api-2-filter-search-get) that supports search and pagination.
3609
+
3610
+ **[Permissions](#permissions) required:** Permission to access Jira, however, only the following are returned:
3611
+
3612
+ * filters owned by the user.
3613
+ * filters shared with a group that the user is a member of.
3614
+ * filters shared with a private project that the user has *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for.
3615
+ * filters shared with a public project.
3616
+ * filters shared with the public.</td>
3617
+ <td style="padding:15px">{base_path}/{version}/filter?{query}</td>
3618
+ <td style="padding:15px">Yes</td>
3619
+ </tr>
3620
+ <tr>
3621
+ <td style="padding:15px">postRestapi2filter(expand, body, callback)</td>
3622
+ <td style="padding:15px">Creates a filter. The filter is shared according to the [default share scope](#api-api-2-filter-post). The filter is not selected as a favorite.
3623
+
3624
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
3625
+ <td style="padding:15px">{base_path}/{version}/filter?{query}</td>
3626
+ <td style="padding:15px">Yes</td>
3627
+ </tr>
3628
+ <tr>
3629
+ <td style="padding:15px">getRestapi2filterfavourite(expand, callback)</td>
3630
+ <td style="padding:15px">Returns the visible favorite filters of the user.
3631
+
3632
+ **[Permissions](#permissions) required:** Permission to access Jira, however, a favorite filters is only visible to the user where the filter is:
3633
+
3634
+ * owned by the user.
3635
+ * shared with a group that the user is a member of.
3636
+ * shared with a private project that the user has *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for.
3637
+ * shared with a public project.
3638
+ * shared with the public.
3639
+
3640
+ For example, if the user favorites a public filter that is subsequently made private that filter is not returned by this operation.</td>
3641
+ <td style="padding:15px">{base_path}/{version}/filter/favourite?{query}</td>
3642
+ <td style="padding:15px">Yes</td>
3643
+ </tr>
3644
+ <tr>
3645
+ <td style="padding:15px">getRestapi2filtermy(expand, includeFavourites, callback)</td>
3646
+ <td style="padding:15px">Returns the filters owned by the user. If `includeFavourites` is `true`, the user's visible favorite filters are also returned.
3647
+
3648
+ **[Permissions](#permissions) required:** Permission to access Jira, however, a favorite filters is only visible to the user where the filter is:
3649
+
3650
+ * owned by the user.
3651
+ * shared with a group that the user is a member of.
3652
+ * shared with a private project that the user has *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for.
3653
+ * shared with a public project.
3654
+ * shared with the public.
3655
+
3656
+ For example, if the user favorites a public filter that is subsequently made private that filter is not returned by this operation.</td>
3657
+ <td style="padding:15px">{base_path}/{version}/filter/my?{query}</td>
3658
+ <td style="padding:15px">Yes</td>
3659
+ </tr>
3660
+ <tr>
3661
+ <td style="padding:15px">getRestapi2filtersearch(filterName, accountId, owner, groupname, projectId, orderBy, startAt, maxResults, expand, callback)</td>
3662
+ <td style="padding:15px">Searches for filters. This operation is similar to [Get filters](#api-api-2-filter-get) except that the results can be refined to include filters that have specific attributes. For example, filters with a particular name. When multiple attributes are specified only filters matching all attributes are returned.
3663
+
3664
+ **[Permissions](#permissions) required:** Permission to access Jira, however, only the following filters that match the query parameters are returned:
3665
+
3666
+ * filters owned by the user.
3667
+ * filters shared with a group that the user is a member of.
3668
+ * filters shared with a private project that the user has *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for.
3669
+ * filters shared with a public project.
3670
+ * filters shared with the public.</td>
3671
+ <td style="padding:15px">{base_path}/{version}/filter/search?{query}</td>
3672
+ <td style="padding:15px">Yes</td>
3673
+ </tr>
3674
+ <tr>
3675
+ <td style="padding:15px">getRestapi2filterid(id, expand, callback)</td>
3676
+ <td style="padding:15px">Returns a filter.
3677
+
3678
+ **[Permissions](#permissions) required:** Permission to access Jira, however, only the following are returned:
3679
+
3680
+ * filters owned by the user.
3681
+ * filters shared with a group that the user is a member of.
3682
+ * filters shared with a private project that the user has *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for.
3683
+ * filters shared with a public project.
3684
+ * filters shared with the public.</td>
3685
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}?{query}</td>
3686
+ <td style="padding:15px">Yes</td>
3687
+ </tr>
3688
+ <tr>
3689
+ <td style="padding:15px">putRestapi2filterid(id, expand, body, callback)</td>
3690
+ <td style="padding:15px">Updates a filter. Use this operation to update a filter's name, description, JQL, or sharing.
3691
+
3692
+ **[Permissions](#permissions) required:** Permission to access Jira, however the user must own the filter.</td>
3693
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}?{query}</td>
3694
+ <td style="padding:15px">Yes</td>
3695
+ </tr>
3696
+ <tr>
3697
+ <td style="padding:15px">deleteRestapi2filterid(id, callback)</td>
3698
+ <td style="padding:15px">Delete a filter.
3699
+
3700
+ **[Permissions](#permissions) required:** Permission to access Jira, however filters can only be deleted by the creator of the filter or a user with *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
3701
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}?{query}</td>
3702
+ <td style="padding:15px">Yes</td>
3703
+ </tr>
3704
+ <tr>
3705
+ <td style="padding:15px">getRestapi2filteridcolumns(id, callback)</td>
3706
+ <td style="padding:15px">Returns the columns configured for a filter. The column configuration is used when the filter's results are viewed in *List View* with the *Columns* set to *Filter*.
3707
+
3708
+ **[Permissions](#permissions) required:** Permission to access Jira, however, only the following are returned:
3709
+
3710
+ * filters owned by the user.
3711
+ * filters shared with a group that the user is a member of.
3712
+ * filters shared with a private project that the user has *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for.
3713
+ * filters shared with a public project.
3714
+ * filters shared with the public.</td>
3715
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}/columns?{query}</td>
3716
+ <td style="padding:15px">Yes</td>
3717
+ </tr>
3718
+ <tr>
3719
+ <td style="padding:15px">putRestapi2filteridcolumns(id, body, callback)</td>
3720
+ <td style="padding:15px">Sets the columns for a filter. Only navigable fields can be set as columns. Use [Get fields](#api-api-2-field-get) to get the list fields in Jira. A navigable field has `navigable` set to `true`.
3721
+
3722
+ The parameters for this resource are expressed as HTML form data. For example, in curl:
3723
+
3724
+ `curl -X PUT -d columns=summary -d columns=description https://your-domain.atlassian.net/rest/api/2/filter/10000/columns`
3725
+
3726
+ **[Permissions](#permissions) required:** Permission to access Jira, however, columns are only set for:
3727
+
3728
+ * filters owned by the user.
3729
+ * filters shared with a group that the user is a member of.
3730
+ * filters shared with a private project that the user has *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for.
3731
+ * filters shared with a public project.
3732
+ * filters shared with the public.</td>
3733
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}/columns?{query}</td>
3734
+ <td style="padding:15px">Yes</td>
3735
+ </tr>
3736
+ <tr>
3737
+ <td style="padding:15px">deleteRestapi2filteridcolumns(id, callback)</td>
3738
+ <td style="padding:15px">Reset the user's column configuration for the filter to the default.
3739
+
3740
+ **[Permissions](#permissions) required:** Permission to access Jira, however, columns are only reset for:
3741
+
3742
+ * filters owned by the user.
3743
+ * filters shared with a group that the user is a member of.
3744
+ * filters shared with a private project that the user has *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for.
3745
+ * filters shared with a public project.
3746
+ * filters shared with the public.</td>
3747
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}/columns?{query}</td>
3748
+ <td style="padding:15px">Yes</td>
3749
+ </tr>
3750
+ <tr>
3751
+ <td style="padding:15px">putRestapi2filteridfavourite(id, expand, callback)</td>
3752
+ <td style="padding:15px">Add a filter as a favorite for the user.
3753
+
3754
+ **[Permissions](#permissions) required:** Permission to access Jira, however, the user can only favorite:
3755
+
3756
+ * filters owned by the user.
3757
+ * filters shared with a group that the user is a member of.
3758
+ * filters shared with a private project that the user has *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for.
3759
+ * filters shared with a public project.
3760
+ * filters shared with the public.</td>
3761
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}/favourite?{query}</td>
3762
+ <td style="padding:15px">Yes</td>
3763
+ </tr>
3764
+ <tr>
3765
+ <td style="padding:15px">deleteRestapi2filteridfavourite(id, expand, callback)</td>
3766
+ <td style="padding:15px">Removes a filter as a favorite for the user. Note that this operation only removes filters visible to the user from the user's favorites list. For example, if the user favorites a public filter that is subsequently made private (and is therefore no longer visible on their favorites list) they cannot remove it from their favorites list.
3767
+
3768
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
3769
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}/favourite?{query}</td>
3770
+ <td style="padding:15px">Yes</td>
3771
+ </tr>
3772
+ <tr>
3773
+ <td style="padding:15px">getRestapi2filterdefaultShareScope(callback)</td>
3774
+ <td style="padding:15px">Returns the default sharing settings for new filters and dashboards for a user.
3775
+
3776
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
3777
+ <td style="padding:15px">{base_path}/{version}/filter/defaultShareScope?{query}</td>
3778
+ <td style="padding:15px">Yes</td>
3779
+ </tr>
3780
+ <tr>
3781
+ <td style="padding:15px">putRestapi2filterdefaultShareScope(body, callback)</td>
3782
+ <td style="padding:15px">Sets the default sharing for new filters and dashboards for a user.
3783
+
3784
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
3785
+ <td style="padding:15px">{base_path}/{version}/filter/defaultShareScope?{query}</td>
3786
+ <td style="padding:15px">Yes</td>
3787
+ </tr>
3788
+ <tr>
3789
+ <td style="padding:15px">getRestapi2filteridpermission(id, callback)</td>
3790
+ <td style="padding:15px">Returns the share permissions for a filter. A filter can be shared with groups, projects, all logged-in users, or the public. Sharing with all logged-in users or the public is known as a global share permission.
3791
+
3792
+ **[Permissions](#permissions) required:** Permission to access Jira, however, only the following are returned:
3793
+
3794
+ * filters owned by the user.
3795
+ * filters shared with a group that the user is a member of.
3796
+ * filters shared with a private project that the user has *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for.
3797
+ * filters shared with a public project.
3798
+ * filters shared with the public.</td>
3799
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}/permission?{query}</td>
3800
+ <td style="padding:15px">Yes</td>
3801
+ </tr>
3802
+ <tr>
3803
+ <td style="padding:15px">postRestapi2filteridpermission(id, body, callback)</td>
3804
+ <td style="padding:15px">Add a share permissions to a filter. If you add a global share permission (one for all logged-in users or the public) it will overwrite all share permissions for the filter.
3805
+
3806
+ Be aware that this operation uses different objects for updating share permissions compared to [Update filter](#api-api-2-filter-id-put).
3807
+
3808
+ **[Permissions](#permissions) required:** *Share dashboards and filters* [global permission](https://confluence.atlassian.com/x/x4dKLg) and the user must own the filter.</td>
3809
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}/permission?{query}</td>
3810
+ <td style="padding:15px">Yes</td>
3811
+ </tr>
3812
+ <tr>
3813
+ <td style="padding:15px">getRestapi2filteridpermissionpermissionId(id, permissionId, callback)</td>
3814
+ <td style="padding:15px">Returns a share permission for a filter. A filter can be shared with groups, projects, all logged-in users, or the public. Sharing with all logged-in users or the public is known as a global share permission.
3815
+
3816
+ **[Permissions](#permissions) required:** Permission to access Jira, however, only the following are returned:
3817
+
3818
+ * filters owned by the user.
3819
+ * filters shared with a group that the user is a member of.
3820
+ * filters shared with a private project that the user has *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for.
3821
+ * filters shared with a public project.
3822
+ * filters shared with the public.</td>
3823
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}/permission/{pathv2}?{query}</td>
3824
+ <td style="padding:15px">Yes</td>
3825
+ </tr>
3826
+ <tr>
3827
+ <td style="padding:15px">deleteRestapi2filteridpermissionpermissionId(id, permissionId, callback)</td>
3828
+ <td style="padding:15px">Deletes a share permission from a filter.
3829
+
3830
+ **[Permissions](#permissions) required:** Permission to access Jira and the user must own the filter.</td>
3831
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}/permission/{pathv2}?{query}</td>
3832
+ <td style="padding:15px">Yes</td>
3833
+ </tr>
3834
+ <tr>
3835
+ <td style="padding:15px">getRestapi2settingscolumns(callback)</td>
3836
+ <td style="padding:15px">Returns the default issue navigator columns.
3837
+
3838
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
3839
+ <td style="padding:15px">{base_path}/{version}/settings/columns?{query}</td>
3840
+ <td style="padding:15px">Yes</td>
3841
+ </tr>
3842
+ <tr>
3843
+ <td style="padding:15px">putRestapi2settingscolumns(body, callback)</td>
3844
+ <td style="padding:15px">Sets the default issue navigator columns.
3845
+
3846
+ The `columns` parameter accepts a navigable field value and is expressed as HTML form data. To specify multiple columns, pass multiple `columns` parameters. For example, in curl:
3847
+
3848
+ `curl -X PUT -d columns=summary -d columns=description https://your-domain.atlassian.net/rest/api/2/settings/columns`
3849
+
3850
+ If no column details are sent, then all default columns are removed.
3851
+
3852
+ A navigable field is one that can be used as a column on the issue navigator. Find details of navigable issue columns using [Get fields](#api-api-2-field-get).
3853
+
3854
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
3855
+ <td style="padding:15px">{base_path}/{version}/settings/columns?{query}</td>
3856
+ <td style="padding:15px">Yes</td>
3857
+ </tr>
3858
+ <tr>
3859
+ <td style="padding:15px">getRestapi2notificationscheme(startAt, maxResults, expand, callback)</td>
3860
+ <td style="padding:15px">Returns a [paginated](#pagination) list of [notification schemes](https://confluence.atlassian.com/x/8YdKLg) in order by display name.
3861
+
3862
+ ### About notification schemes ###
3863
+
3864
+ A notification scheme is a list of events and recipients who will receive notifications for those events. The list is contained within the `notificationSchemeEvents` object and contains pairs of `events` and `notifications`:
3865
+
3866
+ * `event` Identifies the type of event. The events can be [Jira system events](https://confluence.atlassian.com/x/8YdKLg#Creatinganotificationscheme-eventsEvents) or [custom events](https://confluence.atlassian.com/x/AIlKLg).
3867
+ * `notifications` Identifies the [recipients](https://confluence.atlassian.com/x/8YdKLg#Creatinganotificationscheme-recipientsRecipients) of notifications for each event. Recipients can be any of the following types:
3868
+
3869
+ * `CurrentAssignee`
3870
+ * `Reporter`
3871
+ * `CurrentUser`
3872
+ * `ProjectLead`
3873
+ * `ComponentLead`
3874
+ * `User` (the `parameter` is the user key)
3875
+ * `Group` (the `parameter` is the group name)
3876
+ * `ProjectRole` (the `parameter` is the project role ID)
3877
+ * `EmailAddress`
3878
+ * `AllWatchers`
3879
+ * `UserCustomField` (the `parameter` is the ID of the custom field)
3880
+ * `GroupCustomField`(the `parameter` is the ID of the custom field)
3881
+
3882
+ *Note that you should allow for events without recipients to appear in responses.*
3883
+
3884
+ **[Permissions](#permissions) required:** Permission to access Jira, however the user must have permission to administer at least one project associated with a notification scheme for it to be returned.</td>
3885
+ <td style="padding:15px">{base_path}/{version}/notificationscheme?{query}</td>
3886
+ <td style="padding:15px">Yes</td>
3887
+ </tr>
3888
+ <tr>
3889
+ <td style="padding:15px">getRestapi2notificationschemeid(id, expand, callback)</td>
3890
+ <td style="padding:15px">Returns a [notification scheme](https://confluence.atlassian.com/x/8YdKLg), including the list of events and the recipients who will receive notifications for those events.
3891
+
3892
+ **[Permissions](#permissions) required:** Permission to access Jira, however the user must have permission to administer at least one project associated with the notification scheme.</td>
3893
+ <td style="padding:15px">{base_path}/{version}/notificationscheme/{pathv1}?{query}</td>
3894
+ <td style="padding:15px">Yes</td>
3895
+ </tr>
3896
+ <tr>
3897
+ <td style="padding:15px">putRestapi2issuepropertiespropertyKey(propertyKey, body, callback)</td>
3898
+ <td style="padding:15px">Sets a property value on multiple issues. The issues to be updated can be specified by a filter.
3899
+
3900
+ The filter identifies issues eligible for update using these criteria:
3901
+
3902
+ * `entityIds` Only issues from this list are eligible.
3903
+ * `currentValue` Only issues with the property set to this value are eligible.
3904
+ * `hasProperty`:
3905
+
3906
+ * If *true*, only issues with the property are eligible.
3907
+ * If *false*, only issues without the property are eligible.
3908
+
3909
+ If more than one criteria is specified, they are joined with the logical *AND*: only issues that satisfy all criteria are eligible.
3910
+
3911
+ If an invalid combination of criteria is provided, an error is returned. For example, specifying a `currentValue` and `hasProperty` as *false* would not match any issues (because without the property the property cannot have a value).
3912
+
3913
+ The filter is optional. Without the filter all the issues visible to the user and where the user has the EDIT\_ISSUES permission for the issue are considered eligible.
3914
+
3915
+ This operation is:
3916
+
3917
+ * transactional, either all eligible issues are updated or, when errors occur, none are updated.
3918
+ * [asynchronous](#async). Follow the `location` link in the response to determine the status of the task and use [Get task](#api-api-2-task-taskId-get) to obtain subsequent updates.
3919
+
3920
+ **[Permissions](#permissions) required:**
3921
+
3922
+ * *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for each project containing issues.
3923
+ * If configured, permission to view granted by [issue-level security](https://confluence.atlassian.com/x/J4lKLg) for each issue.
3924
+ * *Edit issues* [project permission](https://confluence.atlassian.com/x/yodKLg) for each issue.</td>
3925
+ <td style="padding:15px">{base_path}/{version}/issue/properties/{pathv1}?{query}</td>
3926
+ <td style="padding:15px">Yes</td>
3927
+ </tr>
3928
+ <tr>
3929
+ <td style="padding:15px">deleteRestapi2issuepropertiespropertyKey(propertyKey, body, callback)</td>
3930
+ <td style="padding:15px">Deletes a property value from multiple issues. The issues to be updated can be specified by filter criteria.
3931
+
3932
+ The criteria the filter used to identify eligible issues are:
3933
+
3934
+ * `entityIds` Only issues from this list are eligible.
3935
+ * `currentValue` Only issues with the property set to this value are eligible.
3936
+
3937
+ If both criteria is specified, they are joined with the logical *AND*: only issues that satisfy both criteria are considered eligible.
3938
+
3939
+ If no filter criteria are specified, all the issues visible to the user and where the user has the EDIT\_ISSUES permission for the issue are considered eligible.
3940
+
3941
+ This operation is:
3942
+
3943
+ * transactional, either the property is deleted from all eligible issues or, when errors occur, no properties are deleted.
3944
+ * [asynchronous](#async). Follow the `location` link in the response to determine the status of the task and use [Get task](#api-api-2-task-taskId-get) to obtain subsequent updates.
3945
+
3946
+ **[Permissions](#permissions) required:**
3947
+
3948
+ * *Browse projects* [ project permission](https://confluence.atlassian.com/x/yodKLg) for each project containing issues.
3949
+ * If configured, permission to view granted by [issue-level security](https://confluence.atlassian.com/x/J4lKLg) for each issue.
3950
+ * *Edit issues* [project permission](https://confluence.atlassian.com/x/yodKLg) for each issue.</td>
3951
+ <td style="padding:15px">{base_path}/{version}/issue/properties/{pathv1}?{query}</td>
3952
+ <td style="padding:15px">Yes</td>
3953
+ </tr>
3954
+ <tr>
3955
+ <td style="padding:15px">getRestapi2issueissueIdOrKeyproperties(issueIdOrKey, callback)</td>
3956
+ <td style="padding:15px">Returns the URLs and keys of an issue's properties.
3957
+
3958
+ **[Permissions](#permissions) required:**
3959
+
3960
+ * *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in.
3961
+ * If configured, permission to view the issue granted by [ issue-level security](https://confluence.atlassian.com/x/J4lKLg).</td>
3962
+ <td style="padding:15px">{base_path}/{version}/issue/{pathv1}/properties?{query}</td>
3963
+ <td style="padding:15px">Yes</td>
3964
+ </tr>
3965
+ <tr>
3966
+ <td style="padding:15px">getRestapi2issueissueIdOrKeypropertiespropertyKey(issueIdOrKey, propertyKey, callback)</td>
3967
+ <td style="padding:15px">Returns the key and value of an issue's property.
3968
+
3969
+ **[Permissions](#permissions) required:**
3970
+
3971
+ * *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in.
3972
+ * If configured, permission to view the issue granted by [ issue-level security](https://confluence.atlassian.com/x/J4lKLg).</td>
3973
+ <td style="padding:15px">{base_path}/{version}/issue/{pathv1}/properties/{pathv2}?{query}</td>
3974
+ <td style="padding:15px">Yes</td>
3975
+ </tr>
3976
+ <tr>
3977
+ <td style="padding:15px">putRestapi2issueissueIdOrKeypropertiespropertyKey(issueIdOrKey, propertyKey, body, callback)</td>
3978
+ <td style="padding:15px">Sets the value of an issue's property. Use this resource to store custom data against an issue.
3979
+
3980
+ The value of the request body must be a [valid](http://tools.ietf.org/html/rfc4627), non-empty JSON blob. The maximum length is 32768 characters.
3981
+
3982
+ **[Permissions](#permissions) required:**
3983
+
3984
+ * *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in.
3985
+ * If configured, permission to view the issue granted by [ issue-level security](https://confluence.atlassian.com/x/J4lKLg).
3986
+ * *Edit issues* [project permission](https://confluence.atlassian.com/x/yodKLg) for the issue.</td>
3987
+ <td style="padding:15px">{base_path}/{version}/issue/{pathv1}/properties/{pathv2}?{query}</td>
3988
+ <td style="padding:15px">Yes</td>
3989
+ </tr>
3990
+ <tr>
3991
+ <td style="padding:15px">deleteRestapi2issueissueIdOrKeypropertiespropertyKey(issueIdOrKey, propertyKey, callback)</td>
3992
+ <td style="padding:15px">Deletes an issue's property.
3993
+
3994
+ **[Permissions](#permissions) required:**
3995
+
3996
+ * *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in.
3997
+ * If configured, permission to view the issue granted by [ issue-level security](https://confluence.atlassian.com/x/J4lKLg).
3998
+ * *Edit issues* [project permission](https://confluence.atlassian.com/x/yodKLg) for the issue.</td>
3999
+ <td style="padding:15px">{base_path}/{version}/issue/{pathv1}/properties/{pathv2}?{query}</td>
4000
+ <td style="padding:15px">Yes</td>
4001
+ </tr>
4002
+ <tr>
4003
+ <td style="padding:15px">getRestapi2search(jql, startAt, maxResults, validateQuery, fields, expand, properties, fieldsByKeys, callback)</td>
4004
+ <td style="padding:15px">Searches for issues using [JQL](https://confluence.atlassian.com/x/egORLQ).
4005
+
4006
+ If the JQL query expression is too large to be encoded as a query parameter, use the [POST](#api-api-2-search-post) version of this resource.
4007
+
4008
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4009
+ <td style="padding:15px">{base_path}/{version}/search?{query}</td>
4010
+ <td style="padding:15px">Yes</td>
4011
+ </tr>
4012
+ <tr>
4013
+ <td style="padding:15px">postRestapi2search(body, callback)</td>
4014
+ <td style="padding:15px">Searches for issues using [JQL](https://confluence.atlassian.com/x/egORLQ).
4015
+
4016
+ There is a [GET](#api-api-2-search-get) version of this resource that can be used for smaller JQL query expressions.
4017
+
4018
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4019
+ <td style="padding:15px">{base_path}/{version}/search?{query}</td>
4020
+ <td style="padding:15px">Yes</td>
4021
+ </tr>
4022
+ <tr>
4023
+ <td style="padding:15px">getRestapi2issuepicker(query, currentJQL, currentIssueKey, currentProjectId, showSubTasks, showSubTaskParent, callback)</td>
4024
+ <td style="padding:15px">Returns lists of issues matching a query string. Use this resource to provide auto-completion suggestions when the user is looking for an issue using a word or string.
4025
+
4026
+ This operation returns two lists:
4027
+
4028
+ * `History Search` which includes issues from the user's history of created, edited, or viewed issues that contain the string in the `query` parameter.
4029
+ * `Current Search` which includes issues that match the JQL expression in `currentJQL` and contain the string in the `query` parameter.
4030
+
4031
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4032
+ <td style="padding:15px">{base_path}/{version}/issue/picker?{query}</td>
4033
+ <td style="padding:15px">Yes</td>
4034
+ </tr>
4035
+ <tr>
4036
+ <td style="padding:15px">postRestapi2expressioneval(expand, body, callback)</td>
4037
+ <td style="padding:15px">Evaluates a Jira expression and returns its value.
4038
+
4039
+ This resource can be used to test Jira expressions that you plan to use elsewhere, or to fetch data in a flexible way. Consult the [Jira expressions documentation](https://developer.atlassian.com/cloud/jira/platform/jira-expressions/) for more details.
4040
+
4041
+ #### Context variables ####
4042
+
4043
+ The following context variables are available to Jira expressions evaluated by this resource. Their presence depends on various factors; usually you need to manually request them in the context object sent in the payload, but some of them are added automatically under certain conditions.
4044
+
4045
+ * `user` ([User](https://developer.atlassian.com/cloud/jira/platform/jira-expressions-type-reference#user)): The current user. Always available and equal to `null` if the request is anonymous.
4046
+ * `app` ([App](https://developer.atlassian.com/cloud/jira/platform/jira-expressions-type-reference#app)): The Connect app that made the request. Available only for authenticated requests made by Connect Apps (read more here: [Authentication for Connect apps](https://developer.atlassian.com/cloud/jira/platform/authentication-for-apps/)).
4047
+ * `issue` ([Issue](https://developer.atlassian.com/cloud/jira/platform/jira-expressions-type-reference#issue)): The current issue. Available only when the issue is provided in the request context object.
4048
+ * `project` ([Project](https://developer.atlassian.com/cloud/jira/platform/jira-expressions-type-reference#project)): The current project. Available only when the project is provided in the request context object.
4049
+ * `sprint` ([Sprint](https://developer.atlassian.com/cloud/jira/platform/jira-expressions-type-reference#sprint)): The current sprint. Available only when the sprint is provided in the request context object.
4050
+ * `board` ([Board](https://developer.atlassian.com/cloud/jira/platform/jira-expressions-type-reference#board)): The current board. Available only when the board is provided in the request context object.
4051
+
4052
+ **[Permissions](#permissions) required**: Permission to access Jira. However, an expression may return different results for different users depending on their permissions. For example, different users may see different comments on the same issue.
4053
+ Permission to access Jira Software is required to access Jira Software context variables (`board` and `sprint`) or fields (for example, `issue.sprint`).</td>
4054
+ <td style="padding:15px">{base_path}/{version}/expression/eval?{query}</td>
4055
+ <td style="padding:15px">Yes</td>
4056
+ </tr>
4057
+ <tr>
4058
+ <td style="padding:15px">getRestapi2applicationProperties(key, permissionLevel, keyFilter, callback)</td>
4059
+ <td style="padding:15px">Returns all application properties or an application property.
4060
+
4061
+ If you specify a value for the `key` parameter, then an application property is returned as an object (not in an array). Otherwise, an array of all editable application properties is returned. See [Set application property](#api-api-2-application-properties-id-put) for descriptions of editable properties.
4062
+
4063
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
4064
+ <td style="padding:15px">{base_path}/{version}/application-properties?{query}</td>
4065
+ <td style="padding:15px">Yes</td>
4066
+ </tr>
4067
+ <tr>
4068
+ <td style="padding:15px">getRestapi2applicationPropertiesadvancedSettings(callback)</td>
4069
+ <td style="padding:15px">Returns the application properties that are accessible on the *Advanced Settings* page. To navigate to the *Advanced Settings* page in Jira, choose the Jira icon > **Jira settings** > **System**, **General Configuration** and then click **Advanced Settings** (in the upper right).
4070
+
4071
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
4072
+ <td style="padding:15px">{base_path}/{version}/application-properties/advanced-settings?{query}</td>
4073
+ <td style="padding:15px">Yes</td>
4074
+ </tr>
4075
+ <tr>
4076
+ <td style="padding:15px">putRestapi2applicationPropertiesid(id, body, callback)</td>
4077
+ <td style="padding:15px">Changes the value of an application property. For example, you can change the value of the `jira.clone.prefix` from its default value of *CLONE -* to *Clone -* if you prefer sentence case capitalization. Editable properties are described below along with their default values.
4078
+
4079
+ #### Advanced settings ####
4080
+
4081
+ The advanced settings below are also accessible in [Jira](https://confluence.atlassian.com/x/vYXKM).
4082
+
4083
+ <table>
4084
+ <thead>
4085
+ <tr>
4086
+ <th>Key</th>
4087
+ <th>Description</th>
4088
+ <th>Default value</th>
4089
+ </tr>
4090
+ </thead>
4091
+ <tbody>
4092
+ <tr>
4093
+ <td><code>jira.clone.prefix</code></td>
4094
+ <td>A string of text that automatically precedes the title of a cloned issue.</td>
4095
+ <td><code>CLONE -</code></td>
4096
+ </tr>
4097
+ <tr>
4098
+ <td><code>jira.date.picker.java.format</code></td>
4099
+ <td>The date format for the Java (server-side) generated dates. This must be the same as the <code>jira.date.picker.javascript.format</code> format setting.</td>
4100
+ <td><code>d/MMM/yy</code></td>
4101
+ </tr>
4102
+ <tr>
4103
+ <td><code>jira.date.picker.javascript.format</code></td>
4104
+ <td>This date format is for the JavaScript (client-side) generated dates. This must be the same as the <code>jira.date.picker.java.format</code> format setting.</td>
4105
+ <td><code>%e/%b/%y</code></td>
4106
+ </tr>
4107
+ <tr>
4108
+ <td><code>jira.date.time.picker.java.format</code></td>
4109
+ <td>The date format for the Java (server-side) generated date times. This must be the same as the <code>jira.date.time.picker.javascript.format</code> format setting.</td>
4110
+ <td><code>dd/MMM/yy h:mm a</code></td>
4111
+ </tr>
4112
+ <tr>
4113
+ <td><code>jira.date.time.picker.javascript.format</code></td>
4114
+ <td>This date format is for the JavaScript (client-side) generated date times. This must be the same as the <code>jira.date.time.picker.java.format</code> format setting.</td>
4115
+ <td><code>%e/%b/%y %I:%M %p</code></td>
4116
+ </tr>
4117
+ <tr>
4118
+ <td><code>jira.issue.actions.order</code></td>
4119
+ <td>The default order of actions (such as <em>Comments</em> or <em>Change history</em>) displayed on the issue view.</td>
4120
+ <td><code>asc</code></td>
4121
+ </tr>
4122
+ <tr>
4123
+ <td><code>jira.table.cols.subtasks</code></td>
4124
+ <td>The columns to show while viewing subtask issues in a table. For example, a list of subtasks on an issue.</td>
4125
+ <td><code>issuetype, status, assignee, progress</code></td>
4126
+ </tr>
4127
+ <tr>
4128
+ <td><code>jira.view.issue.links.sort.order</code></td>
4129
+ <td>The sort order of the list of issue links on the issue view.</td>
4130
+ <td><code>type, status, priority</code></td>
4131
+ </tr>
4132
+ <tr>
4133
+ <td><code>jira.comment.collapsing.minimum.hidden</code></td>
4134
+ <td>The minimum number of comments required for comment collapsing to occur. A value of <code>0</code> disables comment collapsing.</td>
4135
+ <td><code>4</code></td>
4136
+ </tr>
4137
+ <tr>
4138
+ <td><code>jira.newsletter.tip.delay.days</code></td>
4139
+ <td>The number of days before a prompt to sign up to the Jira Insiders newsletter is shown. A value of <code>-1</code> disables this functionality.</td>
4140
+ <td><code>7</code></td>
4141
+ </tr>
4142
+ </tbody>
4143
+ </table>
4144
+
4145
+ #### Look and feel ####
4146
+
4147
+ The settings listed below adjust the [look and feel](https://confluence.atlassian.com/x/VwCLLg).
4148
+
4149
+ <table>
4150
+ <thead>
4151
+ <tr>
4152
+ <th>Key</th>
4153
+ <th>Description</th>
4154
+ <th>Default value</th>
4155
+ </tr>
4156
+ </thead>
4157
+ <tbody>
4158
+ <tr>
4159
+ <td><code>jira.lf.date.time</code></td>
4160
+ <td>Look and feel of the <a href="https://docs.oracle.com/javase/6/docs/api/index.html?java/text/SimpleDateFormat.html" rel="nofollow">time format</a>.</td>
4161
+ <td><code>h:mm a</code></td>
4162
+ </tr>
4163
+ <tr>
4164
+ <td><code>jira.lf.date.day</code></td>
4165
+ <td>Look and feel of the <a href="https://docs.oracle.com/javase/6/docs/api/index.html?java/text/SimpleDateFormat.html" rel="nofollow">day format</a>.</td>
4166
+ <td><code>EEEE h:mm a</code></td>
4167
+ </tr>
4168
+ <tr>
4169
+ <td><code>jira.lf.date.complete</code></td>
4170
+ <td>Look and feel of the <a href="https://docs.oracle.com/javase/6/docs/api/index.html?java/text/SimpleDateFormat.html" rel="nofollow">date and time format</a>.</td>
4171
+ <td><code>dd/MMM/yy h:mm a</code></td>
4172
+ </tr>
4173
+ <tr>
4174
+ <td><code>jira.lf.date.dmy</code></td>
4175
+ <td>Look and feel of the <a href="https://docs.oracle.com/javase/6/docs/api/index.html?java/text/SimpleDateFormat.html" rel="nofollow">date format</a>.</td>
4176
+ <td><code>dd/MMM/yy</code></td>
4177
+ </tr>
4178
+ <tr>
4179
+ <td><code>jira.date.time.picker.use.iso8061</code></td>
4180
+ <td>When enabled, sets Monday as the first day of the week in the date picker, as specified by the ISO8601 standard.</td>
4181
+ <td><code>false</code></td>
4182
+ </tr>
4183
+ <tr>
4184
+ <td><code>jira.lf.logo.url</code></td>
4185
+ <td>The URL of the logo image file.</td>
4186
+ <td><code>/images/icon-jira-logo.png</code></td>
4187
+ </tr>
4188
+ <tr>
4189
+ <td><code>jira.lf.logo.show.application.title</code></td>
4190
+ <td>Controls the visibility of the application title on the sidebar.</td>
4191
+ <td><code>false</code></td>
4192
+ </tr>
4193
+ <tr>
4194
+ <td><code>jira.lf.favicon.url</code></td>
4195
+ <td>The URL of the favicon.</td>
4196
+ <td><code>/favicon.ico</code></td>
4197
+ </tr>
4198
+ <tr>
4199
+ <td><code>jira.lf.favicon.hires.url</code></td>
4200
+ <td>The URL of the high resolution favicon.</td>
4201
+ <td><code>/images/64jira.png</code></td>
4202
+ </tr>
4203
+ <tr>
4204
+ <td><code>jira.lf.top.adg3.bgcolour</code></td>
4205
+ <td>The background color of the sidebar.</td>
4206
+ <td><code>#0747A6</code></td>
4207
+ </tr>
4208
+ <tr>
4209
+ <td><code>jira.lf.top.adg3.textcolour</code></td>
4210
+ <td>The color of the text and logo of the sidebar.</td>
4211
+ <td><code>#DEEBFF</code></td>
4212
+ </tr>
4213
+ <tr>
4214
+ <td><code>jira.lf.hero.button.base.bg.colour</code></td>
4215
+ <td></td>
4216
+ <td><code>#3b7fc4</code></td>
4217
+ </tr>
4218
+ <tr>
4219
+ <td><code>jira.title</code></td>
4220
+ <td>The text for the application title. The application title can also be set in <em>General settings</em>.</td>
4221
+ <td><code>Jira</code></td>
4222
+ </tr>
4223
+ <tr>
4224
+ <td><code>jira.option.globalsharing</code></td>
4225
+ <td>boolean</td>
4226
+ <td><code>true</code></td>
4227
+ </tr>
4228
+ <tr>
4229
+ <td><code>xflow.product.suggestions.enabled</code></td>
4230
+ <td>Indicates whether to expose product suggestions for other Atlassian products within Jira.</td>
4231
+ <td><code>true</code></td>
4232
+ </tr>
4233
+ </tbody>
4234
+ </table>
4235
+
4236
+ #### Other settings ####
4237
+
4238
+ <table>
4239
+ <thead>
4240
+ <tr>
4241
+ <th>Key</th>
4242
+ <th>Description</th>
4243
+ <th>Default value</th>
4244
+ </tr>
4245
+ </thead>
4246
+ <tbody>
4247
+ <tr>
4248
+ <td><code>jira.issuenav.criteria.autoupdate</code></td>
4249
+ <td>Supports instant updates to search criteria.</td>
4250
+ <td><code>true</code></td>
4251
+ </tr>
4252
+ </tbody>
4253
+ </table>
4254
+
4255
+ *Note: Be careful when changing [application properties and advanced settings](https://confluence.atlassian.com/x/vYXKM).*
4256
+
4257
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
4258
+ <td style="padding:15px">{base_path}/{version}/application-properties/{pathv1}?{query}</td>
4259
+ <td style="padding:15px">Yes</td>
4260
+ </tr>
4261
+ <tr>
4262
+ <td style="padding:15px">getRestapi2configuration(callback)</td>
4263
+ <td style="padding:15px">Returns the [global settings](https://confluence.atlassian.com/x/qYXKM) in Jira. These settings determine whether optional features (for example, subtasks, time tracking, and others) are enabled. If time tracking is enabled, this operation also returns the time tracking configuration.
4264
+
4265
+ **[Permissions](#permissions) required:** Permission to access Jira .</td>
4266
+ <td style="padding:15px">{base_path}/{version}/configuration?{query}</td>
4267
+ <td style="padding:15px">Yes</td>
4268
+ </tr>
4269
+ <tr>
4270
+ <td style="padding:15px">getRestapi2jqlautocompletedata(callback)</td>
4271
+ <td style="padding:15px">Returns reference data for JQL searches. This is a downloadable version of the documentation provided in [Advanced searching - fields reference](https://confluence.atlassian.com/x/gwORLQ) and [Advanced searching - functions reference](https://confluence.atlassian.com/x/hgORLQ), along with a list of JQL-reserved words. Use this information to assist with the programmatic creation of JQL queries or the validation of queries built in a custom query builder.
4272
+
4273
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4274
+ <td style="padding:15px">{base_path}/{version}/jql/autocompletedata?{query}</td>
4275
+ <td style="padding:15px">Yes</td>
4276
+ </tr>
4277
+ <tr>
4278
+ <td style="padding:15px">getRestapi2jqlautocompletedatasuggestions(fieldName, fieldValue, predicateName, predicateValue, callback)</td>
4279
+ <td style="padding:15px">Returns the JQL search auto complete suggestions for a field.
4280
+
4281
+ Suggestions can be obtained by providing:
4282
+
4283
+ * `fieldName` to get a list of all values for the field.
4284
+ * `fieldName` and `fieldValue` to get a list of values containing the text in `fieldValue`.
4285
+ * `fieldName` and `predicateName` to get a list of all predicate values for the field.
4286
+ * `fieldName`, `predicateName`, and `predicateValue` to get a list of predicate values containing the text in `predicateValue`.
4287
+
4288
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4289
+ <td style="padding:15px">{base_path}/{version}/jql/autocompletedata/suggestions?{query}</td>
4290
+ <td style="padding:15px">Yes</td>
4291
+ </tr>
4292
+ <tr>
4293
+ <td style="padding:15px">postRestapi2jqlpdcleaner(body, callback)</td>
4294
+ <td style="padding:15px">Converts one or more JQL queries with user identifiers (username or user key) to equivalent JQL queries with account IDs.
4295
+
4296
+ You may wish to use this operation if your system stores JQL queries and you want to make them GDPR-compliant. For more information about GDPR-related changes, see the [migration guide](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/).
4297
+
4298
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4299
+ <td style="padding:15px">{base_path}/{version}/jql/pdcleaner?{query}</td>
4300
+ <td style="padding:15px">Yes</td>
4301
+ </tr>
4302
+ <tr>
4303
+ <td style="padding:15px">getRestapi2mypreferences(key, callback)</td>
4304
+ <td style="padding:15px">Returns the value of a preference of the current user.
4305
+
4306
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4307
+ <td style="padding:15px">{base_path}/{version}/mypreferences?{query}</td>
4308
+ <td style="padding:15px">Yes</td>
4309
+ </tr>
4310
+ <tr>
4311
+ <td style="padding:15px">putRestapi2mypreferences(key, body, callback)</td>
4312
+ <td style="padding:15px">Creates a preference for the user or updates a preference's value by sending a plain text string. For example, `false`. An arbitrary preference can be created with the value containing up to 255 characters. In addition, the following keys define system preferences that can be set or created:
4313
+
4314
+ * *user.notifications.mimetype* The mime type used in notifications sent to the user. Defaults to `html`.
4315
+ * *user.notify.own.changes* Indicates whether the user gets notified of their own changes. Defaults to `false`.
4316
+ * *jira.user.locale* The locale of the user. By default, not set: the user takes the instance locale. See also, [Set locale](#api-api-2-mypreferences-locale-put).
4317
+ * *jira.user.timezone* The time zone of the user. By default, not set, the user takes the instance time zone.
4318
+ * *user.default.share.private* Indicates whether new [ filters](https://confluence.atlassian.com/x/eQiiLQ) are set to private. Defaults to `true`.
4319
+ * *user.keyboard.shortcuts.disabled* Indicates whether keyboard shortcuts are disabled. Defaults to `false`.
4320
+ * *user.autowatch.disabled* Indicates whether the user automatically watches issues they create or add a comment to. By default, not set: the user takes the instance autowatch setting.
4321
+
4322
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4323
+ <td style="padding:15px">{base_path}/{version}/mypreferences?{query}</td>
4324
+ <td style="padding:15px">Yes</td>
4325
+ </tr>
4326
+ <tr>
4327
+ <td style="padding:15px">deleteRestapi2mypreferences(key, callback)</td>
4328
+ <td style="padding:15px">Deletes a preference of the user, which restores the default value of system defined settings.
4329
+
4330
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4331
+ <td style="padding:15px">{base_path}/{version}/mypreferences?{query}</td>
4332
+ <td style="padding:15px">Yes</td>
4333
+ </tr>
4334
+ <tr>
4335
+ <td style="padding:15px">getRestapi2mypreferenceslocale(callback)</td>
4336
+ <td style="padding:15px">Returns the locale for the user.
4337
+
4338
+ If the user has no language preference set (which is the default setting) or this resource is accessed anonymous, the browser locale detected by Jira is returned. Jira detects the browser locale using the *Accept-Language* header in the request. However, if this doesn't match a locale available Jira, the site default locale is returned.
4339
+
4340
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4341
+ <td style="padding:15px">{base_path}/{version}/mypreferences/locale?{query}</td>
4342
+ <td style="padding:15px">Yes</td>
4343
+ </tr>
4344
+ <tr>
4345
+ <td style="padding:15px">putRestapi2mypreferenceslocale(body, callback)</td>
4346
+ <td style="padding:15px">Sets the locale of the user. The locale must be one supported by the instance of Jira.
4347
+
4348
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4349
+ <td style="padding:15px">{base_path}/{version}/mypreferences/locale?{query}</td>
4350
+ <td style="padding:15px">Yes</td>
4351
+ </tr>
4352
+ <tr>
4353
+ <td style="padding:15px">deleteRestapi2mypreferenceslocale(callback)</td>
4354
+ <td style="padding:15px">Deletes the locale of the user, which restores the default setting.
4355
+
4356
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4357
+ <td style="padding:15px">{base_path}/{version}/mypreferences/locale?{query}</td>
4358
+ <td style="padding:15px">Yes</td>
4359
+ </tr>
4360
+ <tr>
4361
+ <td style="padding:15px">getRestapi2myself(expand, callback)</td>
4362
+ <td style="padding:15px">Returns details for the current user.
4363
+
4364
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4365
+ <td style="padding:15px">{base_path}/{version}/myself?{query}</td>
4366
+ <td style="padding:15px">Yes</td>
4367
+ </tr>
4368
+ <tr>
4369
+ <td style="padding:15px">getRestapi2mypermissions(projectKey, projectId, issueKey, issueId, permissions, callback)</td>
4370
+ <td style="padding:15px">Returns a list of permissions indicating which permissions the user has. Details of the user's permissions can be obtained in a global, project, or issue context.
4371
+
4372
+ The user is reported as having a project permission:
4373
+
4374
+ * in the global context, if the user has the project permission in any project.
4375
+ * for a project, where the project permission is determined using issue data, if the user meets the permission's criteria for any issue in the project. Otherwise, if the user has the project permission in the project.
4376
+ * for an issue, where a project permission is determined using issue data, if the user has the permission in the issue. Otherwise, if the user has the project permission in the project containing the issue.
4377
+
4378
+ This means that users may be shown as having an issue permission (such as EDIT\_ISSUE) in the global context or a project context but may not have the permission for any or all issues. For example, if Reporters have the EDIT\_ISSUE permission a user would be shown as having this permission in the global context or the context of a project, because any user can be a reporter. However, if they are not the user who reported the issue queried they would not have EDIT\_ISSUE permission for that issue.
4379
+
4380
+ Global permissions are unaffected by context.
4381
+
4382
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4383
+ <td style="padding:15px">{base_path}/{version}/mypermissions?{query}</td>
4384
+ <td style="padding:15px">Yes</td>
4385
+ </tr>
4386
+ <tr>
4387
+ <td style="padding:15px">getRestapi2permissions(callback)</td>
4388
+ <td style="padding:15px">Returns all permissions, including:
4389
+
4390
+ * global permissions.
4391
+ * project permissions.
4392
+ * global permissions added by plugins.
4393
+
4394
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
4395
+ <td style="padding:15px">{base_path}/{version}/permissions?{query}</td>
4396
+ <td style="padding:15px">Yes</td>
4397
+ </tr>
4398
+ <tr>
4399
+ <td style="padding:15px">postRestapi2permissionscheck(body, callback)</td>
4400
+ <td style="padding:15px">Returns:
4401
+
4402
+ * for a list of global permissions, the global permissions granted to the user.
4403
+ * for a list of project permissions and lists of projects and issues, for each project permission a list of the projects and issues the user can access or manipulate.
4404
+
4405
+ Note that:
4406
+
4407
+ * Invalid project and issue IDs are ignored.
4408
+ * A maximum of 1000 projects and 1000 issues can be checked.
4409
+
4410
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4411
+ <td style="padding:15px">{base_path}/{version}/permissions/check?{query}</td>
4412
+ <td style="padding:15px">Yes</td>
4413
+ </tr>
4414
+ <tr>
4415
+ <td style="padding:15px">postRestapi2permissionsproject(body, callback)</td>
4416
+ <td style="padding:15px">Returns all the projects where the user is granted a list of project permissions.
4417
+
4418
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4419
+ <td style="padding:15px">{base_path}/{version}/permissions/project?{query}</td>
4420
+ <td style="padding:15px">Yes</td>
4421
+ </tr>
4422
+ <tr>
4423
+ <td style="padding:15px">getRestapi2permissionscheme(expand, callback)</td>
4424
+ <td style="padding:15px">Returns all permission schemes.
4425
+
4426
+ ### About permission schemes and grants ###
4427
+
4428
+ A permission scheme is a collection of permission grants. A permission grant consists of a `holder` and a `permission`.
4429
+
4430
+ #### Holder ####
4431
+
4432
+ The `holder` object contains information about the user or group being granted the permission. For example, the *Administer projects* permission is granted to a group named *Teams in space administrators*. In this case, the type is `"type": "group"`, and the parameter is the group name, `"parameter": "Teams in space administrators"`. The `holder` object is defined by the following properties:
4433
+
4434
+ * `type` Identifies the user or group (see the list of types below).
4435
+ * `parameter` The value of this property depends on the `type`. For example, if the `type` is a group, then you need to specify the group name.
4436
+
4437
+ The following `types` are available. The expected values for the `parameter` are given in parenthesis (some `types` may not have a `parameter`):
4438
+
4439
+ * `anyone` Grant for anonymous users.
4440
+ * `applicationRole` Grant for users with access to the specified application (application name). See [Manage application access](https://confluence.atlassian.com/cloud/manage-application-access-744721629.html) for more information.
4441
+ * `assignee` Grant for the user currently assigned to an issue.
4442
+ * `group` Grant for the specified group (group name).
4443
+ * `groupCustomField` Grant for a user in the group selected in the specified custom field (custom field ID).
4444
+ * `projectLead` Grant for a project lead.
4445
+ * `projectRole` Grant for the specified project role (project role ID).
4446
+ * `reporter` Grant for the user who reported the issue.
4447
+ * `sd.customer.portal.only` Jira Service Desk only. Grants customers permission to access the customer portal but not Jira. See [Customizing Jira Service Desk permissions](https://confluence.atlassian.com/x/24dKLg) for more information.
4448
+ * `user` Grant for the specified user (user ID - historically this was the userkey but that is deprecated and the account ID should be used).
4449
+ * `userCustomField` Grant for a user selected in the specified custom field (custom field ID).
4450
+
4451
+ #### Permissions ####
4452
+
4453
+ The [built-in Jira permissions](https://confluence.atlassian.com/x/yodKLg) are listed below. Apps can also define custom permissions. See the [project permission](https://developer.atlassian.com/cloud/jira/platform/modules/project-permission/) and [global permission](https://developer.atlassian.com/cloud/jira/platform/modules/global-permission/) module documentation for more information.
4454
+
4455
+ **Project permissions**
4456
+
4457
+ * `ADMINISTER_PROJECTS`
4458
+ * `BROWSE_PROJECTS`
4459
+ * `MANAGE_SPRINTS_PERMISSION` (Jira Software only)
4460
+ * `SERVICEDESK_AGENT` (Jira Service Desk only)
4461
+ * `VIEW_DEV_TOOLS` (Jira Software only)
4462
+ * `VIEW_READONLY_WORKFLOW`
4463
+
4464
+ **Issue permissions**
4465
+
4466
+ * `ASSIGNABLE_USER`
4467
+ * `ASSIGN_ISSUES`
4468
+ * `CLOSE_ISSUES`
4469
+ * `CREATE_ISSUES`
4470
+ * `DELETE_ISSUES`
4471
+ * `EDIT_ISSUES`
4472
+ * `LINK_ISSUES`
4473
+ * `MODIFY_REPORTER`
4474
+ * `MOVE_ISSUES`
4475
+ * `RESOLVE_ISSUES`
4476
+ * `SCHEDULE_ISSUES`
4477
+ * `SET_ISSUE_SECURITY`
4478
+ * `TRANSITION_ISSUES`
4479
+
4480
+ **Voters and watchers permissions**
4481
+
4482
+ * `MANAGE_WATCHERS`
4483
+ * `VIEW_VOTERS_AND_WATCHERS`
4484
+
4485
+ **Comments permissions**
4486
+
4487
+ * `ADD_COMMENTS`
4488
+ * `DELETE_ALL_COMMENTS`
4489
+ * `DELETE_OWN_COMMENTS`
4490
+ * `EDIT_ALL_COMMENTS`
4491
+ * `EDIT_OWN_COMMENTS`
4492
+
4493
+ **Attachments permissions**
4494
+
4495
+ * `CREATE_ATTACHMENTS`
4496
+ * `DELETE_ALL_ATTACHMENTS`
4497
+ * `DELETE_OWN_ATTACHMENTS`
4498
+
4499
+ **Time tracking permissions**
4500
+
4501
+ * `DELETE_ALL_WORKLOGS`
4502
+ * `DELETE_OWN_WORKLOGS`
4503
+ * `EDIT_ALL_WORKLOGS`
4504
+ * `EDIT_OWN_WORKLOGS`
4505
+ * `WORK_ON_ISSUES`
4506
+
4507
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4508
+ <td style="padding:15px">{base_path}/{version}/permissionscheme?{query}</td>
4509
+ <td style="padding:15px">Yes</td>
4510
+ </tr>
4511
+ <tr>
4512
+ <td style="padding:15px">postRestapi2permissionscheme(expand, body, callback)</td>
4513
+ <td style="padding:15px">Creates a new permission scheme. You can create a permission scheme with or without defining a set of permission grants.
4514
+
4515
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
4516
+ <td style="padding:15px">{base_path}/{version}/permissionscheme?{query}</td>
4517
+ <td style="padding:15px">Yes</td>
4518
+ </tr>
4519
+ <tr>
4520
+ <td style="padding:15px">getRestapi2permissionschemeschemeId(schemeId, expand, callback)</td>
4521
+ <td style="padding:15px">Returns a permission scheme.
4522
+
4523
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4524
+ <td style="padding:15px">{base_path}/{version}/permissionscheme/{pathv1}?{query}</td>
4525
+ <td style="padding:15px">Yes</td>
4526
+ </tr>
4527
+ <tr>
4528
+ <td style="padding:15px">putRestapi2permissionschemeschemeId(schemeId, expand, body, callback)</td>
4529
+ <td style="padding:15px">Updates a permission scheme. Below are some important things to note when using this resource:
4530
+
4531
+ * If a permissions list is present in the request, then it is set in the permission scheme, overwriting *all existing* grants.
4532
+ * If you want to update only the name and description, then do not send a permissions list in the request.
4533
+ * Sending an empty list will remove all permission grants from the permission scheme.
4534
+
4535
+ If you want to add or delete a permission grant instead of updating the whole list, see [Create permission grant](#api-api-2-permissionscheme-schemeId-permission-post) or [Delete permission scheme entity](#api-api-2-permissionscheme-schemeId-permission-permissionId-delete).
4536
+
4537
+ See [About permission schemes and grants](#about-permission-schemes) for more details.
4538
+
4539
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
4540
+ <td style="padding:15px">{base_path}/{version}/permissionscheme/{pathv1}?{query}</td>
4541
+ <td style="padding:15px">Yes</td>
4542
+ </tr>
4543
+ <tr>
4544
+ <td style="padding:15px">deleteRestapi2permissionschemeschemeId(schemeId, callback)</td>
4545
+ <td style="padding:15px">Deletes a permission scheme.
4546
+
4547
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
4548
+ <td style="padding:15px">{base_path}/{version}/permissionscheme/{pathv1}?{query}</td>
4549
+ <td style="padding:15px">Yes</td>
4550
+ </tr>
4551
+ <tr>
4552
+ <td style="padding:15px">getRestapi2permissionschemeschemeIdpermission(schemeId, expand, callback)</td>
4553
+ <td style="padding:15px">Returns all permission grants for a permission scheme.
4554
+
4555
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4556
+ <td style="padding:15px">{base_path}/{version}/permissionscheme/{pathv1}/permission?{query}</td>
4557
+ <td style="padding:15px">Yes</td>
4558
+ </tr>
4559
+ <tr>
4560
+ <td style="padding:15px">postRestapi2permissionschemeschemeIdpermission(schemeId, expand, body, callback)</td>
4561
+ <td style="padding:15px">Creates a permission grant in a permission scheme.
4562
+
4563
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
4564
+ <td style="padding:15px">{base_path}/{version}/permissionscheme/{pathv1}/permission?{query}</td>
4565
+ <td style="padding:15px">Yes</td>
4566
+ </tr>
4567
+ <tr>
4568
+ <td style="padding:15px">getRestapi2permissionschemeschemeIdpermissionpermissionId(schemeId, permissionId, expand, callback)</td>
4569
+ <td style="padding:15px">Returns a permission grant.
4570
+
4571
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4572
+ <td style="padding:15px">{base_path}/{version}/permissionscheme/{pathv1}/permission/{pathv2}?{query}</td>
4573
+ <td style="padding:15px">Yes</td>
4574
+ </tr>
4575
+ <tr>
4576
+ <td style="padding:15px">deleteRestapi2permissionschemeschemeIdpermissionpermissionId(schemeId, permissionId, callback)</td>
4577
+ <td style="padding:15px">Deletes a permission grant from a permission scheme. See [About permission schemes and grants](#about-permission-schemes) for more details.
4578
+
4579
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
4580
+ <td style="padding:15px">{base_path}/{version}/permissionscheme/{pathv1}/permission/{pathv2}?{query}</td>
4581
+ <td style="padding:15px">Yes</td>
4582
+ </tr>
4583
+ <tr>
4584
+ <td style="padding:15px">getRestapi2projectprojectKeyOrIdnotificationscheme(projectKeyOrId, expand, callback)</td>
4585
+ <td style="padding:15px">Gets a [notification scheme](https://confluence.atlassian.com/x/8YdKLg) associated with the project. See the [Get notification scheme](#api-api-2-notificationscheme-id-get) resource for more information about notification schemes.
4586
+
4587
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg) or *Administer Projects* [project permission](https://confluence.atlassian.com/x/yodKLg).</td>
4588
+ <td style="padding:15px">{base_path}/{version}/project/{pathv1}/notificationscheme?{query}</td>
4589
+ <td style="padding:15px">Yes</td>
4590
+ </tr>
4591
+ <tr>
4592
+ <td style="padding:15px">getRestapi2project(expand, recent, callback)</td>
4593
+ <td style="padding:15px">Returns all projects visible to the user. Deprecated, use [ Get projects paginated](#api-api-2-project-search-get) that supports search and pagination.
4594
+
4595
+ **[Permissions](#permissions) required:** None, however, projects are returned only where:
4596
+
4597
+ * the user has *Browse Projects* or *Administer projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project.
4598
+ * the project is public.</td>
4599
+ <td style="padding:15px">{base_path}/{version}/project?{query}</td>
4600
+ <td style="padding:15px">Yes</td>
4601
+ </tr>
4602
+ <tr>
4603
+ <td style="padding:15px">postRestapi2project(body, callback)</td>
4604
+ <td style="padding:15px">Creates a project based on a project type template, as shown in the following table:
4605
+
4606
+ <table>
4607
+ <thead>
4608
+ <tr>
4609
+ <th>Project Type Key</th>
4610
+ <th>Project Template Key</th>
4611
+ </tr>
4612
+ <tr>
4613
+ <td style="padding:15px">getRestapi2applicationrole(callback)</td>
4614
+ <td style="padding:15px">Returns all application roles. In Jira, application roles are managed using the [Application access configuration](https://confluence.atlassian.com/x/3YxjL) page.
4615
+
4616
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
4617
+ <td style="padding:15px">{base_path}/{version}/applicationrole?{query}</td>
4618
+ <td style="padding:15px">Yes</td>
4619
+ </tr>
4620
+ <tr>
4621
+ <td style="padding:15px">getRestapi2applicationrolekey(key, callback)</td>
4622
+ <td style="padding:15px">Returns an application role.
4623
+
4624
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
4625
+ <td style="padding:15px">{base_path}/{version}/applicationrole/{pathv1}?{query}</td>
4626
+ <td style="padding:15px">Yes</td>
4627
+ </tr>
4628
+ <tr>
4629
+ <td style="padding:15px">getRestapi2auditingrecord(offset, limit, filter, from, to, callback)</td>
4630
+ <td style="padding:15px">Returns a list of audit records. The list can be filtered to include items:
4631
+
4632
+ * containing a string in at least one field. For example, providing *up* will return all audit records where one or more fields contains words such as *update*.
4633
+ * created on or after a date and time.
4634
+ * created or or before a date and time.
4635
+ * created during a time period.
4636
+
4637
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
4638
+ <td style="padding:15px">{base_path}/{version}/auditing/record?{query}</td>
4639
+ <td style="padding:15px">Yes</td>
4640
+ </tr>
4641
+ <tr>
4642
+ <td style="padding:15px">getRestapi2dashboard(filter, startAt, maxResults, callback)</td>
4643
+ <td style="padding:15px">Returns a list of dashboards owned by or shared with the user. The list may be filtered to include only favorite or owned dashboards.
4644
+
4645
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4646
+ <td style="padding:15px">{base_path}/{version}/dashboard?{query}</td>
4647
+ <td style="padding:15px">Yes</td>
4648
+ </tr>
4649
+ <tr>
4650
+ <td style="padding:15px">getRestapi2dashboardsearch(dashboardName, accountId, owner, groupname, projectId, orderBy, startAt, maxResults, expand, callback)</td>
4651
+ <td style="padding:15px">Searches for dashboards. This operation is similar to [Get dashboards](#api-api-2-dashboard-get) except that the results can be refined to include dashboards that have specific attributes. For example, dashboards with a particular name. When multiple attributes are specified only filters matching all attributes are returned.
4652
+
4653
+ **[Permissions](#permissions) required:** None, however, only the following dashboards that match the query parameters are returned:
4654
+
4655
+ * Dashboards owned by the user. Not returned for anonymous users.
4656
+ * Dashboards shared with a group that the user is a member of. Not returned for anonymous users.
4657
+ * Dashboards shared with a private project that the user can browse. Not returned for anonymous users.
4658
+ * Dashboards shared with a public project.
4659
+ * Dashboards shared with the public.</td>
4660
+ <td style="padding:15px">{base_path}/{version}/dashboard/search?{query}</td>
4661
+ <td style="padding:15px">Yes</td>
4662
+ </tr>
4663
+ <tr>
4664
+ <td style="padding:15px">getRestapi2dashboarddashboardIditemsitemIdproperties(dashboardId, itemId, callback)</td>
4665
+ <td style="padding:15px">Returns the keys of all properties for a dashboard item.
4666
+
4667
+ **[Permissions](#permissions) required:** Permission to access Jira. However, to get the property keys the user must be the owner of the dashboard or be shared the dashboard. Note, users with the *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg) are considered owners of the System dashboard. The System dashboard is considered to be shared with all other users.</td>
4668
+ <td style="padding:15px">{base_path}/{version}/dashboard/{pathv1}/items/{pathv2}/properties?{query}</td>
4669
+ <td style="padding:15px">Yes</td>
4670
+ </tr>
4671
+ <tr>
4672
+ <td style="padding:15px">getRestapi2dashboarddashboardIditemsitemIdpropertiespropertyKey(dashboardId, itemId, propertyKey, callback)</td>
4673
+ <td style="padding:15px">Returns the key and value of a dashboard item property.
4674
+
4675
+ A dashboard item enables an app to add user-specific information to a user dashboard. Dashboard items are exposed to users as gadgets that users can add to their dashboards. For more information on how users do this, see [Adding and customizing gadgets](https://confluence.atlassian.com/x/7AeiLQ).
4676
+
4677
+ When an app creates a dashboard item it registers a callback to receive the dashboard item ID. The callback fires whenever the item is rendered or, where the item is configurable, the user edits the item. The app then uses this resource to store the item's content or configuration details. For more information on working with dashboard items, see [ Building a dashboard item for a JIRA Connect add-on](https://developer.atlassian.com/server/jira/platform/guide-building-a-dashboard-item-for-a-jira-connect-add-on-33746254/) and the [Dashboard Item](https://developer.atlassian.com/cloud/jira/platform/modules/dashboard-item/) documentation.
4678
+
4679
+ There is no resource to set or get dashboard items.
4680
+
4681
+ **[Permissions](#permissions) required:** Permission to access Jira. However, to get a dashboard item property the user must be the owner of the dashboard or be shared the dashboard. Note, users with the *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg) are considered owners of the System dashboard. The System dashboard is considered to be shared with all other users.</td>
4682
+ <td style="padding:15px">{base_path}/{version}/dashboard/{pathv1}/items/{pathv2}/properties/{pathv3}?{query}</td>
4683
+ <td style="padding:15px">Yes</td>
4684
+ </tr>
4685
+ <tr>
4686
+ <td style="padding:15px">putRestapi2dashboarddashboardIditemsitemIdpropertiespropertyKey(dashboardId, itemId, propertyKey, body, callback)</td>
4687
+ <td style="padding:15px">Sets the value of a dashboard item property. Use this resource in apps to store custom data against a dashboard item.
4688
+
4689
+ A dashboard item enables an app to add user-specific information to a user dashboard. Dashboard items are exposed to users as gadgets that users can add to their dashboards. For more information on how users do this, see [Adding and customizing gadgets](https://confluence.atlassian.com/x/7AeiLQ).
4690
+
4691
+ When an app creates a dashboard item it registers a callback to receive the dashboard item ID. The callback fires whenever the item is rendered or, where the item is configurable, the user edits the item. The app then uses this resource to store the item's content or configuration details. For more information on working with dashboard items, see [ Building a dashboard item for a JIRA Connect add-on](https://developer.atlassian.com/server/jira/platform/guide-building-a-dashboard-item-for-a-jira-connect-add-on-33746254/) and the [Dashboard Item](https://developer.atlassian.com/cloud/jira/platform/modules/dashboard-item/) documentation.
4692
+
4693
+ There is no resource to set or get dashboard items.
4694
+
4695
+ The value of the request body must be a [valid](http://tools.ietf.org/html/rfc4627), non-empty JSON blob. The maximum length is 32768 characters.
4696
+
4697
+ **[Permissions](#permissions) required:** Permission to access Jira. However, to set a dashboard item property the user must be the owner of the dashboard. Note, users with the *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg) are considered owners of the System dashboard.</td>
4698
+ <td style="padding:15px">{base_path}/{version}/dashboard/{pathv1}/items/{pathv2}/properties/{pathv3}?{query}</td>
4699
+ <td style="padding:15px">Yes</td>
4700
+ </tr>
4701
+ <tr>
4702
+ <td style="padding:15px">deleteRestapi2dashboarddashboardIditemsitemIdpropertiespropertyKey(dashboardId, itemId, propertyKey, callback)</td>
4703
+ <td style="padding:15px">Deletes a dashboard item property.
4704
+
4705
+ **[Permissions](#permissions) required:** Permission to access Jira. However, to delete a dashboard item property the user must be the owner of the dashboard. Note, users with the *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg) are considered owners of the System dashboard.</td>
4706
+ <td style="padding:15px">{base_path}/{version}/dashboard/{pathv1}/items/{pathv2}/properties/{pathv3}?{query}</td>
4707
+ <td style="padding:15px">Yes</td>
4708
+ </tr>
4709
+ <tr>
4710
+ <td style="padding:15px">getRestapi2dashboardid(id, callback)</td>
4711
+ <td style="padding:15px">Returns a dashboard.
4712
+
4713
+ **[Permissions](#permissions) required:** Permission to access Jira. However, to get a dashboard, the dashboard must be shared with the user or the user must own it. Note, users with the *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg) are considered owners of the System dashboard. The System dashboard is considered to be shared with all other users.</td>
4714
+ <td style="padding:15px">{base_path}/{version}/dashboard/{pathv1}?{query}</td>
4715
+ <td style="padding:15px">Yes</td>
4716
+ </tr>
4717
+ <tr>
4718
+ <td style="padding:15px">getRestapi2filter(expand, callback)</td>
4719
+ <td style="padding:15px">Returns all filters. Deprecated, use [ Search for filters](#api-api-2-filter-search-get) that supports search and pagination.
4720
+
4721
+ **[Permissions](#permissions) required:** Permission to access Jira, however, only the following are returned:
4722
+
4723
+ * filters owned by the user.
4724
+ * filters shared with a group that the user is a member of.
4725
+ * filters shared with a private project that the user has *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for.
4726
+ * filters shared with a public project.
4727
+ * filters shared with the public.</td>
4728
+ <td style="padding:15px">{base_path}/{version}/filter?{query}</td>
4729
+ <td style="padding:15px">Yes</td>
4730
+ </tr>
4731
+ <tr>
4732
+ <td style="padding:15px">postRestapi2filter(expand, body, callback)</td>
4733
+ <td style="padding:15px">Creates a filter. The filter is shared according to the [default share scope](#api-api-2-filter-post). The filter is not selected as a favorite.
4734
+
4735
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4736
+ <td style="padding:15px">{base_path}/{version}/filter?{query}</td>
4737
+ <td style="padding:15px">Yes</td>
4738
+ </tr>
4739
+ <tr>
4740
+ <td style="padding:15px">getRestapi2filterfavourite(expand, callback)</td>
4741
+ <td style="padding:15px">Returns the visible favorite filters of the user.
4742
+
4743
+ **[Permissions](#permissions) required:** Permission to access Jira, however, a favorite filters is only visible to the user where the filter is:
4744
+
4745
+ * owned by the user.
4746
+ * shared with a group that the user is a member of.
4747
+ * shared with a private project that the user has *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for.
4748
+ * shared with a public project.
4749
+ * shared with the public.
4750
+
4751
+ For example, if the user favorites a public filter that is subsequently made private that filter is not returned by this operation.</td>
4752
+ <td style="padding:15px">{base_path}/{version}/filter/favourite?{query}</td>
4753
+ <td style="padding:15px">Yes</td>
4754
+ </tr>
4755
+ <tr>
4756
+ <td style="padding:15px">getRestapi2filtermy(expand, includeFavourites, callback)</td>
4757
+ <td style="padding:15px">Returns the filters owned by the user. If `includeFavourites` is `true`, the user's visible favorite filters are also returned.
4758
+
4759
+ **[Permissions](#permissions) required:** Permission to access Jira, however, a favorite filters is only visible to the user where the filter is:
4760
+
4761
+ * owned by the user.
4762
+ * shared with a group that the user is a member of.
4763
+ * shared with a private project that the user has *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for.
4764
+ * shared with a public project.
4765
+ * shared with the public.
4766
+
4767
+ For example, if the user favorites a public filter that is subsequently made private that filter is not returned by this operation.</td>
4768
+ <td style="padding:15px">{base_path}/{version}/filter/my?{query}</td>
4769
+ <td style="padding:15px">Yes</td>
4770
+ </tr>
4771
+ <tr>
4772
+ <td style="padding:15px">getRestapi2filtersearch(filterName, accountId, owner, groupname, projectId, orderBy, startAt, maxResults, expand, callback)</td>
4773
+ <td style="padding:15px">Searches for filters. This operation is similar to [Get filters](#api-api-2-filter-get) except that the results can be refined to include filters that have specific attributes. For example, filters with a particular name. When multiple attributes are specified only filters matching all attributes are returned.
4774
+
4775
+ **[Permissions](#permissions) required:** Permission to access Jira, however, only the following filters that match the query parameters are returned:
4776
+
4777
+ * filters owned by the user.
4778
+ * filters shared with a group that the user is a member of.
4779
+ * filters shared with a private project that the user has *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for.
4780
+ * filters shared with a public project.
4781
+ * filters shared with the public.</td>
4782
+ <td style="padding:15px">{base_path}/{version}/filter/search?{query}</td>
4783
+ <td style="padding:15px">Yes</td>
4784
+ </tr>
4785
+ <tr>
4786
+ <td style="padding:15px">getRestapi2filterid(id, expand, callback)</td>
4787
+ <td style="padding:15px">Returns a filter.
4788
+
4789
+ **[Permissions](#permissions) required:** Permission to access Jira, however, only the following are returned:
4790
+
4791
+ * filters owned by the user.
4792
+ * filters shared with a group that the user is a member of.
4793
+ * filters shared with a private project that the user has *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for.
4794
+ * filters shared with a public project.
4795
+ * filters shared with the public.</td>
4796
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}?{query}</td>
4797
+ <td style="padding:15px">Yes</td>
4798
+ </tr>
4799
+ <tr>
4800
+ <td style="padding:15px">putRestapi2filterid(id, expand, body, callback)</td>
4801
+ <td style="padding:15px">Updates a filter. Use this operation to update a filter's name, description, JQL, or sharing.
4802
+
4803
+ **[Permissions](#permissions) required:** Permission to access Jira, however the user must own the filter.</td>
4804
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}?{query}</td>
4805
+ <td style="padding:15px">Yes</td>
4806
+ </tr>
4807
+ <tr>
4808
+ <td style="padding:15px">deleteRestapi2filterid(id, callback)</td>
4809
+ <td style="padding:15px">Delete a filter.
4810
+
4811
+ **[Permissions](#permissions) required:** Permission to access Jira, however filters can only be deleted by the creator of the filter or a user with *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
4812
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}?{query}</td>
4813
+ <td style="padding:15px">Yes</td>
4814
+ </tr>
4815
+ <tr>
4816
+ <td style="padding:15px">getRestapi2filteridcolumns(id, callback)</td>
4817
+ <td style="padding:15px">Returns the columns configured for a filter. The column configuration is used when the filter's results are viewed in *List View* with the *Columns* set to *Filter*.
4818
+
4819
+ **[Permissions](#permissions) required:** Permission to access Jira, however, only the following are returned:
4820
+
4821
+ * filters owned by the user.
4822
+ * filters shared with a group that the user is a member of.
4823
+ * filters shared with a private project that the user has *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for.
4824
+ * filters shared with a public project.
4825
+ * filters shared with the public.</td>
4826
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}/columns?{query}</td>
4827
+ <td style="padding:15px">Yes</td>
4828
+ </tr>
4829
+ <tr>
4830
+ <td style="padding:15px">putRestapi2filteridcolumns(id, body, callback)</td>
4831
+ <td style="padding:15px">Sets the columns for a filter. Only navigable fields can be set as columns. Use [Get fields](#api-api-2-field-get) to get the list fields in Jira. A navigable field has `navigable` set to `true`.
4832
+
4833
+ The parameters for this resource are expressed as HTML form data. For example, in curl:
4834
+
4835
+ `curl -X PUT -d columns=summary -d columns=description https://your-domain.atlassian.net/rest/api/2/filter/10000/columns`
4836
+
4837
+ **[Permissions](#permissions) required:** Permission to access Jira, however, columns are only set for:
4838
+
4839
+ * filters owned by the user.
4840
+ * filters shared with a group that the user is a member of.
4841
+ * filters shared with a private project that the user has *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for.
4842
+ * filters shared with a public project.
4843
+ * filters shared with the public.</td>
4844
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}/columns?{query}</td>
4845
+ <td style="padding:15px">Yes</td>
4846
+ </tr>
4847
+ <tr>
4848
+ <td style="padding:15px">deleteRestapi2filteridcolumns(id, callback)</td>
4849
+ <td style="padding:15px">Reset the user's column configuration for the filter to the default.
4850
+
4851
+ **[Permissions](#permissions) required:** Permission to access Jira, however, columns are only reset for:
4852
+
4853
+ * filters owned by the user.
4854
+ * filters shared with a group that the user is a member of.
4855
+ * filters shared with a private project that the user has *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for.
4856
+ * filters shared with a public project.
4857
+ * filters shared with the public.</td>
4858
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}/columns?{query}</td>
4859
+ <td style="padding:15px">Yes</td>
4860
+ </tr>
4861
+ <tr>
4862
+ <td style="padding:15px">putRestapi2filteridfavourite(id, expand, callback)</td>
4863
+ <td style="padding:15px">Add a filter as a favorite for the user.
4864
+
4865
+ **[Permissions](#permissions) required:** Permission to access Jira, however, the user can only favorite:
4866
+
4867
+ * filters owned by the user.
4868
+ * filters shared with a group that the user is a member of.
4869
+ * filters shared with a private project that the user has *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for.
4870
+ * filters shared with a public project.
4871
+ * filters shared with the public.</td>
4872
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}/favourite?{query}</td>
4873
+ <td style="padding:15px">Yes</td>
4874
+ </tr>
4875
+ <tr>
4876
+ <td style="padding:15px">deleteRestapi2filteridfavourite(id, expand, callback)</td>
4877
+ <td style="padding:15px">Removes a filter as a favorite for the user. Note that this operation only removes filters visible to the user from the user's favorites list. For example, if the user favorites a public filter that is subsequently made private (and is therefore no longer visible on their favorites list) they cannot remove it from their favorites list.
4878
+
4879
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4880
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}/favourite?{query}</td>
4881
+ <td style="padding:15px">Yes</td>
4882
+ </tr>
4883
+ <tr>
4884
+ <td style="padding:15px">getRestapi2filterdefaultShareScope(callback)</td>
4885
+ <td style="padding:15px">Returns the default sharing settings for new filters and dashboards for a user.
4886
+
4887
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4888
+ <td style="padding:15px">{base_path}/{version}/filter/defaultShareScope?{query}</td>
4889
+ <td style="padding:15px">Yes</td>
4890
+ </tr>
4891
+ <tr>
4892
+ <td style="padding:15px">putRestapi2filterdefaultShareScope(body, callback)</td>
4893
+ <td style="padding:15px">Sets the default sharing for new filters and dashboards for a user.
4894
+
4895
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
4896
+ <td style="padding:15px">{base_path}/{version}/filter/defaultShareScope?{query}</td>
4897
+ <td style="padding:15px">Yes</td>
4898
+ </tr>
4899
+ <tr>
4900
+ <td style="padding:15px">getRestapi2filteridpermission(id, callback)</td>
4901
+ <td style="padding:15px">Returns the share permissions for a filter. A filter can be shared with groups, projects, all logged-in users, or the public. Sharing with all logged-in users or the public is known as a global share permission.
4902
+
4903
+ **[Permissions](#permissions) required:** Permission to access Jira, however, only the following are returned:
4904
+
4905
+ * filters owned by the user.
4906
+ * filters shared with a group that the user is a member of.
4907
+ * filters shared with a private project that the user has *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for.
4908
+ * filters shared with a public project.
4909
+ * filters shared with the public.</td>
4910
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}/permission?{query}</td>
4911
+ <td style="padding:15px">Yes</td>
4912
+ </tr>
4913
+ <tr>
4914
+ <td style="padding:15px">postRestapi2filteridpermission(id, body, callback)</td>
4915
+ <td style="padding:15px">Add a share permissions to a filter. If you add a global share permission (one for all logged-in users or the public) it will overwrite all share permissions for the filter.
4916
+
4917
+ Be aware that this operation uses different objects for updating share permissions compared to [Update filter](#api-api-2-filter-id-put).
4918
+
4919
+ **[Permissions](#permissions) required:** *Share dashboards and filters* [global permission](https://confluence.atlassian.com/x/x4dKLg) and the user must own the filter.</td>
4920
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}/permission?{query}</td>
4921
+ <td style="padding:15px">Yes</td>
4922
+ </tr>
4923
+ <tr>
4924
+ <td style="padding:15px">getRestapi2filteridpermissionpermissionId(id, permissionId, callback)</td>
4925
+ <td style="padding:15px">Returns a share permission for a filter. A filter can be shared with groups, projects, all logged-in users, or the public. Sharing with all logged-in users or the public is known as a global share permission.
4926
+
4927
+ **[Permissions](#permissions) required:** Permission to access Jira, however, only the following are returned:
4928
+
4929
+ * filters owned by the user.
4930
+ * filters shared with a group that the user is a member of.
4931
+ * filters shared with a private project that the user has *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for.
4932
+ * filters shared with a public project.
4933
+ * filters shared with the public.</td>
4934
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}/permission/{pathv2}?{query}</td>
4935
+ <td style="padding:15px">Yes</td>
4936
+ </tr>
4937
+ <tr>
4938
+ <td style="padding:15px">deleteRestapi2filteridpermissionpermissionId(id, permissionId, callback)</td>
4939
+ <td style="padding:15px">Deletes a share permission from a filter.
4940
+
4941
+ **[Permissions](#permissions) required:** Permission to access Jira and the user must own the filter.</td>
4942
+ <td style="padding:15px">{base_path}/{version}/filter/{pathv1}/permission/{pathv2}?{query}</td>
4943
+ <td style="padding:15px">Yes</td>
4944
+ </tr>
4945
+ <tr>
4946
+ <td style="padding:15px">getRestapi2settingscolumns(callback)</td>
4947
+ <td style="padding:15px">Returns the default issue navigator columns.
4948
+
4949
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
4950
+ <td style="padding:15px">{base_path}/{version}/settings/columns?{query}</td>
4951
+ <td style="padding:15px">Yes</td>
4952
+ </tr>
4953
+ <tr>
4954
+ <td style="padding:15px">putRestapi2settingscolumns(body, callback)</td>
4955
+ <td style="padding:15px">Sets the default issue navigator columns.
4956
+
4957
+ The `columns` parameter accepts a navigable field value and is expressed as HTML form data. To specify multiple columns, pass multiple `columns` parameters. For example, in curl:
4958
+
4959
+ `curl -X PUT -d columns=summary -d columns=description https://your-domain.atlassian.net/rest/api/2/settings/columns`
4960
+
4961
+ If no column details are sent, then all default columns are removed.
4962
+
4963
+ A navigable field is one that can be used as a column on the issue navigator. Find details of navigable issue columns using [Get fields](#api-api-2-field-get).
4964
+
4965
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
4966
+ <td style="padding:15px">{base_path}/{version}/settings/columns?{query}</td>
4967
+ <td style="padding:15px">Yes</td>
4968
+ </tr>
4969
+ <tr>
4970
+ <td style="padding:15px">getRestapi2notificationscheme(startAt, maxResults, expand, callback)</td>
4971
+ <td style="padding:15px">Returns a [paginated](#pagination) list of [notification schemes](https://confluence.atlassian.com/x/8YdKLg) in order by display name.
4972
+
4973
+ ### About notification schemes ###
4974
+
4975
+ A notification scheme is a list of events and recipients who will receive notifications for those events. The list is contained within the `notificationSchemeEvents` object and contains pairs of `events` and `notifications`:
4976
+
4977
+ * `event` Identifies the type of event. The events can be [Jira system events](https://confluence.atlassian.com/x/8YdKLg#Creatinganotificationscheme-eventsEvents) or [custom events](https://confluence.atlassian.com/x/AIlKLg).
4978
+ * `notifications` Identifies the [recipients](https://confluence.atlassian.com/x/8YdKLg#Creatinganotificationscheme-recipientsRecipients) of notifications for each event. Recipients can be any of the following types:
4979
+
4980
+ * `CurrentAssignee`
4981
+ * `Reporter`
4982
+ * `CurrentUser`
4983
+ * `ProjectLead`
4984
+ * `ComponentLead`
4985
+ * `User` (the `parameter` is the user key)
4986
+ * `Group` (the `parameter` is the group name)
4987
+ * `ProjectRole` (the `parameter` is the project role ID)
4988
+ * `EmailAddress`
4989
+ * `AllWatchers`
4990
+ * `UserCustomField` (the `parameter` is the ID of the custom field)
4991
+ * `GroupCustomField`(the `parameter` is the ID of the custom field)
4992
+
4993
+ *Note that you should allow for events without recipients to appear in responses.*
4994
+
4995
+ **[Permissions](#permissions) required:** Permission to access Jira, however the user must have permission to administer at least one project associated with a notification scheme for it to be returned.</td>
4996
+ <td style="padding:15px">{base_path}/{version}/notificationscheme?{query}</td>
4997
+ <td style="padding:15px">Yes</td>
4998
+ </tr>
4999
+ <tr>
5000
+ <td style="padding:15px">getRestapi2notificationschemeid(id, expand, callback)</td>
5001
+ <td style="padding:15px">Returns a [notification scheme](https://confluence.atlassian.com/x/8YdKLg), including the list of events and the recipients who will receive notifications for those events.
5002
+
5003
+ **[Permissions](#permissions) required:** Permission to access Jira, however the user must have permission to administer at least one project associated with the notification scheme.</td>
5004
+ <td style="padding:15px">{base_path}/{version}/notificationscheme/{pathv1}?{query}</td>
5005
+ <td style="padding:15px">Yes</td>
5006
+ </tr>
5007
+ <tr>
5008
+ <td style="padding:15px">putRestapi2issuepropertiespropertyKey(propertyKey, body, callback)</td>
5009
+ <td style="padding:15px">Sets a property value on multiple issues. The issues to be updated can be specified by a filter.
5010
+
5011
+ The filter identifies issues eligible for update using these criteria:
5012
+
5013
+ * `entityIds` Only issues from this list are eligible.
5014
+ * `currentValue` Only issues with the property set to this value are eligible.
5015
+ * `hasProperty`:
5016
+
5017
+ * If *true*, only issues with the property are eligible.
5018
+ * If *false*, only issues without the property are eligible.
5019
+
5020
+ If more than one criteria is specified, they are joined with the logical *AND*: only issues that satisfy all criteria are eligible.
5021
+
5022
+ If an invalid combination of criteria is provided, an error is returned. For example, specifying a `currentValue` and `hasProperty` as *false* would not match any issues (because without the property the property cannot have a value).
5023
+
5024
+ The filter is optional. Without the filter all the issues visible to the user and where the user has the EDIT\_ISSUES permission for the issue are considered eligible.
5025
+
5026
+ This operation is:
5027
+
5028
+ * transactional, either all eligible issues are updated or, when errors occur, none are updated.
5029
+ * [asynchronous](#async). Follow the `location` link in the response to determine the status of the task and use [Get task](#api-api-2-task-taskId-get) to obtain subsequent updates.
5030
+
5031
+ **[Permissions](#permissions) required:**
5032
+
5033
+ * *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for each project containing issues.
5034
+ * If configured, permission to view granted by [issue-level security](https://confluence.atlassian.com/x/J4lKLg) for each issue.
5035
+ * *Edit issues* [project permission](https://confluence.atlassian.com/x/yodKLg) for each issue.</td>
5036
+ <td style="padding:15px">{base_path}/{version}/issue/properties/{pathv1}?{query}</td>
5037
+ <td style="padding:15px">Yes</td>
5038
+ </tr>
5039
+ <tr>
5040
+ <td style="padding:15px">deleteRestapi2issuepropertiespropertyKey(propertyKey, body, callback)</td>
5041
+ <td style="padding:15px">Deletes a property value from multiple issues. The issues to be updated can be specified by filter criteria.
5042
+
5043
+ The criteria the filter used to identify eligible issues are:
5044
+
5045
+ * `entityIds` Only issues from this list are eligible.
5046
+ * `currentValue` Only issues with the property set to this value are eligible.
5047
+
5048
+ If both criteria is specified, they are joined with the logical *AND*: only issues that satisfy both criteria are considered eligible.
5049
+
5050
+ If no filter criteria are specified, all the issues visible to the user and where the user has the EDIT\_ISSUES permission for the issue are considered eligible.
5051
+
5052
+ This operation is:
5053
+
5054
+ * transactional, either the property is deleted from all eligible issues or, when errors occur, no properties are deleted.
5055
+ * [asynchronous](#async). Follow the `location` link in the response to determine the status of the task and use [Get task](#api-api-2-task-taskId-get) to obtain subsequent updates.
5056
+
5057
+ **[Permissions](#permissions) required:**
5058
+
5059
+ * *Browse projects* [ project permission](https://confluence.atlassian.com/x/yodKLg) for each project containing issues.
5060
+ * If configured, permission to view granted by [issue-level security](https://confluence.atlassian.com/x/J4lKLg) for each issue.
5061
+ * *Edit issues* [project permission](https://confluence.atlassian.com/x/yodKLg) for each issue.</td>
5062
+ <td style="padding:15px">{base_path}/{version}/issue/properties/{pathv1}?{query}</td>
5063
+ <td style="padding:15px">Yes</td>
5064
+ </tr>
5065
+ <tr>
5066
+ <td style="padding:15px">getRestapi2issueissueIdOrKeyproperties(issueIdOrKey, callback)</td>
5067
+ <td style="padding:15px">Returns the URLs and keys of an issue's properties.
5068
+
5069
+ **[Permissions](#permissions) required:**
5070
+
5071
+ * *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in.
5072
+ * If configured, permission to view the issue granted by [ issue-level security](https://confluence.atlassian.com/x/J4lKLg).</td>
5073
+ <td style="padding:15px">{base_path}/{version}/issue/{pathv1}/properties?{query}</td>
5074
+ <td style="padding:15px">Yes</td>
5075
+ </tr>
5076
+ <tr>
5077
+ <td style="padding:15px">getRestapi2issueissueIdOrKeypropertiespropertyKey(issueIdOrKey, propertyKey, callback)</td>
5078
+ <td style="padding:15px">Returns the key and value of an issue's property.
5079
+
5080
+ **[Permissions](#permissions) required:**
5081
+
5082
+ * *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in.
5083
+ * If configured, permission to view the issue granted by [ issue-level security](https://confluence.atlassian.com/x/J4lKLg).</td>
5084
+ <td style="padding:15px">{base_path}/{version}/issue/{pathv1}/properties/{pathv2}?{query}</td>
5085
+ <td style="padding:15px">Yes</td>
5086
+ </tr>
5087
+ <tr>
5088
+ <td style="padding:15px">putRestapi2issueissueIdOrKeypropertiespropertyKey(issueIdOrKey, propertyKey, body, callback)</td>
5089
+ <td style="padding:15px">Sets the value of an issue's property. Use this resource to store custom data against an issue.
5090
+
5091
+ The value of the request body must be a [valid](http://tools.ietf.org/html/rfc4627), non-empty JSON blob. The maximum length is 32768 characters.
5092
+
5093
+ **[Permissions](#permissions) required:**
5094
+
5095
+ * *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in.
5096
+ * If configured, permission to view the issue granted by [ issue-level security](https://confluence.atlassian.com/x/J4lKLg).
5097
+ * *Edit issues* [project permission](https://confluence.atlassian.com/x/yodKLg) for the issue.</td>
5098
+ <td style="padding:15px">{base_path}/{version}/issue/{pathv1}/properties/{pathv2}?{query}</td>
5099
+ <td style="padding:15px">Yes</td>
5100
+ </tr>
5101
+ <tr>
5102
+ <td style="padding:15px">deleteRestapi2issueissueIdOrKeypropertiespropertyKey(issueIdOrKey, propertyKey, callback)</td>
5103
+ <td style="padding:15px">Deletes an issue's property.
5104
+
5105
+ **[Permissions](#permissions) required:**
5106
+
5107
+ * *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in.
5108
+ * If configured, permission to view the issue granted by [ issue-level security](https://confluence.atlassian.com/x/J4lKLg).
5109
+ * *Edit issues* [project permission](https://confluence.atlassian.com/x/yodKLg) for the issue.</td>
5110
+ <td style="padding:15px">{base_path}/{version}/issue/{pathv1}/properties/{pathv2}?{query}</td>
5111
+ <td style="padding:15px">Yes</td>
5112
+ </tr>
5113
+ <tr>
5114
+ <td style="padding:15px">getRestapi2search(jql, startAt, maxResults, validateQuery, fields, expand, properties, fieldsByKeys, callback)</td>
5115
+ <td style="padding:15px">Searches for issues using [JQL](https://confluence.atlassian.com/x/egORLQ).
5116
+
5117
+ If the JQL query expression is too large to be encoded as a query parameter, use the [POST](#api-api-2-search-post) version of this resource.
5118
+
5119
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
5120
+ <td style="padding:15px">{base_path}/{version}/search?{query}</td>
5121
+ <td style="padding:15px">Yes</td>
5122
+ </tr>
5123
+ <tr>
5124
+ <td style="padding:15px">postRestapi2search(body, callback)</td>
5125
+ <td style="padding:15px">Searches for issues using [JQL](https://confluence.atlassian.com/x/egORLQ).
5126
+
5127
+ There is a [GET](#api-api-2-search-get) version of this resource that can be used for smaller JQL query expressions.
5128
+
5129
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
5130
+ <td style="padding:15px">{base_path}/{version}/search?{query}</td>
5131
+ <td style="padding:15px">Yes</td>
5132
+ </tr>
5133
+ <tr>
5134
+ <td style="padding:15px">getRestapi2issuepicker(query, currentJQL, currentIssueKey, currentProjectId, showSubTasks, showSubTaskParent, callback)</td>
5135
+ <td style="padding:15px">Returns lists of issues matching a query string. Use this resource to provide auto-completion suggestions when the user is looking for an issue using a word or string.
5136
+
5137
+ This operation returns two lists:
5138
+
5139
+ * `History Search` which includes issues from the user's history of created, edited, or viewed issues that contain the string in the `query` parameter.
5140
+ * `Current Search` which includes issues that match the JQL expression in `currentJQL` and contain the string in the `query` parameter.
5141
+
5142
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
5143
+ <td style="padding:15px">{base_path}/{version}/issue/picker?{query}</td>
5144
+ <td style="padding:15px">Yes</td>
5145
+ </tr>
5146
+ <tr>
5147
+ <td style="padding:15px">postRestapi2expressioneval(expand, body, callback)</td>
5148
+ <td style="padding:15px">Evaluates a Jira expression and returns its value.
5149
+
5150
+ This resource can be used to test Jira expressions that you plan to use elsewhere, or to fetch data in a flexible way. Consult the [Jira expressions documentation](https://developer.atlassian.com/cloud/jira/platform/jira-expressions/) for more details.
5151
+
5152
+ #### Context variables ####
5153
+
5154
+ The following context variables are available to Jira expressions evaluated by this resource. Their presence depends on various factors; usually you need to manually request them in the context object sent in the payload, but some of them are added automatically under certain conditions.
5155
+
5156
+ * `user` ([User](https://developer.atlassian.com/cloud/jira/platform/jira-expressions-type-reference#user)): The current user. Always available and equal to `null` if the request is anonymous.
5157
+ * `app` ([App](https://developer.atlassian.com/cloud/jira/platform/jira-expressions-type-reference#app)): The Connect app that made the request. Available only for authenticated requests made by Connect Apps (read more here: [Authentication for Connect apps](https://developer.atlassian.com/cloud/jira/platform/authentication-for-apps/)).
5158
+ * `issue` ([Issue](https://developer.atlassian.com/cloud/jira/platform/jira-expressions-type-reference#issue)): The current issue. Available only when the issue is provided in the request context object.
5159
+ * `project` ([Project](https://developer.atlassian.com/cloud/jira/platform/jira-expressions-type-reference#project)): The current project. Available only when the project is provided in the request context object.
5160
+ * `sprint` ([Sprint](https://developer.atlassian.com/cloud/jira/platform/jira-expressions-type-reference#sprint)): The current sprint. Available only when the sprint is provided in the request context object.
5161
+ * `board` ([Board](https://developer.atlassian.com/cloud/jira/platform/jira-expressions-type-reference#board)): The current board. Available only when the board is provided in the request context object.
5162
+
5163
+ **[Permissions](#permissions) required**: Permission to access Jira. However, an expression may return different results for different users depending on their permissions. For example, different users may see different comments on the same issue.
5164
+ Permission to access Jira Software is required to access Jira Software context variables (`board` and `sprint`) or fields (for example, `issue.sprint`).</td>
5165
+ <td style="padding:15px">{base_path}/{version}/expression/eval?{query}</td>
5166
+ <td style="padding:15px">Yes</td>
5167
+ </tr>
5168
+ <tr>
5169
+ <td style="padding:15px">getRestapi2applicationProperties(key, permissionLevel, keyFilter, callback)</td>
5170
+ <td style="padding:15px">Returns all application properties or an application property.
5171
+
5172
+ If you specify a value for the `key` parameter, then an application property is returned as an object (not in an array). Otherwise, an array of all editable application properties is returned. See [Set application property](#api-api-2-application-properties-id-put) for descriptions of editable properties.
5173
+
5174
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
5175
+ <td style="padding:15px">{base_path}/{version}/application-properties?{query}</td>
5176
+ <td style="padding:15px">Yes</td>
5177
+ </tr>
5178
+ <tr>
5179
+ <td style="padding:15px">getRestapi2applicationPropertiesadvancedSettings(callback)</td>
5180
+ <td style="padding:15px">Returns the application properties that are accessible on the *Advanced Settings* page. To navigate to the *Advanced Settings* page in Jira, choose the Jira icon > **Jira settings** > **System**, **General Configuration** and then click **Advanced Settings** (in the upper right).
5181
+
5182
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
5183
+ <td style="padding:15px">{base_path}/{version}/application-properties/advanced-settings?{query}</td>
5184
+ <td style="padding:15px">Yes</td>
5185
+ </tr>
5186
+ <tr>
5187
+ <td style="padding:15px">putRestapi2applicationPropertiesid(id, body, callback)</td>
5188
+ <td style="padding:15px">Changes the value of an application property. For example, you can change the value of the `jira.clone.prefix` from its default value of *CLONE -* to *Clone -* if you prefer sentence case capitalization. Editable properties are described below along with their default values.
5189
+
5190
+ #### Advanced settings ####
5191
+
5192
+ The advanced settings below are also accessible in [Jira](https://confluence.atlassian.com/x/vYXKM).
5193
+
5194
+ <table>
5195
+ <thead>
5196
+ <tr>
5197
+ <th>Key</th>
5198
+ <th>Description</th>
5199
+ <th>Default value</th>
5200
+ </tr>
5201
+ </thead>
5202
+ <tbody>
5203
+ <tr>
5204
+ <td><code>jira.clone.prefix</code></td>
5205
+ <td>A string of text that automatically precedes the title of a cloned issue.</td>
5206
+ <td><code>CLONE -</code></td>
5207
+ </tr>
5208
+ <tr>
5209
+ <td><code>jira.date.picker.java.format</code></td>
5210
+ <td>The date format for the Java (server-side) generated dates. This must be the same as the <code>jira.date.picker.javascript.format</code> format setting.</td>
5211
+ <td><code>d/MMM/yy</code></td>
5212
+ </tr>
5213
+ <tr>
5214
+ <td><code>jira.date.picker.javascript.format</code></td>
5215
+ <td>This date format is for the JavaScript (client-side) generated dates. This must be the same as the <code>jira.date.picker.java.format</code> format setting.</td>
5216
+ <td><code>%e/%b/%y</code></td>
5217
+ </tr>
5218
+ <tr>
5219
+ <td><code>jira.date.time.picker.java.format</code></td>
5220
+ <td>The date format for the Java (server-side) generated date times. This must be the same as the <code>jira.date.time.picker.javascript.format</code> format setting.</td>
5221
+ <td><code>dd/MMM/yy h:mm a</code></td>
5222
+ </tr>
5223
+ <tr>
5224
+ <td><code>jira.date.time.picker.javascript.format</code></td>
5225
+ <td>This date format is for the JavaScript (client-side) generated date times. This must be the same as the <code>jira.date.time.picker.java.format</code> format setting.</td>
5226
+ <td><code>%e/%b/%y %I:%M %p</code></td>
5227
+ </tr>
5228
+ <tr>
5229
+ <td><code>jira.issue.actions.order</code></td>
5230
+ <td>The default order of actions (such as <em>Comments</em> or <em>Change history</em>) displayed on the issue view.</td>
5231
+ <td><code>asc</code></td>
5232
+ </tr>
5233
+ <tr>
5234
+ <td><code>jira.table.cols.subtasks</code></td>
5235
+ <td>The columns to show while viewing subtask issues in a table. For example, a list of subtasks on an issue.</td>
5236
+ <td><code>issuetype, status, assignee, progress</code></td>
5237
+ </tr>
5238
+ <tr>
5239
+ <td><code>jira.view.issue.links.sort.order</code></td>
5240
+ <td>The sort order of the list of issue links on the issue view.</td>
5241
+ <td><code>type, status, priority</code></td>
5242
+ </tr>
5243
+ <tr>
5244
+ <td><code>jira.comment.collapsing.minimum.hidden</code></td>
5245
+ <td>The minimum number of comments required for comment collapsing to occur. A value of <code>0</code> disables comment collapsing.</td>
5246
+ <td><code>4</code></td>
5247
+ </tr>
5248
+ <tr>
5249
+ <td><code>jira.newsletter.tip.delay.days</code></td>
5250
+ <td>The number of days before a prompt to sign up to the Jira Insiders newsletter is shown. A value of <code>-1</code> disables this functionality.</td>
5251
+ <td><code>7</code></td>
5252
+ </tr>
5253
+ </tbody>
5254
+ </table>
5255
+
5256
+ #### Look and feel ####
5257
+
5258
+ The settings listed below adjust the [look and feel](https://confluence.atlassian.com/x/VwCLLg).
5259
+
5260
+ <table>
5261
+ <thead>
5262
+ <tr>
5263
+ <th>Key</th>
5264
+ <th>Description</th>
5265
+ <th>Default value</th>
5266
+ </tr>
5267
+ </thead>
5268
+ <tbody>
5269
+ <tr>
5270
+ <td><code>jira.lf.date.time</code></td>
5271
+ <td>Look and feel of the <a href="https://docs.oracle.com/javase/6/docs/api/index.html?java/text/SimpleDateFormat.html" rel="nofollow">time format</a>.</td>
5272
+ <td><code>h:mm a</code></td>
5273
+ </tr>
5274
+ <tr>
5275
+ <td><code>jira.lf.date.day</code></td>
5276
+ <td>Look and feel of the <a href="https://docs.oracle.com/javase/6/docs/api/index.html?java/text/SimpleDateFormat.html" rel="nofollow">day format</a>.</td>
5277
+ <td><code>EEEE h:mm a</code></td>
5278
+ </tr>
5279
+ <tr>
5280
+ <td><code>jira.lf.date.complete</code></td>
5281
+ <td>Look and feel of the <a href="https://docs.oracle.com/javase/6/docs/api/index.html?java/text/SimpleDateFormat.html" rel="nofollow">date and time format</a>.</td>
5282
+ <td><code>dd/MMM/yy h:mm a</code></td>
5283
+ </tr>
5284
+ <tr>
5285
+ <td><code>jira.lf.date.dmy</code></td>
5286
+ <td>Look and feel of the <a href="https://docs.oracle.com/javase/6/docs/api/index.html?java/text/SimpleDateFormat.html" rel="nofollow">date format</a>.</td>
5287
+ <td><code>dd/MMM/yy</code></td>
5288
+ </tr>
5289
+ <tr>
5290
+ <td><code>jira.date.time.picker.use.iso8061</code></td>
5291
+ <td>When enabled, sets Monday as the first day of the week in the date picker, as specified by the ISO8601 standard.</td>
5292
+ <td><code>false</code></td>
5293
+ </tr>
5294
+ <tr>
5295
+ <td><code>jira.lf.logo.url</code></td>
5296
+ <td>The URL of the logo image file.</td>
5297
+ <td><code>/images/icon-jira-logo.png</code></td>
5298
+ </tr>
5299
+ <tr>
5300
+ <td><code>jira.lf.logo.show.application.title</code></td>
5301
+ <td>Controls the visibility of the application title on the sidebar.</td>
5302
+ <td><code>false</code></td>
5303
+ </tr>
5304
+ <tr>
5305
+ <td><code>jira.lf.favicon.url</code></td>
5306
+ <td>The URL of the favicon.</td>
5307
+ <td><code>/favicon.ico</code></td>
5308
+ </tr>
5309
+ <tr>
5310
+ <td><code>jira.lf.favicon.hires.url</code></td>
5311
+ <td>The URL of the high resolution favicon.</td>
5312
+ <td><code>/images/64jira.png</code></td>
5313
+ </tr>
5314
+ <tr>
5315
+ <td><code>jira.lf.top.adg3.bgcolour</code></td>
5316
+ <td>The background color of the sidebar.</td>
5317
+ <td><code>#0747A6</code></td>
5318
+ </tr>
5319
+ <tr>
5320
+ <td><code>jira.lf.top.adg3.textcolour</code></td>
5321
+ <td>The color of the text and logo of the sidebar.</td>
5322
+ <td><code>#DEEBFF</code></td>
5323
+ </tr>
5324
+ <tr>
5325
+ <td><code>jira.lf.hero.button.base.bg.colour</code></td>
5326
+ <td></td>
5327
+ <td><code>#3b7fc4</code></td>
5328
+ </tr>
5329
+ <tr>
5330
+ <td><code>jira.title</code></td>
5331
+ <td>The text for the application title. The application title can also be set in <em>General settings</em>.</td>
5332
+ <td><code>Jira</code></td>
5333
+ </tr>
5334
+ <tr>
5335
+ <td><code>jira.option.globalsharing</code></td>
5336
+ <td>boolean</td>
5337
+ <td><code>true</code></td>
5338
+ </tr>
5339
+ <tr>
5340
+ <td><code>xflow.product.suggestions.enabled</code></td>
5341
+ <td>Indicates whether to expose product suggestions for other Atlassian products within Jira.</td>
5342
+ <td><code>true</code></td>
5343
+ </tr>
5344
+ </tbody>
5345
+ </table>
5346
+
5347
+ #### Other settings ####
5348
+
5349
+ <table>
5350
+ <thead>
5351
+ <tr>
5352
+ <th>Key</th>
5353
+ <th>Description</th>
5354
+ <th>Default value</th>
5355
+ </tr>
5356
+ </thead>
5357
+ <tbody>
5358
+ <tr>
5359
+ <td><code>jira.issuenav.criteria.autoupdate</code></td>
5360
+ <td>Supports instant updates to search criteria.</td>
5361
+ <td><code>true</code></td>
5362
+ </tr>
5363
+ </tbody>
5364
+ </table>
5365
+
5366
+ *Note: Be careful when changing [application properties and advanced settings](https://confluence.atlassian.com/x/vYXKM).*
5367
+
5368
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
5369
+ <td style="padding:15px">{base_path}/{version}/application-properties/{pathv1}?{query}</td>
5370
+ <td style="padding:15px">Yes</td>
5371
+ </tr>
5372
+ <tr>
5373
+ <td style="padding:15px">getRestapi2configuration(callback)</td>
5374
+ <td style="padding:15px">Returns the [global settings](https://confluence.atlassian.com/x/qYXKM) in Jira. These settings determine whether optional features (for example, subtasks, time tracking, and others) are enabled. If time tracking is enabled, this operation also returns the time tracking configuration.
5375
+
5376
+ **[Permissions](#permissions) required:** Permission to access Jira .</td>
5377
+ <td style="padding:15px">{base_path}/{version}/configuration?{query}</td>
5378
+ <td style="padding:15px">Yes</td>
5379
+ </tr>
5380
+ <tr>
5381
+ <td style="padding:15px">getRestapi2jqlautocompletedata(callback)</td>
5382
+ <td style="padding:15px">Returns reference data for JQL searches. This is a downloadable version of the documentation provided in [Advanced searching - fields reference](https://confluence.atlassian.com/x/gwORLQ) and [Advanced searching - functions reference](https://confluence.atlassian.com/x/hgORLQ), along with a list of JQL-reserved words. Use this information to assist with the programmatic creation of JQL queries or the validation of queries built in a custom query builder.
5383
+
5384
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
5385
+ <td style="padding:15px">{base_path}/{version}/jql/autocompletedata?{query}</td>
5386
+ <td style="padding:15px">Yes</td>
5387
+ </tr>
5388
+ <tr>
5389
+ <td style="padding:15px">getRestapi2jqlautocompletedatasuggestions(fieldName, fieldValue, predicateName, predicateValue, callback)</td>
5390
+ <td style="padding:15px">Returns the JQL search auto complete suggestions for a field.
5391
+
5392
+ Suggestions can be obtained by providing:
5393
+
5394
+ * `fieldName` to get a list of all values for the field.
5395
+ * `fieldName` and `fieldValue` to get a list of values containing the text in `fieldValue`.
5396
+ * `fieldName` and `predicateName` to get a list of all predicate values for the field.
5397
+ * `fieldName`, `predicateName`, and `predicateValue` to get a list of predicate values containing the text in `predicateValue`.
5398
+
5399
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
5400
+ <td style="padding:15px">{base_path}/{version}/jql/autocompletedata/suggestions?{query}</td>
5401
+ <td style="padding:15px">Yes</td>
5402
+ </tr>
5403
+ <tr>
5404
+ <td style="padding:15px">postRestapi2jqlpdcleaner(body, callback)</td>
5405
+ <td style="padding:15px">Converts one or more JQL queries with user identifiers (username or user key) to equivalent JQL queries with account IDs.
5406
+
5407
+ You may wish to use this operation if your system stores JQL queries and you want to make them GDPR-compliant. For more information about GDPR-related changes, see the [migration guide](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/).
5408
+
5409
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
5410
+ <td style="padding:15px">{base_path}/{version}/jql/pdcleaner?{query}</td>
5411
+ <td style="padding:15px">Yes</td>
5412
+ </tr>
5413
+ <tr>
5414
+ <td style="padding:15px">getRestapi2mypreferences(key, callback)</td>
5415
+ <td style="padding:15px">Returns the value of a preference of the current user.
5416
+
5417
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
5418
+ <td style="padding:15px">{base_path}/{version}/mypreferences?{query}</td>
5419
+ <td style="padding:15px">Yes</td>
5420
+ </tr>
5421
+ <tr>
5422
+ <td style="padding:15px">putRestapi2mypreferences(key, body, callback)</td>
5423
+ <td style="padding:15px">Creates a preference for the user or updates a preference's value by sending a plain text string. For example, `false`. An arbitrary preference can be created with the value containing up to 255 characters. In addition, the following keys define system preferences that can be set or created:
5424
+
5425
+ * *user.notifications.mimetype* The mime type used in notifications sent to the user. Defaults to `html`.
5426
+ * *user.notify.own.changes* Indicates whether the user gets notified of their own changes. Defaults to `false`.
5427
+ * *jira.user.locale* The locale of the user. By default, not set: the user takes the instance locale. See also, [Set locale](#api-api-2-mypreferences-locale-put).
5428
+ * *jira.user.timezone* The time zone of the user. By default, not set, the user takes the instance time zone.
5429
+ * *user.default.share.private* Indicates whether new [ filters](https://confluence.atlassian.com/x/eQiiLQ) are set to private. Defaults to `true`.
5430
+ * *user.keyboard.shortcuts.disabled* Indicates whether keyboard shortcuts are disabled. Defaults to `false`.
5431
+ * *user.autowatch.disabled* Indicates whether the user automatically watches issues they create or add a comment to. By default, not set: the user takes the instance autowatch setting.
5432
+
5433
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
5434
+ <td style="padding:15px">{base_path}/{version}/mypreferences?{query}</td>
5435
+ <td style="padding:15px">Yes</td>
5436
+ </tr>
5437
+ <tr>
5438
+ <td style="padding:15px">deleteRestapi2mypreferences(key, callback)</td>
5439
+ <td style="padding:15px">Deletes a preference of the user, which restores the default value of system defined settings.
5440
+
5441
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
5442
+ <td style="padding:15px">{base_path}/{version}/mypreferences?{query}</td>
5443
+ <td style="padding:15px">Yes</td>
5444
+ </tr>
5445
+ <tr>
5446
+ <td style="padding:15px">getRestapi2mypreferenceslocale(callback)</td>
5447
+ <td style="padding:15px">Returns the locale for the user.
5448
+
5449
+ If the user has no language preference set (which is the default setting) or this resource is accessed anonymous, the browser locale detected by Jira is returned. Jira detects the browser locale using the *Accept-Language* header in the request. However, if this doesn't match a locale available Jira, the site default locale is returned.
5450
+
5451
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
5452
+ <td style="padding:15px">{base_path}/{version}/mypreferences/locale?{query}</td>
5453
+ <td style="padding:15px">Yes</td>
5454
+ </tr>
5455
+ <tr>
5456
+ <td style="padding:15px">putRestapi2mypreferenceslocale(body, callback)</td>
5457
+ <td style="padding:15px">Sets the locale of the user. The locale must be one supported by the instance of Jira.
5458
+
5459
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
5460
+ <td style="padding:15px">{base_path}/{version}/mypreferences/locale?{query}</td>
5461
+ <td style="padding:15px">Yes</td>
5462
+ </tr>
5463
+ <tr>
5464
+ <td style="padding:15px">deleteRestapi2mypreferenceslocale(callback)</td>
5465
+ <td style="padding:15px">Deletes the locale of the user, which restores the default setting.
5466
+
5467
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
5468
+ <td style="padding:15px">{base_path}/{version}/mypreferences/locale?{query}</td>
5469
+ <td style="padding:15px">Yes</td>
5470
+ </tr>
5471
+ <tr>
5472
+ <td style="padding:15px">getRestapi2myself(expand, callback)</td>
5473
+ <td style="padding:15px">Returns details for the current user.
5474
+
5475
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
5476
+ <td style="padding:15px">{base_path}/{version}/myself?{query}</td>
5477
+ <td style="padding:15px">Yes</td>
5478
+ </tr>
5479
+ <tr>
5480
+ <td style="padding:15px">getRestapi2mypermissions(projectKey, projectId, issueKey, issueId, permissions, callback)</td>
5481
+ <td style="padding:15px">Returns a list of permissions indicating which permissions the user has. Details of the user's permissions can be obtained in a global, project, or issue context.
5482
+
5483
+ The user is reported as having a project permission:
5484
+
5485
+ * in the global context, if the user has the project permission in any project.
5486
+ * for a project, where the project permission is determined using issue data, if the user meets the permission's criteria for any issue in the project. Otherwise, if the user has the project permission in the project.
5487
+ * for an issue, where a project permission is determined using issue data, if the user has the permission in the issue. Otherwise, if the user has the project permission in the project containing the issue.
5488
+
5489
+ This means that users may be shown as having an issue permission (such as EDIT\_ISSUE) in the global context or a project context but may not have the permission for any or all issues. For example, if Reporters have the EDIT\_ISSUE permission a user would be shown as having this permission in the global context or the context of a project, because any user can be a reporter. However, if they are not the user who reported the issue queried they would not have EDIT\_ISSUE permission for that issue.
5490
+
5491
+ Global permissions are unaffected by context.
5492
+
5493
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
5494
+ <td style="padding:15px">{base_path}/{version}/mypermissions?{query}</td>
5495
+ <td style="padding:15px">Yes</td>
5496
+ </tr>
5497
+ <tr>
5498
+ <td style="padding:15px">getRestapi2permissions(callback)</td>
5499
+ <td style="padding:15px">Returns all permissions, including:
5500
+
5501
+ * global permissions.
5502
+ * project permissions.
5503
+ * global permissions added by plugins.
5504
+
5505
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
5506
+ <td style="padding:15px">{base_path}/{version}/permissions?{query}</td>
5507
+ <td style="padding:15px">Yes</td>
5508
+ </tr>
5509
+ <tr>
5510
+ <td style="padding:15px">postRestapi2permissionscheck(body, callback)</td>
5511
+ <td style="padding:15px">Returns:
5512
+
5513
+ * for a list of global permissions, the global permissions granted to the user.
5514
+ * for a list of project permissions and lists of projects and issues, for each project permission a list of the projects and issues the user can access or manipulate.
5515
+
5516
+ Note that:
5517
+
5518
+ * Invalid project and issue IDs are ignored.
5519
+ * A maximum of 1000 projects and 1000 issues can be checked.
5520
+
5521
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
5522
+ <td style="padding:15px">{base_path}/{version}/permissions/check?{query}</td>
5523
+ <td style="padding:15px">Yes</td>
5524
+ </tr>
5525
+ <tr>
5526
+ <td style="padding:15px">postRestapi2permissionsproject(body, callback)</td>
5527
+ <td style="padding:15px">Returns all the projects where the user is granted a list of project permissions.
5528
+
5529
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
5530
+ <td style="padding:15px">{base_path}/{version}/permissions/project?{query}</td>
5531
+ <td style="padding:15px">Yes</td>
5532
+ </tr>
5533
+ <tr>
5534
+ <td style="padding:15px">getRestapi2permissionscheme(expand, callback)</td>
5535
+ <td style="padding:15px">Returns all permission schemes.
5536
+
5537
+ ### About permission schemes and grants ###
5538
+
5539
+ A permission scheme is a collection of permission grants. A permission grant consists of a `holder` and a `permission`.
5540
+
5541
+ #### Holder ####
5542
+
5543
+ The `holder` object contains information about the user or group being granted the permission. For example, the *Administer projects* permission is granted to a group named *Teams in space administrators*. In this case, the type is `"type": "group"`, and the parameter is the group name, `"parameter": "Teams in space administrators"`. The `holder` object is defined by the following properties:
5544
+
5545
+ * `type` Identifies the user or group (see the list of types below).
5546
+ * `parameter` The value of this property depends on the `type`. For example, if the `type` is a group, then you need to specify the group name.
5547
+
5548
+ The following `types` are available. The expected values for the `parameter` are given in parenthesis (some `types` may not have a `parameter`):
5549
+
5550
+ * `anyone` Grant for anonymous users.
5551
+ * `applicationRole` Grant for users with access to the specified application (application name). See [Manage application access](https://confluence.atlassian.com/cloud/manage-application-access-744721629.html) for more information.
5552
+ * `assignee` Grant for the user currently assigned to an issue.
5553
+ * `group` Grant for the specified group (group name).
5554
+ * `groupCustomField` Grant for a user in the group selected in the specified custom field (custom field ID).
5555
+ * `projectLead` Grant for a project lead.
5556
+ * `projectRole` Grant for the specified project role (project role ID).
5557
+ * `reporter` Grant for the user who reported the issue.
5558
+ * `sd.customer.portal.only` Jira Service Desk only. Grants customers permission to access the customer portal but not Jira. See [Customizing Jira Service Desk permissions](https://confluence.atlassian.com/x/24dKLg) for more information.
5559
+ * `user` Grant for the specified user (user ID - historically this was the userkey but that is deprecated and the account ID should be used).
5560
+ * `userCustomField` Grant for a user selected in the specified custom field (custom field ID).
5561
+
5562
+ #### Permissions ####
5563
+
5564
+ The [built-in Jira permissions](https://confluence.atlassian.com/x/yodKLg) are listed below. Apps can also define custom permissions. See the [project permission](https://developer.atlassian.com/cloud/jira/platform/modules/project-permission/) and [global permission](https://developer.atlassian.com/cloud/jira/platform/modules/global-permission/) module documentation for more information.
5565
+
5566
+ **Project permissions**
5567
+
5568
+ * `ADMINISTER_PROJECTS`
5569
+ * `BROWSE_PROJECTS`
5570
+ * `MANAGE_SPRINTS_PERMISSION` (Jira Software only)
5571
+ * `SERVICEDESK_AGENT` (Jira Service Desk only)
5572
+ * `VIEW_DEV_TOOLS` (Jira Software only)
5573
+ * `VIEW_READONLY_WORKFLOW`
5574
+
5575
+ **Issue permissions**
5576
+
5577
+ * `ASSIGNABLE_USER`
5578
+ * `ASSIGN_ISSUES`
5579
+ * `CLOSE_ISSUES`
5580
+ * `CREATE_ISSUES`
5581
+ * `DELETE_ISSUES`
5582
+ * `EDIT_ISSUES`
5583
+ * `LINK_ISSUES`
5584
+ * `MODIFY_REPORTER`
5585
+ * `MOVE_ISSUES`
5586
+ * `RESOLVE_ISSUES`
5587
+ * `SCHEDULE_ISSUES`
5588
+ * `SET_ISSUE_SECURITY`
5589
+ * `TRANSITION_ISSUES`
5590
+
5591
+ **Voters and watchers permissions**
5592
+
5593
+ * `MANAGE_WATCHERS`
5594
+ * `VIEW_VOTERS_AND_WATCHERS`
5595
+
5596
+ **Comments permissions**
5597
+
5598
+ * `ADD_COMMENTS`
5599
+ * `DELETE_ALL_COMMENTS`
5600
+ * `DELETE_OWN_COMMENTS`
5601
+ * `EDIT_ALL_COMMENTS`
5602
+ * `EDIT_OWN_COMMENTS`
5603
+
5604
+ **Attachments permissions**
5605
+
5606
+ * `CREATE_ATTACHMENTS`
5607
+ * `DELETE_ALL_ATTACHMENTS`
5608
+ * `DELETE_OWN_ATTACHMENTS`
5609
+
5610
+ **Time tracking permissions**
5611
+
5612
+ * `DELETE_ALL_WORKLOGS`
5613
+ * `DELETE_OWN_WORKLOGS`
5614
+ * `EDIT_ALL_WORKLOGS`
5615
+ * `EDIT_OWN_WORKLOGS`
5616
+ * `WORK_ON_ISSUES`
5617
+
5618
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
5619
+ <td style="padding:15px">{base_path}/{version}/permissionscheme?{query}</td>
5620
+ <td style="padding:15px">Yes</td>
5621
+ </tr>
5622
+ <tr>
5623
+ <td style="padding:15px">postRestapi2permissionscheme(expand, body, callback)</td>
5624
+ <td style="padding:15px">Creates a new permission scheme. You can create a permission scheme with or without defining a set of permission grants.
5625
+
5626
+ **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
5627
+ <td style="padding:15px">{base_path}/{version}/permissionscheme?{query}</td>
5628
+ <td style="padding:15px">Yes</td>
5629
+ </tr>
5630
+ <tr>
5631
+ <td style="padding:15px">getRestapi2permissionschemeschemeId(schemeId, expand, callback)</td>
5632
+ <td style="padding:15px">Returns a permission scheme.
5633
+
5634
+ **[Permissions](#permissions) required:** Permission to access Jira.</td>
5635
+ <td style="padding:15px">{base_path}/{version}/permissionscheme/{pathv1}?{query}</td>
5636
+ <td style="padding:15px">Yes</td>
5637
+ </tr>
5638
+ <tr>
5639
+ <td style="padding:15px">putRestapi2permissionschemeschemeId(schemeId, expand, body, callback)</td>
5640
+ <td style="padding:15px">Updates a permission scheme. Below are some important things to note when using this resource:
5641
+
5642
+ * If a permissions list is present in the request, then it is set in the permission scheme, overwriting *all existing* grants.
5643
+ * If you want to update only the name and description, then do not send a permissions list in the request.
5644
+ * Sending an empty list will remove all permission grants from the permission scheme.
5645
+
5646
+ If you want to add or delete a permission grant instead of updating the whole list, see [Create permission grant](#api-api-2-permissionscheme-schemeId-permission-post) or [Delete permission scheme entity](#api-api-2-permissionscheme-schemeId-permission-permissionId-delete).
5647
+
5648
+ See [About permission schemes and grants](#about-permission-schemes) for more details.
5649
+
3428
5650
  **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).</td>
3429
5651
  <td style="padding:15px">{base_path}/{version}/permissionscheme/{pathv1}?{query}</td>
3430
5652
  <td style="padding:15px">Yes</td>