Documentation

JIRA REST Scopes

For more information about the JIRA REST APIs, please consult the documentation on developer.atlassian.com and check out the Product API Browser

The required scope for your add-on depends on how you interact with the resources that are exposed by the REST API. The table below shows the required scope for GET, POST, PUT and DELETE operations on a resource path. REST resources are versioned by a path segment that varies with the version. The supported versions are listed below the path.

Example

PathGETPOSTPUTDELETE
/rest/atlassian-connect/{version}/license

1latest

READN/AN/AN/A

The example above means that a GET operation on
  • /rest/atlassian-connect/1/license
  • /rest/atlassian-connect/latest/license

will require your add-on to declare the READ scope. The example also shows that this specific resource only supports GET, but no other HTTP verbs.

Resources and their Associated Scopes

PathGETPOSTPUTDELETE
/rest/api/{version}/attachment

22.0.alpha1latest

READWRITEWRITEDELETE
/rest/api/{version}/comment

22.0.alpha1latest

READWRITEWRITEDELETE
/rest/api/{version}/component

22.0.alpha1latest

READWRITEWRITEDELETE
/rest/api/{version}/customFieldOption

22.0.alpha1latest

READWRITEWRITEDELETE
/rest/api/{version}/field

22.0.alpha1latest

ADMINADMINADMINADMIN
/rest/api/{version}/filter

22.0.alpha1latest

READN/AN/AN/A
/rest/api/{version}/group

22.0.alpha1latest

READN/AN/AN/A
/rest/api/{version}/groups/picker

22.0.alpha1latest

READN/AN/AN/A
/rest/api/{version}/issue

22.0.alpha1latest

READWRITEWRITEDELETE
/rest/api/{version}/issue/.+/worklog

22.0.alpha1latest

READWRITEWRITEDELETE
/rest/api/{version}/issueLinkType

22.0.alpha1latest

READADMINADMINADMIN
/rest/api/{version}/issuetype

22.0.alpha1latest

READN/AN/AN/A
/rest/api/{version}/mypermissions

22.0.alpha1latest

READN/AN/AN/A
/rest/api/{version}/myself

2latest

READN/AN/AN/A
/rest/api/{version}/priority

22.0.alpha1latest

READWRITEWRITEDELETE
/rest/api/{version}/project

22.0.alpha1latest

READN/AN/AN/A
/rest/api/{version}/resolution

22.0.alpha1latest

READN/AN/AN/A
/rest/api/{version}/search

22.0.alpha1latest

READWRITEWRITEN/A
/rest/api/{version}/serverInfo

22.0.alpha1latest

READN/AN/AN/A
/rest/api/{version}/status

22.0.alpha1latest

READN/AN/AN/A
/rest/api/{version}/statuscategory

22.0.alpha1latest

READN/AN/AN/A
/rest/api/{version}/user

22.0.alpha1latest

READN/AN/AN/A
/rest/api/{version}/version

22.0.alpha1latest

READWRITEWRITEDELETE
/rest/api/{version}/workflow

2latest

READN/AN/AN/A
/rest/api/{version}/workflowscheme

2latest

ADMINADMINADMINADMIN
/rest/applinks/{version}/applicationlink

1.02.0latest

ADMINADMINADMINADMIN
/rest/applinks/{version}/applicationlinkInfo

1.02.0latest

ADMINADMINADMINADMIN
/rest/applinks/{version}/entities

1.02.0latest

READN/AN/AN/A
/rest/applinks/{version}/entitylink

1.02.0latest

ADMINADMINADMINADMIN
/rest/applinks/{version}/entitylink/primary

1.02.0latest

ADMINADMINADMINADMIN
/rest/applinks/{version}/listApplicationLinks

1.02.0latest

ADMINADMINADMINADMIN
/rest/applinks/{version}/manifest

1.02.0latest

ADMINADMINADMINADMIN
/rest/applinks/{version}/type/entity

1.02.0latest

ADMINADMINADMINADMIN
/rest/atlassian-connect/{version}/license

1latest

READN/AN/AN/A
/rest/remoteplugintest/{version}/user

1latest

READN/AN/AN/A
/secure/attachment

READN/AN/AN/A